API de xAI y compatibilidad con OpenAI
En esta página
Una API familiar
La API de xAI utiliza el mismo formato que la API de OpenAI. Si ya has trabajado con la API de OpenAI o con herramientas compatibles, no tienes nada nuevo que aprender. Lo único que cambia es la URL base.
https://api.x.ai/v1
Esta compatibilidad es una elección estratégica de xAI. En lugar de imponer un nuevo formato propietario, han adoptado el estándar de facto de la industria. Como resultado, cualquier herramienta, SDK o editor que admita la API de OpenAI puede utilizar grok-build-0.1 de inmediato.
Configuración mínima
Para cambiar de OpenAI a xAI en cualquier cliente compatible, solo necesitas modificar dos parámetros:
- URL base: sustituye
https://api.openai.com/v1porhttps://api.x.ai/v1 - Clave de API: utiliza tu clave de API de xAI (obtenida en
console.x.ai)
Todo lo demás —el formato de los mensajes, los parámetros de temperatura, la estructura de la respuesta— es idéntico.
Ejemplo con el SDK de Python de OpenAI
from openai import OpenAI
client = OpenAI(
api_key="your-xai-key",
base_url="https://api.x.ai/v1"
)
response = client.chat.completions.create(
model="grok-build-0.1",
messages=[
{"role": "system", "content": "Eres un asistente de programación."},
{"role": "user", "content": "Escribe una función de ordenación rápida en Python."}
]
)
Utilizas el SDK estándar de OpenAI sin ninguna modificación. Solo cambian la base_url y el nombre del modelo.
Ejemplo con curl
curl https://api.x.ai/v1/chat/completions \
-H "Authorization: Bearer your-xai-key" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-build-0.1",
"messages": [
{"role": "user", "content": "Explica la diferencia entre let y const en JavaScript"}
]
}'
Obtención de una clave de API
- Ve a console.x.ai
- Inicia sesión con tu cuenta de xAI (o crea una en accounts.x.ai)
- En la sección API Keys, genera una nueva clave
- Cópiala de inmediato; no se volverá a mostrar
Mantén esta clave segura. Nunca la incluyas en un repositorio de Git ni la compartas en chats de equipo. Utiliza una variable de entorno o un gestor de secretos.
Endpoints disponibles
grok-build-0.1 admite los siguientes endpoints, todos en formato OpenAI:
/v1/chat/completions: generación de texto y código (el más utilizado)/v1/chat/completionsconstream: true: transmisión en flujo conreasoning_content/v1/chat/completionscontools: llamada nativa a herramientas
Limitaciones de compatibilidad
Existen algunas diferencias menores:
- Los modelos disponibles son los de xAI (grok-build-0.1, grok-4.5, etc.), no los de OpenAI
- Es posible que algunos parámetros específicos de OpenAI (como
logprobs) no sean compatibles reasoning_contentes específico de la API de xAI y no existe en la API de OpenAI
Puntos clave
- La API de xAI se encuentra en
https://api.x.ai/v1y es compatible con el formato de OpenAI - Solo necesitas cambiar la URL base y la clave de API para migrar
- El SDK de Python de OpenAI funciona tal cual
- Obtén la clave de API en console.x.ai
- Todos los editores compatibles con OpenAI funcionan con xAI