Erros e soluções
Todo erro da API traz um código estável no corpo da resposta. Ache o seu na tabela — em quase todos os casos é chave, IP ou plano.
{"error": "ip_not_allowed", "message": "IP not in whitelist"}Tabela de erros
| HTTP | Código | Significado | Correção |
|---|---|---|---|
| 401 | missing_api_key | a requisição chegou sem chave | exporte ANTHROPIC_API_KEY no terminal em uso |
| 401 | invalid_api_key | chave inexistente ou revogada | confira se está usando a chave atual; se revogou, crie outra e atualize a variável |
| 403 | ip_not_allowed | seu IP não é o autorizado da chave | atualize a whitelist no dashboard (Chaves e IP) |
| 403 | inactive_plan | conta sem plano ativo — nunca ativado, ou vencido | ative ou renove em Conta; volta na hora |
| 403 | tier_not_allowed | o modelo pedido não está no seu plano | troque com /model, ou faça upgrade para Max (é o caso do Fable 5 no Core) |
| 429 | rate_limit_exceeded | limite atingido: vazão por minuto, ou franquia diária/mensal no Core | aguarde o tempo indicado no header Retry-After; se for recorrente no Core, considere o Max |
| 5xx | — | problema do nosso lado ou da infraestrutura | confira status.infinitemodel.app; se persistir, fale com o suporte |
Diagnóstico em trinta segundos
Rode isto na máquina onde o erro aparece — as três respostas dizem exatamente onde está o problema.
# 1. As variáveis existem NESTE terminal?
echo $ANTHROPIC_BASE_URL # https://api.infinitemodel.app
echo $ANTHROPIC_API_KEY # sk-…
# 2. O serviço está de pé?
curl https://api.infinitemodel.app/health
# 3. Sua chave e seu IP passam?
curl https://api.infinitemodel.app/v1/models -H "x-api-key: $ANTHROPIC_API_KEY"# 1. As variáveis existem NESTA sessão?
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_API_KEY
# 2. O serviço está de pé?
curl.exe https://api.infinitemodel.app/health
# 3. Sua chave e seu IP passam?
curl.exe https://api.infinitemodel.app/v1/models -H "x-api-key: $env:ANTHROPIC_API_KEY"| Resultado | Conclusão |
|---|---|
| o passo 1 imprime vazio | a configuração não chegou a este terminal — refaça o passo 3 de Começando |
| o passo 2 não responde | problema de rede ou nosso; confira a página de status |
| o passo 3 devolve 401 | problema de chave |
| o passo 3 devolve 403 | problema de IP ou de plano — o código no corpo diz qual |
| o passo 3 lista modelos | está tudo certo com chave, IP e plano; o problema é da ferramenta |
Casos clássicos
Funcionava ontem, hoje dá 403
É o erro mais comum do serviço: seu IP mudou (roteador reiniciado, rede nova, VPN ligada). Atualize a whitelist no dashboard e siga.
Configurei, mas o CLI diz que não há modelos — ou dá 401
A variável foi definida em outro terminal, ou o Desktop não foi encerrado por completo. Variável de sessão só vale naquela sessão; veja a forma permanente em Começando.
429 no meio do trabalho
A vazão por minuto segura picos — por exemplo, um script disparando muitas chamadas em paralelo. O header Retry-After diz quantos segundos esperar. Uso normal de CLI raramente encosta nesse limite.
Resposta curta demais no Fable 5
Tarefas de raciocínio longo consomem parte do orçamento de saída. Peça continuação ou divida a tarefa em partes menores.
"Email ou senha inválidos" no login
A mensagem é a mesma para e-mail inexistente e senha errada, de propósito: não revelamos quais e-mails têm conta.
Ainda travado?
Escreva para suporte@infinitemodel.app com o código do erro, qual passo do diagnóstico falhou e o horário aproximado. Com isso resolvemos rápido.