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
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:
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.
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 HTTP400 con el código de error validation_error. reason y details[].keyword indican la causa: