Source: https://aiprimetech.io/pt/docs/guides/troubleshooting/

[Início](/pt/) / [Documentação](/pt/docs/) / Solução de problemas 

# Solução de problemas 

Índice por sintoma — encontre o que está observando e vá direto à causa. 

 Copiar página [ Ver como Markdown](/pt/docs/guides/troubleshooting.md) [ Perguntar ao ChatGPT](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/guides/troubleshooting.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) [ Perguntar no Claude](https://claude.ai/new?q=Read%20https%3A//aiprimetech.io/docs/guides/troubleshooting.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.)   

## 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](/pt/docs/getting-started/models/) ou a [lista de verificação de configuração do agente](/pt/agents/) se não tiver certeza de qual etapa falhou. 

## Nada funciona 

Estabeleça uma base de referência antes de depurar qualquer outra coisa: 

```
Copycurl -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](/pt/docs/getting-started/base-urls/)

 | 401 com uma chave que você acabou de criar | Cabeçalho incorreto para o formato ou um espaço no final | [Autenticação](/pt/docs/getting-started/authentication/)

 | 402 | Sem créditos ou plano expirado | [Adicionar créditos](/pt/topup/) · [Planos](/pt/plans/)

 | 400 max_tokens | Messages exige max_tokens; Chat Completions não exige | [Messages](/pt/docs/api-reference/messages/)

 | model_not_found | ID incorreto, grupo de chaves incorreto ou modelo indisponível para essa chave | [Modelos e grupos de chaves](/pt/docs/getting-started/models/)

 | O streaming conecta, mas não retorna nada | Interpretação da estrutura de eventos do outro formato | [Transmissão](/pt/docs/api-reference/streaming/)

 | 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](/pt/docs/getting-started/base-urls/)

 | 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](/pt/docs/guides/claude-code/)

 | Frequente 429 | Paralelismo do agente muito alto | [Limites de requisições](/pt/docs/api-reference/rate-limits/)

 | Cobrança maior que o esperado | Crescimento do contexto ao longo dos turnos | [Gerenciamento de contexto](/pt/docs/guides/context-management/) 

## 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](mailto: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. 

[ErrosReferência de códigos de status](/pt/docs/api-reference/errors/)[URLs baseA falha mais comum](/pt/docs/getting-started/base-urls/)[Configuração da chave de APIConfigurações por ferramenta](/pt/docs/guides/api-key-configuration/) 

[AnteriorBoas práticas para produção](/pt/docs/guides/best-practices/)[PróximoVisão geral dos SDKs](/pt/docs/sdks/)