Solução de problemas
Métodos de solução organizados por mensagem de erro. No final de cada erro há um request id, inclua-o ao entrar em contato com o suporte para identificar o problema mais rapidamente.
Ordem recomendada para solucionar problemas
- Teste primeiro diretamente com curl(veja o comando emTutoriais · Formato OpenAI): se o curl funcionar, a chave e a API estão funcionando; o problema está na configuração da ferramenta;
- Verifique depois a configuração da ferramenta: endereço da API, chave, nome do modelo e grupo;
- Por fim, consulte o console: «Registros de uso», saldo e limite da chave.
401 · Token inválido
{"error":{"message":"无效的令牌 (request id: ...)"}}
- A chave foi copiada incompleta ou faltou
sk-o prefixo; - A chave foi excluída, desativada ou expirou. Confira emChaves de APIa página para ver o status;
- Cabeçalho da solicitação incorreto: use o formato OpenAI com
Authorization: Bearer sk-...e o formato Anthropic comx-api-key: sk-...; - Claude Code: confirme se a variável de ambiente está ativa ou use a
settings.jsonconfiguração.
403 · Cota insuficiente
{"error":{"message":"token quota is not enough, token remain quota: ...","code":"pre_consume_token_quota_failed"}}
- O limite de uso definido para esta chave foi atingido: aumente-o ou defina-o como ilimitado emChaves de API
- Saldo insuficiente na conta: faça uma recarga primeiro.
503 · Nenhum canal disponível
{"error":{"code":"model_not_found","message":"分组 claude-max 下模型 gpt-6-sol 无可用渠道 ..."}}
- Grupo incorreto: por exemplo, use uma chave do grupo
claude-maxpara chamar modelos GPT ou uma chave do grupodeepseekpara chamar modelos GLM. Use uma chave do grupo correspondente ou use o grupodefault; - Nome do modelo incorreto: o ID do modelo deve corresponder exatamente àlista de modelos, por exemplo,
claude-sonnet-5、gpt-6-sol、deepseek-v4-pro、glm-5.3。
404 · Endereço do endpoint incorreto
{"error":{"message":"Invalid URL (POST /v1/v1/messages)"}}
- Claude Code / Anthropic SDK: preencha o endereço
https://aixvaro.com,nãoinclua/v1, caso contrário, será convertido em/v1/v1/...; - Codex / OpenAI SDK / maioria dos clientes: preencha o endereço
https://aixvaro.com/v1,necessárioinclua/v1; - O Codex também precisa ser configurado nas configurações
wire_api = "responses"。
429 / 5xx · muitas solicitações ou serviço upstream ocupado
- Muitas solicitações em pouco tempo acionaram o limite de taxa. Tente novamente mais tarde ou reduza a simultaneidade;
- O provedor do modelo está temporariamente ocupado (como 529 Overloaded ou 500). Geralmente, o serviço se recupera em instantes. Recomendamos adicionar novas tentativas ao código;
- Se o problema persistir, entre em contato com o suporte e informe o request id e o horário da ocorrência.
Tempo limite da solicitação esgotado ou resposta interrompida
- Verifique a rede local e o proxy e confirme se é possível acessar normalmente
https://aixvaro.com; - Para respostas longas, recomendamos usar a saída em fluxo (
"stream": true) para evitar que o cliente ou o proxy desconecte após uma espera prolongada; - Se o tempo limite configurado no cliente for muito curto, aumente-o.
DeepSeek / GLM
A solicitação foi concluída com sucesso, mas o conteúdo content está vazio
DeepSeek-V4 e a série GLM-5 geram primeiro o processo de raciocínio,max_tokens se for muito pequeno, todo o limite será usado no raciocínio e o conteúdo ficará vazio (finish_reason para length). Basta ajustar max_tokens para mais de 1024.
Erro «Nenhum canal disponível» após configurar o DeepSeek / GLM no Claude Code
O Claude Code chama modelos menores em segundo plano (por padrão, Claude Haiku), mas deepseek / glm as chaves do grupo não incluem modelos Claude. ConfigureTutorial · DeepSeek / GLM ANTHROPIC_DEFAULT_HAIKU_MODEL e os demais níveis de modelo para usar modelos DeepSeek ou GLM.
Geração de vídeo (MiniMax-H3)
{"error":{"message":"MiniMax-H3 only accepts public http(s) media URLs; file uploads and data: URLs are not supported"}}
- Os materiais precisam ser links públicos: não é possível enviar arquivos diretamente nem usar
data:Base64. Primeiro, envie a imagem / vídeo / áudio para um serviço de hospedagem de imagens ou armazenamento de objetos e, em seguida, informe ohttps://link; duration must be an integer between 4 and 15 seconds:secondsdeve ser um número inteiro entre 4 e 15;supports up to 768P: no momento, só há suporte para768P,sizealtere para768Pou deixe em branco;cannot mix frame images with reference media: não é possível usar quadros inicial e final junto com materiais de referência;- O status da tarefa mudou para
failed: causas comuns incluem links de materiais sem acesso público (exigem login, têm proteção contra hotlink ou expiraram), imagens muito pequenas ou prompts reprovados na análise de conteúdo. Tarefas com falha não geram cobranças. Ajuste e envie novamente; - Erro ao baixar o vídeo: só é possível baixar tarefas com status
statusparacompleted. Consulte o status da tarefa primeiro. Tarefas incompletas ou com falha não têm arquivo de vídeo.
Sobre o cliente
O Claude Code solicita login na conta Anthropic após ser iniciado
As variáveis de ambiente não foram aplicadas. Confirme se você executou claudena mesma janela do terminal em que definiu as variáveis. Para verificar, execute no macOS / Linux echo $ANTHROPIC_BASE_URL,execute no PowerShell echo $env:ANTHROPIC_BASE_URL。Você também pode usarConfiguração permanente。
O Codex fica exibindo “Reconnecting... 1/5”
O Codex não mostra o motivo específico. Geralmente, a chave está indisponível: o grupo está incorreto (por exemplo, você usou uma chave do grupo claude-max ). Use uma chave do grupo gpt-codex-pro ou default e teste essa mesma chave diretamente com curl.
O Codex informa que os arquivos são somente leitura e não podem ser modificados no Windows
Essa é uma limitação do sandbox integrado do Codex no Windows, não tem relação com a API. Você pode executar o Codex no WSL ou, se confiar no projeto atual, usar codex --sandbox danger-full-access(isso permite que o Codex modifique arquivos sem pedir confirmação; avalie os riscos).
Ao usar curl no terminal do Windows para enviar texto em chinês, o modelo diz que recebeu caracteres corrompidos
O terminal do Windows pode não usar UTF-8 por padrão, fazendo com que o texto em chinês na linha de comando seja codificado incorretamente. Para testar, use inglês ou envie a solicitação por um programa como Python.
O SDK Anthropic retorna 'ThinkingBlock' object has no attribute 'text'
O primeiro bloco da resposta pode conter o processo de raciocínio. Extraia apenas os blocos de texto:"".join(b.text for b in msg.content if b.type == "text")。
Ainda não conseguiu resolver? AcesseObter suporteentre em contato conosco.