Solução de problemas
Índice por sintoma — encontre o que está observando e vá direto à causa.
Verifique o acesso antes de tentar novamente
- Verifique se a permissão de acesso pretendida está ativa e anote sua data de expiração.
- Confirme que a chave usa o grupo pretendido. Os planos Claude com prazo definido usam Claude Unlimited; o acesso ao Codex é separado.
- Liste os modelos com essa mesma chave, selecione um ID retornado e envie uma requisição pequena.
Use Modelos e grupos de chaves ou a lista de verificação de configuração do agente se não tiver certeza de qual etapa falhou.
Nada funciona
Estabeleça uma base de referência antes de depurar qualquer outra coisa:
curl -s -o /dev/null -w "%{http_code}\n" https://aiprimetech.io/v1/models \
-H "Authorization: Bearer $CLAUDEAPIKEY"Após uma resposta bem-sucedida à listagem de modelos, confira se o modelo selecionado consta na lista e envie uma requisição pequena de geração. A geração ainda pode falhar devido à disponibilidade do modelo, à permissão de acesso, aos limites ou à configuração do cliente.
Por sintoma
| Sintoma | Causa provável | Correção |
|---|---|---|
404 em todas as chamadas | A URL base tem um tratamento incorreto de /v1 tratamento | URLs base |
401 com uma chave que você acabou de criar | Cabeçalho incorreto para o formato ou um espaço no final | Autenticação |
402 | Sem créditos ou plano expirado | Adicionar créditos · Planos |
400 max_tokens | Messages exige max_tokens; Chat Completions não exige | Messages |
model_not_found | ID incorreto, grupo de chaves incorreto ou modelo indisponível para essa chave | Modelos e grupos de chaves |
| O streaming conecta, mas não retorna nada | Interpretação da estrutura de eventos do outro formato | Transmissão |
| Resposta interrompida no meio da frase | stop_reason: max_tokens | Aumente max_tokens |
| Funciona no curl, mas falha no SDK | O SDK acrescenta seu próprio caminho à sua URL base | URLs base |
| O uso não aparece no painel | Requisições enviadas para outra chave ou outro endpoint | Verifique ANTHROPIC_API_KEY não está definido — Claude Code |
Frequente 429 | Paralelismo do agente muito alto | Limites de requisições |
| Cobrança maior que o esperado | Crescimento do contexto ao longo dos turnos | Gerenciamento de contexto |
Como ler o corpo do erro
O código de status indica a categoria do problema; os error.type e error.message campos indicam qual é o problema. Registre o corpo inteiro no log — um 400 por "missing max_tokens" e um campo 400 por "invalid role" precisam de correções completamente diferentes.
Ainda com dificuldades
Entre em contato com support@aiprimetech.io com o endpoint, o ID do modelo, o código de status e o corpo do erro. Nunca inclua sua chave de API — se você já a colou em algum lugar, revogue-a primeiro.