Convenciones de nomenclatura
En esta página
Actualizado el 3 de noviembre de 2026. Basado en la página Models de xAI (sección Model Aliases): la tabla incluye
grok-4.7, el modelo recomendado por xAI, ygrok-4.6. La recomendación para producción sigue las directrices de xAI, que aconsejan usar el alias para la mayoría de los casos de uso y la versión fechada para flujos de trabajo que requieren consistencia estricta. Fuente: Models.
Comprensión de los identificadores de modelo
Cuando llamas a la API de xAI, el campo model determina qué modelo procesa tu solicitud. xAI emplea un sistema de nomenclatura estructurado con alias y versiones fijadas. Entender este sistema es esencial para gestionar la estabilidad y la migración de tus aplicaciones.
Los tres formatos de identificador
xAI ofrece tres formas de hacer referencia a un modelo, cada una con un comportamiento distinto:
Alias simple
{
"model": "grok-4.20"
}
El alias simple apunta a la última versión estable del modelo. Cuando xAI publica una actualización menor, el alias redirige automáticamente a la nueva versión. Tu aplicación utiliza siempre la versión estable más reciente sin necesidad de cambiar el código.
Ventaja: te beneficias automáticamente de las mejoras. Riesgo: el comportamiento puede variar ligeramente de una versión a otra.
Alias latest
{
"model": "grok-4.20-latest"
}
El alias latest apunta a la versión de vanguardia: la iteración más reciente, incluyendo versiones que aún no se han promovido a estables. Es la más actual, pero potencialmente la menos probada.
Ventaja: acceso inmediato a las últimas mejoras. Riesgo: el comportamiento puede cambiar en cualquier momento; son posibles regresiones.
Versión fijada
{
"model": "grok-4.20-0309"
}
La versión fijada identifica una versión específica del modelo, indexada por su fecha de lanzamiento (en este caso, 9 de marzo). Esta versión nunca cambia: el comportamiento que observas hoy será idéntico dentro de seis meses.
Ventaja: estabilidad total, resultados reproducibles. Riesgo: la versión acabará quedando obsoleta y será eliminada.
Identificadores completos actuales
| Identificador de API | Tipo | Comportamiento |
|---|---|---|
| grok-4.20-0309-reasoning | Versión fijada | Nunca cambia |
| grok-4.20-0309-non-reasoning | Versión fijada | Nunca cambia |
| grok-4.20-multi-agent-0309 | Versión fijada | Nunca cambia |
| grok-4.7 | Alias | Última versión estable del modelo recomendada por xAI |
| grok-4.6 | Alias | Última versión estable |
| grok-4.5 | Alias | Última versión estable (alias `grok-4.5-latest` para la más reciente) |
| grok-4.3 | Alias | Última versión estable |
| grok-build-0.1 | Alias | Modelo de código, última versión estable |
Ciclo de vida del modelo
Cada modelo de xAI sigue un ciclo de vida de tres fases:
- Activo: el modelo está disponible y se recomienda para uso en producción.
- Obsoleto (Deprecated): el modelo sigue funcionando, pero xAI recomienda migrar a una versión más reciente. Se anuncia una fecha límite antes de su eliminación.
- Retirado: el modelo se elimina. Las solicitudes a este modelo fallan.
Presta atención a los anuncios de obsolescencia en la consola de xAI y en las notas de la versión. Cuando un modelo quede obsoleto, planifica tu migración sin esperar a la fecha de eliminación.
Recomendaciones por entorno
Desarrollo
Utiliza alias simples (grok-4.7, grok-4.3) para beneficiarte automáticamente de las mejoras. En desarrollo, un ligero cambio de comportamiento entre versiones es aceptable y te permite detectar incompatibilidades antes de pasar a producción.
Staging y pruebas
Emplea versiones fijadas (grok-4.20-0309-reasoning) para garantizar la reproducibilidad de las pruebas. Si una prueba pasa hoy, debe pasar mañana con exactamente el mismo resultado.
Producción
xAI recomienda el alias simple o el alias -latest para la mayoría de los casos de uso, lo que te permite beneficiarte automáticamente de las nuevas funciones, y reserva la versión fechada para flujos de trabajo que requieren consistencia estricta. Si tu entorno de producción entra en esta categoría —resultados auditables, cumplimiento normativo, pruebas de regresión—, fija la versión fechada y planifica migraciones periódicas tras validarlas en staging.
Migración entre versiones
Cuando migres de una versión a otra:
- Actualiza el campo
modelen tus solicitudes. - Prueba tus prompts existentes: los modelos más recientes pueden responder de forma diferente.
- Comprueba los parámetros de la API: una nueva versión puede admitir o dejar de admitir ciertos parámetros.
- Valida los resultados: compara cualitativamente las salidas de la versión antigua y la nueva.
Endpoints de la API
xAI mantiene dos endpoints principales:
/v1/responses: el endpoint principal, recomendado para todos los proyectos nuevos./v1/chat/completions: el endpoint heredado, mantenido para compatibilidad con clientes existentes.
El endpoint heredado ya no recibe nuevas funciones. Si estás iniciando un nuevo proyecto, usa exclusivamente /v1/responses.
Puntos clave
- Tres formatos: alias simple (estable), alias latest (vanguardia), versión fijada (inmutable).
- En producción, usa versiones fijadas para garantizar la estabilidad.
- En desarrollo, usa alias para beneficiarte de las mejoras.
- Presta atención a los anuncios de obsolescencia y planifica tus migraciones.
- El endpoint recomendado es
/v1/responses, no/v1/chat/completions. - Prueba siempre tus prompts al migrar de versión.