Inicio → Ayuda

Model not found: cuando el nombre del modelo es casi correcto

Lista los modelos a los que llega tu clave y compara el nombre carácter por carácter. Los ID de modelo son exactos, y las familias rara vez son coherentes con los separadores.

Lo que ves

Por qué ocurre

El nombre suele ser el culpable, y es realmente difícil de adivinar. Dentro de una misma familia encontrarás versiones escritas con punto en una versión y con guion en la siguiente: un nombre que para una persona se lee igual es una cadena distinta para la API.

La segunda causa es el acceso, no el nombre. En pasarelas donde las claves pertenecen a un plan o grupo, un modelo puede existir en la plataforma y aun así quedar fuera de lo que tu clave puede llamar. El mensaje a menudo no distingue ambos casos, lo que lleva a buscar una errata que no existe.

En una pasarela el mensaje también puede nombrar al grupo en lugar del modelo: Model "gpt-4o" is not supported by any configured account in this group. Vale la pena leerlo con atención — no dice que el modelo no esté disponible en ningún sitio, solo que las cuentas que respaldan el grupo de tu clave no lo tienen. El mismo texto aparece tanto si escribiste mal el nombre como si elegiste un modelo fuera de tu plan, así que revisa el listado antes de suponer cualquiera de las dos cosas.

Comprueba si es esta la causa

Pregunta a la API qué ve tu clave, en lugar de fiarte de una página de documentación:

curl -s 'YOUR_BASE_URL/models' \
  -H 'Authorization: Bearer YOUR_KEY' \
  | grep -o '"id":"[^"]*"'

Si el modelo no está en esa lista, corregir la ortografía no servirá de nada: la clave no tiene acceso a él.

Cómo solucionarlo

  1. Copia el ID, nunca lo reescribasToma la cadena directamente del listado de modelos. Puntos frente a guiones y sufijos de versión con fecha son las dos cosas que más se equivocan.
  2. Revisa el ámbito de tu claveSi el modelo aparece en la documentación pública pero no en tu propio listado, el problema es a qué tiene acceso la clave. Una clave de un plan normalmente no puede llamar a los modelos de otro plan.
  3. Cuidado con los alias que desaparecenLos alias de conveniencia que apuntan a la versión actual pueden retirarse sin aviso. Fijar el ID completo es más largo y bastante más estable.
En APICLAN cada clave pertenece a un grupo, y GET /v1/models devuelve exactamente lo que esa clave puede llamar. Los ID de modelo actuales y sus precios están en la página principal.

Relacionado

Unexpected token '<' al llamar a una API compatible con OpenAI401 invalid API key: cuando la clave parece correcta pero sigue fallando

Revisado por última vez el 2026-10-01. Escrito a partir de problemas diagnosticados en una pasarela compatible con OpenAI en producción, no recopilado de otras webs.