Ir al contenido principal
Español— Elegir un idioma
Menú

API de xAI y compatibilidad con OpenAI

Lección 4 de 14 Actualizado el 29 de julio de 2026 Desarrollador
En esta página
  1. Una API familiar
  2. Configuración mínima
  3. Obtención de una clave de API
  4. Endpoints disponibles
  5. Limitaciones de compatibilidad
  6. Puntos clave

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:

  1. URL base: sustituye https://api.openai.com/v1 por https://api.x.ai/v1
  2. 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

  1. Ve a console.x.ai
  2. Inicia sesión con tu cuenta de xAI (o crea una en accounts.x.ai)
  3. En la sección API Keys, genera una nueva clave
  4. 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/completions con stream: true: transmisión en flujo con reasoning_content
  • /v1/chat/completions con tools: 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_content es 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/v1 y 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