Los ID de modelos no son portables: api.anthropic.com requiere ID fechados, Gemini sus propias cadenas de versión y cada pasarela define sus slugs. Un 404 aquí significa «este host no tiene ningún modelo con esa cadena exacta»; la solución siempre es preguntar al endpoint qué ofrece.
El error
{
"error": {
"type": "model_not_found",
"message": "The model 'claude-sonnet' does not exist or you do not have access to it.",
"code": "model_not_found"
}
}Causas y soluciones de un vistazo
| Causa | Solución |
|---|---|
| ID de modelo de otro host | Cada API tiene su propio espacio de nombres: copia los ID de la lista de modelos del propio endpoint, no de publicaciones de blogs. |
| Versión obsoleta o renombrada | Los proveedores retiran snapshots fechados; fija un ID actual y suscríbete a las notas de obsolescencia. |
| Slug escrito incorrectamente o truncado | claude-sonnet no es un modelo en ningún sitio; las cadenas exactas importan. |
| El modelo existe, pero está desactivado para tu clave o plan | Algunos hosts restringen los modelos según el plan; el endpoint de lista muestra qué puede invocar TU clave. |
Enumera los modelos del endpoint que estás llamando
GET /v1/models es la fuente de verdad en cualquier host compatible con OpenAI; devuelve exactamente los ID que puede usar tu clave:
curl -s https://api.kunavo.com/v1/models \
-H "Authorization: Bearer $KUNAVO_API_KEY" \
| python3 -c "import json,sys; print('\n'.join(m['id'] for m in json.load(sys.stdin)['data']))"Resuelve los modelos en tiempo de ejecución, no de forma codificada
Los catálogos cambian (nuevos snapshots y retiradas). Resuelve la lista de modelos al iniciar, da preferencia a los slugs configurados con un fallback y alerta cuando un slug configurado desaparezca de /v1/models, en lugar de esperar un 404 en producción.
Si llamas a través de Kunavo
Kunavo utiliza slugs estables y legibles para las personas (claude-sonnet-5, gpt-5-6-terra, claude-fable-5), enumerados en GET /v1/models con metadatos por modelo; los slugs retirados redirigen mediante 301 a sus sucesores en las páginas de modelos del sitio para que los enlaces no queden obsoletos. El endpoint de lista es la autoridad; llms.txt indica lo mismo a cualquier agente que lo lea.
Preguntas frecuentes
¿Por qué el mismo ID de modelo funciona en una API y devuelve 404 en otra?
Porque los ID tienen un espacio de nombres por host: los ID fechados de Anthropic, los nombres versionados de Gemini y los slugs de cada pasarela son cadenas distintas para modelos relacionados. Copia siempre el ID de la lista de modelos del endpoint de destino.
¿Cómo preparo mi sistema para futuras retiradas de modelos?
Resuelve /v1/models al iniciar, mantén el ID del modelo en la configuración (no en el código), define una cadena de fallback y avísate cuando desaparezca un ID configurado; así conviertes un 404 de producción en un cambio de configuración.
Guías relacionadas
Encontrarás más detalles sobre el significado de los errores en referencia de errores; obtener una clave lleva un minuto mediante registro y la guía de autenticación.