Operaciones y solución de problemas de API Router

​

Guía rápida de selección de modelos

• Alter#light
• OpenAI#gpt-5-nano
• Gemini#gemini-2.5-flash-lite

• Alter#best
• OpenAI#gpt-5
• Gemini#gemini-2.5-pro
• Claude#claude-sonnet-4-6

• OpenAI#gpt-5
• Mistral#codestral-2501
• Claude#claude-sonnet-4-6

• Perplexity#sonar
• Perplexity#sonar-pro

​

Límites de uso

• Límite diario: 200 solicitudes/día
• Después del límite: se reduce a 1 solicitud / 10 minutos
• Para volumen sostenido más alto: recarga presupuesto

​

Problemas comunes

​

Modelos no listados

• Define manualmente el modelo como Provider#Model-name
• Verifica que la clave API sea válida
• Verifica que el cliente soporte endpoints de listado de modelos

​

Errores de autenticación

• Confirma Authorization: Bearer YOUR_API_KEY
• Confirma el endpoint https://alterhq.com/api o /api/v1
• Confirma que tu cuenta esté activa

​

Problemas de conexión

• Usa un cliente compatible con OpenAI
• Verifica acceso de red a alterhq.com

​

Alta latencia

• Prueba modelos más ligeros (OpenAI#gpt-5-nano, Alter#light)
• Usa streaming para salidas largas

​

Mejores prácticas

1. Guarda claves API en variables de entorno (nunca en hardcode)
2. Monitorea volumen de solicitudes y tasas de error
3. Ajusta la capacidad del modelo a la complejidad de la tarea
4. Implementa reintentos con backoff
5. Usa modelos de menor costo para tareas rutinarias

​

Relacionado

• Servicio API Gateway y Router
• API Router para desarrollo
• API Gateway no lista modelos