Saltar al contenido principal
Pon un ID de proveedor y dos puntos delante del ID del modelo, como baseten:thinking-machines/inkling-small, para ejecutar la solicitud solo en ese proveedor, sin alternativa a otro proveedor. El formato es <provider-id>:<canonical-model-id>. Los primeros dos puntos separan el proveedor; los dos puntos que aparecen después del espacio de nombres del modelo siguen formando parte del ID del modelo. En google-ai-studio:google/gemma-4-26b-a4b:free, el proveedor es google-ai-studio y el modelo es google/gemma-4-26b-a4b:free. Si solo prefieres un proveedor y quieres una alternativa cuando falle, usa el ID de modelo simple con los controles de enrutamiento y alternativas.

Envía una solicitud

Usa el ID calificado en cualquier lugar donde el endpoint acepte un ID de modelo.

Qué debe seguir cumpliendo el proveedor

El calificador limita el enrutamiento a un proveedor; no omite ninguna otra comprobación. El proveedor debe seguir:
  • sirviendo el modelo canónico en el endpoint solicitado, con esa capacidad habilitada
  • cumpliendo las restricciones del espacio de trabajo, la clave de API, el preajuste y la privacidad
  • admitiendo el nivel de servicio y los parámetros solicitados
  • teniendo precios configurados
Si falla alguna comprobación, la solicitud se rechaza. Phaseo nunca elige otro proveedor sin avisar.

Combínalo con los campos provider o routing

El calificador y los campos de enrutamiento explícitos deben coincidir. Se acepta un provider.only o routing.only que coincida:
Una lista de permitidos que nombra otros proveedores, o una lista de ignorados que contiene el proveedor calificado, se rechaza con provider_qualified_model_conflict:

Solicita una ruta gratuita en un proveedor

Un modelo :free calificado solo se acepta cuando ese proveedor tiene una ruta gratuita apta para el modelo y el endpoint. Un modelo canónico :free no significa que todos los proveedores del modelo subyacente lo ofrezcan gratis.
La tarjeta de precios de la ruta no puede estar vacía, y cada regla de precio vigente que contenga debe estar etiquetada como free y tener un precio exactamente cero. Los precios ausentes, de pago, mixtos o negativos, o una regla con precio cero no etiquetada como free, rechazan la solicitud antes de que llegue al proveedor.

ID y alias de proveedores

Usa un ID de proveedor del catálogo de proveedores de Phaseo (consulta Proveedores de API). Los ID se convierten a minúsculas, y los alias heredados o de marca conocidos se asignan al ID canónico: NovitaAI y novita-ai se convierten en novita. Los ID mal formados y desconocidos se rechazan antes de seleccionar el proveedor; nunca se envían upstream como parte del nombre del modelo.

Errores de validación

Un ID calificado incorrecto devuelve HTTP 400 con el código de error validation_error. reason y details[].keyword indican la causa:
Para otros formatos de error, consulta Errores y depuración.
Última modificación el 5 de noviembre de 2026