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.
Evidencia y alcance
Documentación verificada · Fuentes revisadas:
Método
Se verificaron el anuncio del 4 de noviembre y el contrato documentado de aliases de Cloudflare. El cuerpo JSON respeta la estructura publicada; la matriz de fallos es una pauta de validación, no un benchmark ejecutado.
Limitaciones
- No se crearon aliases ni se hicieron llamadas pagadas. La elegibilidad de modelos, formatos, claves y facturación depende del gateway.
Próxima revisión prevista:
Fuentes y alcance
Documentación consultada el 4 de noviembre de 2026. Los ejemplos y criterios de decisión son propuestas editoriales; adáptalos al contrato de tu aplicación y valídalos en tu entorno de pruebas autorizado.