Enrutamiento de modelos
Cloudflare AI Gateway: aliases de modelos y fallback
Los aliases de AI Gateway llegaron el 4 de noviembre. Organiza modelos y fallback sin redeploy, conservando compatibilidad, permisos y control del coste.
En este artículo
Un alias desacopla la aplicación del orden de modelos. No vuelve equivalentes sus formatos ni garantiza ahorro o disponibilidad: prueba cada destino y la ruta de fallo.
Qué cambia con los aliases#
El 4 de noviembre de 2026, Cloudflare incorporó aliases de modelos a AI Gateway. La aplicación solicita un nombre custom/ y el gateway resuelve su grupo de destinos. Puedes cambiar la configuración sin desplegar de nuevo la aplicación, aunque su propagación puede conservar temporalmente una configuración en caché.
Documentación: Cloudflare · Model aliases, 4 November 2026
Elegir el algoritmo y preparar destinos#
preferred intenta modelos elegibles en el orden configurado; smart selecciona uno por solicitud y vuelve al orden por defecto si no puede clasificarlos. Las opciones de una solicitud pueden sobreescribir la preferencia guardada. Habilita autenticación y configura facturación unificada o claves de proveedor antes de probar.
| Prueba | Qué demuestra |
|---|---|
| Destino primario responde | La solicitud y el formato son compatibles con ese destino. |
| Fallo del primario | El alternativo elegible responde sin saltarse políticas. |
| Salida estructurada | El esquema se conserva también cuando responde el alternativo. |
| Coste del flujo | Se contabilizan intentos, tokens y herramientas, no solo la respuesta final. |
Documentación: Cloudflare · AI Gateway model aliases
Cuerpo de una solicitud de prueba#
{
"model": "custom/support-fast",
"input": {
"messages": [
{
"role": "user",
"content": "Return one short greeting."
}
]
},
"options": {
"routing": {
"algorithm": "preferred"
}
}
}Documentación: Cloudflare · AI Gateway model aliases
Cómo desplegar el cambio de forma controlada#
- Empieza con un alias de staging y modelos que acepten el mismo contrato que tu aplicación.
- Simula un fallo recuperable y uno de permisos. Confirma cuál admite fallback y qué ve el usuario.
- Conserva identificador efectivo, versión de configuración y coste por tarea, sin guardar datos sensibles del prompt en logs.
- Despliega gradualmente y mantén un procedimiento para volver al orden anterior. Un cambio de nombre del alias también requiere cambiar lo que solicita la aplicación.
Compara coste total y tasa de tareas completadas con tus propios criterios. La existencia del alias no mide calidad y no permite usar modelos o formatos que el gateway no admite.