Contrato de erros#
Erros usam { error: { message, type, code } }. Nunca repita indefinidamente.
| HTTP | Código | O que fazer |
|---|---|---|
| 400 | invalid_request | Corrija JSON, campos obrigatórios ou limites de tokens. |
| 401 | invalid_api_key | Verifique a chave e o cabeçalho Bearer; gire se revogada. |
| 402 | insufficient_balance | Verifique a recarga qualificada confirmada, o crédito disponível e o orçamento da chave; cada nova recarga deve ser de pelo menos USD 100. |
| 403 | model_not_allowed | Atualize a lista de permissões da chave ou escolha um modelo permitido. |
| 404 | model_not_found | Obtenha /v1/models e use um ID exato. |
| 409 | pending_reconciliation | Aguarde a reconciliação de uso antes de repetir a operação. |
| 413 | request_too_large | Divida a entrada ou use um contexto maior. |
| 422 | unsupported_feature | Escolha uma implantação que suporte o recurso. |
| 429 | quota_exceeded | Respeite o Retry-After se fornecido e use repetições limitadas; nenhuma cota gratuita pública é oferecida. |
| 502 | upstream_error | Repita com espera limitada; verifique o status. |
| 503 | service_unavailable | Verifique o status do serviço e a disponibilidade do modelo antes de repetir. |
Evite trabalho duplicado#
Não presuma que uma solicitação de inferência foi gratuita porque a conexão caiu. Verifique seus registros de uso. Depósitos são independentemente idempotentes pela identidade da transação do provedor.
Obtenha ajuda#
Use o guia de suporte para diagnosticar a etapa com falha e preparar um relatório com o código de erro, horário UTC, modelo e uma reprodução sintética. A ferramenta de relatório local não envia um ticket. Mantenha credenciais e conteúdo do cliente fora do relatório.
Exemplo de solicitação
curl https://weightsapi.com/v1/chat/completions \
-H "Authorization: Bearer $WEIGHTSAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Qwen/Qwen3-32B",
"messages": [
{
"role": "user",
"content": "Hello!"
}
],
"stream": true
}'