Ids de modelo y variantes

Los ids de modelo en api14 usan el formato provider/model, por ejemplo openai/gpt-5-mini. Pasa el id en el campo model de cualquier petición.

{ "model": "anthropic/claude-sonnet-4.5" }

Encontrar ids de modelo

• Explora la página de modelos: todos los modelos con su id, precios, longitud de contexto y capacidades.
• Llama a GET /models desde código; filtra por categoría con ?category=image. Consulta Modelos.

Algunos ejemplos:

Los ids distinguen mayúsculas de minúsculas. Un id desconocido o desactivado devuelve 404 model_not_found.

Variantes

Una variante es un sufijo tras dos puntos que cambia cómo se atiende la petición. Las variantes funcionan con el mismo modelo base; se aplican la disponibilidad y las reglas de la lista de modelos permitidos del modelo base.

{ "model": "openai/gpt-5-mini:online" }

:nitro y :floor son atajos para ordenar proveedores, equivalentes a provider: { sort: "throughput" } y provider: { sort: "price" }. Consulta Enrutamiento de proveedores y respaldos.

Modelos de respaldo

Envía un array models para probar otros modelos cuando el primero falla o no está disponible:

{
  "model": "anthropic/claude-sonnet-4.5",
  "models": ["openai/gpt-5-mini", "google/gemini-2.5-flash"],
  "messages": [{ "role": "user", "content": "Hello" }]
}

Todos los modelos de la lista deben estar disponibles y permitidos para tu clave y tu plan; de lo contrario, la petición se rechaza antes de enviarse. El campo model de la respuesta indica cuál respondió, y pagas el precio de ese modelo.

Listas de permitidos y planes

• Una clave con una lista de modelos permitidos solo puede usar los ids indicados; otros ids devuelven 403 model_not_allowed.
• Todos los planes, incluido Free, cubren todas las categorías de modelos, también vídeo y música/audio. Un plan limitado a ciertas categorías devuelve 403 plan_required para las demás. Consulta Precios y facturación.

Cambios en los modelos

El catálogo se actualiza automáticamente. Los modelos nuevos aparecen por sí solos; los modelos retirados devuelven 404 model_not_found. Fija ids exactos en producción y usa respaldos con models para ganar resiliencia.