Inicio → Ayuda

Un modelo que ayer funcionaba ahora falla para todos en el mismo grupo de claves

Las pasarelas enrutan por grupos: una clave pertenece a un grupo, y un grupo apunta a una o más cuentas upstream. Si el grupo tiene una sola cuenta y esa cuenta deja de servir el modelo (crédito caducado, clave revocada, una lista de modelos que ya no coincide), todas las claves del grupo pierden el modelo a la vez.

Lo que ves

Por qué ocurre

El texto del error apunta al modelo, lo que lleva a la gente a revisar la ortografía y la disponibilidad. Lo que realmente se está informando es «ninguna cuenta de tu grupo puede servir esto», y el arreglo está del lado de las cuentas.

Los grupos de una sola cuenta no tienen redundancia por definición. Con dos o más cuentas el enrutador conmuta y nadie se entera; con una, un único problema upstream es una caída total para ese grupo.

Una versión más sutil: una cuenta anuncia un modelo que en realidad no puede entregar. Todas las peticiones enviadas a ella fallan y, según la lógica de salud del enrutador, los fallos repetidos pueden sacar de rotación a todo el grupo, así que empiezan a fallar también modelos que estaban bien. Lo hemos visto exactamente así: un solo nombre de modelo mal declarado en la lista de una cuenta tumbó el tráfico de todo un grupo.

Comprueba si es esta la causa

Pregunta a la pasarela a qué puede llegar realmente tu clave, en lugar de suponerlo:

curl -s 'YOUR_BASE_URL/models' \
  -H 'Authorization: Bearer YOUR_KEY' \
  | python3 -c 'import sys,json; d=json.load(sys.stdin); print(len(d["data"]), "models"); [print(" ", m["id"]) for m in d["data"]]'

Si el modelo no está en esta lista, el grupo de la clave no puede servirlo y ningún arreglo en la petición servirá. Si está pero las llamadas siguen fallando, lo que está roto es la cuenta upstream detrás del grupo.

Cómo solucionarlo

  1. Consulta primero /models con la clave que fallaResponde en una sola petición si es un problema de enrutamiento o de la petición, y no cuesta nada.
  2. Pregunta al proveedor a qué grupo pertenece la claveDos claves que parecen idénticas pueden estar en grupos distintos con cuentas upstream distintas. Conocer el grupo convierte «a veces funciona» en una regla reproducible.
  3. Ten una segunda clave en otro grupo para lo importanteEs la redundancia más barata que existe: cuando un grupo tiene un problema upstream, cambiar de clave es un cambio de una línea en lugar de una caída.
  4. No dependas de que un modelo aparezca en una lista públicaUn modelo listado en una página de precios puede no estar disponible para tu grupo concreto. La respuesta fiable es lo que devuelve /models para tu clave.
En APICLAN cada clave pertenece exactamente a un grupo, y /models siempre refleja lo que esa clave puede llamar de verdad. Qué modelos tiene cada grupo se indica en la página de precios.

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.