Alias, última versión y versiones fijadas
En esta página
Tres formas de referenciar un modelo
El campo model de tu solicitud acepta tres convenciones de nomenclatura para designar lo que, en apariencia, es el mismo modelo. Esto no es un simple detalle documental: según la convención que elijas, tu aplicación recibirá exactamente el mismo modelo en cada llamada durante meses o una versión susceptible de cambiar sin previo aviso. La mayoría de las regresiones en producción inexplicables —«nuestras respuestas se han vuelto más largas, pero nadie ha cambiado nada»— tienen su origen aquí.
Alias simple
El alias simple utiliza el nombre base del modelo, sin sufijo:
{
"model": "grok-4.20"
}
Esto apunta a la última versión estable del modelo. xAI puede actualizar la versión subyacente en cualquier momento y solo lo sabrás si monitorizas tus propios resultados. Esta flexibilidad es exactamente lo que necesitas durante el desarrollo y la creación de prototipos: trabajas siempre con la mejor versión disponible sin tener que actualizar nada. Mientras iteres sobre los prompts, explores las capacidades del modelo y la reproducibilidad exacta de las respuestas no sea crítica, esta convención funciona.
Alias «latest»
El alias latest apunta a la versión más avanzada, aquella que aún no se ha estabilizado:
{
"model": "grok-4.20-latest"
}
Lo que obtengas aquí puede cambiar con frecuencia e incluir cambios que aún están en fase de validación. Es una herramienta de evaluación útil para probar versiones futuras antes de que se conviertan en el alias predeterminado, medir mejoras de calidad o rendimiento y preparar tu migración con información suficiente.
Pertenece a entornos de prueba, nunca a producción. Un cambio puede ocurrir de la noche a la mañana, alterar el comportamiento de tu prompt y llegar a tus usuarios sin advertencia; no tendrás una línea de confirmación ni un ticket al que culpar para entender qué ha ocurrido.
Versión fijada
Una versión fijada incluye una fecha en el identificador:
{
"model": "grok-4.20-0309"
}
El sufijo -0309 corresponde a la fecha de lanzamiento, en este caso el 9 de marzo. Esta versión no se mueve: mientras permanezca activa, el modelo que responda hoy será el mismo que responda dentro de seis meses. Es la única opción defendible para producción, por cuatro razones sólidas. El comportamiento de tu aplicación se vuelve reproducible, lo que hace que tus pruebas de integración y de regresión sean válidas a largo plazo. Ninguna actualización silenciosa te pillará desprevenido. El momento de la migración se convierte en una decisión planificada del equipo, no en algo que te ocurre. Y si el comportamiento cambia de todos modos, sabrás que la causa está en tu lado.
Una convención por entorno
La mejor práctica no consiste en elegir entre las tres, sino en asignar cada una a su entorno:
import os
ENVIRONMENT = os.getenv("APP_ENV", "development")
MODEL = {
"development": "grok-4.20", # Alias simple: última estable
"staging": "grok-4.20-latest", # Latest: probar nuevas funcionalidades
"production": "grok-4.20-0309", # Versión fijada: máxima estabilidad
}[ENVIRONMENT]
Considera este diccionario como un sistema de alerta temprana. Tu entorno de staging se ejecuta permanentemente sobre latest: si un cambio futuro rompe un prompt, tus pruebas de integración lo detectarán antes que tus usuarios. Mientras tanto, tu producción permanece en una versión fijada. Descubres los cambios aguas arriba sin sufrirlos nunca aguas abajo.
Pasar de una versión fijada a la siguiente
Cuando aparece una nueva versión fijada —digamos grok-4.20-0612—, el cambio merece un procedimiento en lugar de un simple cambio de cadena. Primero despliega la nueva versión en staging mediante el alias latest, ejecuta allí tu batería de pruebas de prompts y compara los resultados con los de la versión que está actualmente en producción. Si la comparación es satisfactoria, actualiza la configuración de producción, monitoriza las métricas durante 48 horas —calidad de la respuesta, tasa de satisfacción, coste— y valida la migración o revierte a la versión anterior.
El paso de comparación es el núcleo del sistema y asume que has conservado los resultados de la versión en vigor: sin esta referencia, «comparar» se reduce a una impresión. La fase de observación incluye deliberadamente el coste. Una versión más nueva podría ser más verbosa, generar más tokens de salida y aumentar tu factura varios puntos porcentuales para una calidad percibida equivalente. Cuarenta y ocho horas suelen ser suficientes para detectar esto, y revertir a la versión anterior sigue siendo una simple línea de configuración.
Puntos clave
- Alias simple (
grok-4.20): última versión estable, para desarrollo - Alias latest (
grok-4.20-latest): versión de vanguardia, solo para pruebas - Versión fijada (
grok-4.20-0309): inmutable, la única opción recomendada para producción - Utiliza diferentes convenciones por entorno (dev/staging/prod)
- Planifica un proceso de migración estructurado al pasar de una versión fijada a otra