Resolução de Problemas com Base URLs
Trocar de modelos deve ser simples. Você altera o endpoint e continua usando o mesmo SDK. Frequentemente, ocorrem falhas com erros como 401, 404 ou 429.
Antes de culpar o SDK, execute estes 7 testes.
Verifique o prefixo /v1 A maioria dos gateways precisa do sufixo /v1 na URL base. Se você usar apenas o domínio, o SDK pode chamar o caminho errado. Sempre copie o formato exato da documentação do provedor.
Verifique suas chaves de API Misturar chaves causa a maioria das falhas. Fique atento a estes pontos:
- Usar uma chave da OpenAI com uma URL de relay.
- Usar uma chave de relay com uma URL da OpenAI.
- Usar chaves de projetos desativados.
- Incluir espaços extras na chave.
Se você vir um erro 401, imprima apenas os primeiros e últimos caracteres da sua chave para compará-la com o seu dashboard. Nunca registre a chave completa.
Use nomes de modelos exatos Não tente adivinhar os nomes dos modelos. Os nomes nos gateways mudam com base na disponibilidade. Copie o ID do modelo exatamente da lista do provedor. Um nome incorreto leva a erros 404 ou model_not_found.
Execute uma pequena requisição de teste Teste sua conexão com uma única requisição pequena antes de depurar todo o seu aplicativo. Se um simples "ping" funcionar, sua URL, chave e modelo estão corretos. O problema reside na lógica do seu aplicativo, como streaming ou chamadas de ferramentas (tool calling).
Entenda os códigos de erro
- 401 significa que sua chave ou o estado da sua conta está incorreto.
- 429 significa que você atingiu um limite de taxa (rate limit) ou não tem saldo. Se você vir um 429, verifique sua página de faturamento. Evite loops de repetição (retry loops) muito curtos, pois eles agravam o limite.
Verifique a página de status Se o seu código funcionava ontem, mas falha hoje, não reescreva sua integração. Verifique a página de status do provedor. Incidentes upstream são comuns em serviços de relay.
Use um comando curl Mantenha um comando curl minimalista na documentação do seu projeto. Execute-o quando o aplicativo falhar.
- Se o curl falhar: Depure sua conta, gateway ou rede.
- Se o curl funcionar: Depure o código do seu aplicativo.
Fundamentos sólidos tornam a troca de modelos fácil.
Comunidade de aprendizado opcional: https://t.me/GyaanSetuAi