Resolución de problemas
Índice organizado por síntomas: encuentra lo que estás observando y ve directamente a la causa.
Comprueba el acceso antes de reintentar
- Comprueba si el derecho de acceso previsto está activo y anota su fecha de caducidad.
- Confirma que la clave usa el grupo previsto. Los planes de Claude de duración limitada usan Claude Unlimited; el acceso a Codex es independiente.
- Enumera los modelos con esa misma clave, selecciona un ID devuelto y envía una solicitud pequeña.
Usa Modelos y grupos de claves o la lista de comprobación para configurar agentes si no sabes con certeza qué paso ha fallado.
No funciona nada
Establece una referencia de funcionamiento antes de depurar cualquier otra cosa:
curl -s -o /dev/null -w "%{http_code}\n" https://aiprimetech.io/v1/models \
-H "Authorization: Bearer $CLAUDEAPIKEY"Tras recibir correctamente la lista de modelos, comprueba que el modelo seleccionado figure en ella y envía una solicitud de generación pequeña. La generación aún puede fallar por la disponibilidad del modelo, los derechos de acceso, los límites o la configuración del cliente.
Por síntoma
| Síntoma | Causa probable | Solución |
|---|---|---|
404 en cada llamada | La URL base tiene un tratamiento incorrecto de /v1 tratamiento | URL base |
401 con una clave que acabas de crear | Cabecera incorrecta para el formato o un espacio al final | Autenticación |
402 | Sin créditos o con el plan caducado | Recargar saldo · Planes |
400 max_tokens | Messages requiere max_tokens; Chat Completions no lo requiere | Messages |
model_not_found | ID incorrecto, grupo de claves incorrecto o modelo no disponible para esa clave | Modelos y grupos de claves |
| La transmisión se conecta, pero no devuelve nada | Se está analizando la estructura de eventos del otro formato | Transmisión en tiempo real |
| La respuesta se corta a mitad de una frase | stop_reason: max_tokens | Aumenta max_tokens |
| Funciona con curl, pero falla en el SDK | El SDK añade su propia ruta a tu URL base | URL base |
| El uso no aparece en el panel | Las solicitudes se envían a otra clave u otro endpoint | Comprueba ANTHROPIC_API_KEY no está definido — Claude Code |
Frecuentes 429 | El paralelismo del agente es demasiado alto | Límites de solicitudes |
| La factura es más alta de lo esperado | El contexto crece con cada turno | Gestión del contexto |
Cómo leer el cuerpo del error
El código de estado indica la clase de problema; los campos error.type y error.message indican cuál es. Registra el cuerpo completo: un 400 por "missing max_tokens" y un 400 por "invalid role" requieren soluciones completamente distintas.
¿Sigues sin resolverlo?
Contacta con support@aiprimetech.io con el endpoint, el ID del modelo, el código de estado y el cuerpo del error. Nunca incluyas tu clave API; si ya la has pegado en algún sitio, revócala primero.