Guia rapido de selecao de modelos
VelocidadeAlter#lightOpenAI#gpt-5-nanoGemini#gemini-2.5-flash-lite
Alter#bestOpenAI#gpt-5Gemini#gemini-2.5-proClaude#claude-sonnet-4-6
OpenAI#gpt-5Mistral#codestral-2501Claude#claude-sonnet-4-6
Perplexity#sonarPerplexity#sonar-pro
Limites de uso
Em fair use:- Limite diario:
200requisicoes/dia - Apos o limite: throttling para
1 requisicao / 10 minutos - Para volume estavel mais alto: faca top-up de budget
O API Router foi feito para uso pessoal e cargas de baixo volume. Para produtos multiusuario ou trafego agentic pesado, use infraestrutura dedicada do provider.
Problemas comuns
Modelos nao listados
- Defina o modelo manualmente no formato
Provider#Model-name - Verifique se a API key e valida
- Verifique se o cliente suporta endpoint de listagem de modelos
Erros de autenticacao
- Confirme
Authorization: Bearer YOUR_API_KEY - Confirme o endpoint
https://alterhq.com/apiou/api/v1 - Confirme que sua conta esta ativa
Problemas de conexao
- Use um cliente compativel com OpenAI
- Verifique acesso de rede a
alterhq.com
Alta latencia
- Tente modelos mais leves (
OpenAI#gpt-5-nano,Alter#light) - Use streaming para saidas longas
Boas praticas
- Guarde API keys em variaveis de ambiente (nunca hardcode)
- Monitore volume de requisicoes e taxas de erro
- Combine capacidade do modelo com complexidade da tarefa
- Implemente retries com backoff
- Use modelos de menor custo para tarefas rotineiras