Source: https://aiprimetech.io/es/docs/guides/troubleshooting/

[Inicio](/es/) / [Documentación](/es/docs/) / Resolución de problemas 

# Resolución de problemas 

Índice organizado por síntomas: encuentra lo que estás observando y ve directamente a la causa. 

 Copiar página [ Ver como Markdown](/es/docs/guides/troubleshooting.md) [ Preguntar a ChatGPT](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/guides/troubleshooting.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) [ Preguntar en Claude](https://claude.ai/new?q=Read%20https%3A//aiprimetech.io/docs/guides/troubleshooting.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.)   

## 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](/es/docs/getting-started/models/) o la [lista de comprobación para configurar agentes](/es/agents/) si no sabes con certeza qué paso ha fallado. 

## No funciona nada 

Establece una referencia de funcionamiento antes de depurar cualquier otra cosa: 

```
Copycurl -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](/es/docs/getting-started/base-urls/)

 | 401 con una clave que acabas de crear | Cabecera incorrecta para el formato o un espacio al final | [Autenticación](/es/docs/getting-started/authentication/)

 | 402 | Sin créditos o con el plan caducado | [Recargar saldo](/es/topup/) · [Planes](/es/plans/)

 | 400 max_tokens | Messages requiere max_tokens; Chat Completions no lo requiere | [Messages](/es/docs/api-reference/messages/)

 | model_not_found | ID incorrecto, grupo de claves incorrecto o modelo no disponible para esa clave | [Modelos y grupos de claves](/es/docs/getting-started/models/)

 | La transmisión se conecta, pero no devuelve nada | Se está analizando la estructura de eventos del otro formato | [Transmisión en tiempo real](/es/docs/api-reference/streaming/)

 | 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](/es/docs/getting-started/base-urls/)

 | 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](/es/docs/guides/claude-code/)

 | Frecuentes 429 | El paralelismo del agente es demasiado alto | [Límites de solicitudes](/es/docs/api-reference/rate-limits/)

 | La factura es más alta de lo esperado | El contexto crece con cada turno | [Gestión del contexto](/es/docs/guides/context-management/) 

## 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](mailto: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. 

[ErroresReferencia de códigos de estado](/es/docs/api-reference/errors/)[URL baseEl fallo más habitual](/es/docs/getting-started/base-urls/)[Configuración de la clave de APIConfiguración por herramienta](/es/docs/guides/api-key-configuration/) 

[AnteriorBuenas prácticas para producción](/es/docs/guides/best-practices/)[SiguienteDescripción general de los SDK](/es/docs/sdks/)