La API de xAI para desarrolladores
En esta página
Integra Grok en tus aplicaciones
Todo lo que has aprendido a hacer en la interfaz de Grok puede activarse desde tu propio código. La API de xAI traslada esas capacidades a tus aplicaciones, sitios web y servicios: la conversación deja de ser un lugar al que acudes para convertirse en una función que tu producto invoca.
Prerrequisitos
Necesitas cuatro cosas antes de escribir tu primera línea de código:
- Una cuenta de xAI creada en accounts.x.ai
- Una clave de API generada en console.x.ai
- Un método de pago configurado (para superar la cuota gratuita)
- Un entorno de desarrollo en Python o JavaScript
Las dos primeras son tareas que ya has realizado en este curso: la cuenta gestiona la autenticación y la clave identifica tu aplicación ante la API. El método de pago solo entra en juego cuando tu uso supera la cuota gratuita, algo que ocurre más rápido de lo que crees en cuanto un servicio se ejecuta de forma continua. En cuanto al entorno, Python y JavaScript cuentan con las mejores herramientas, pero dado que la API utiliza HTTP, cualquier lenguaje capaz de enviar una solicitud servirá.
Configuración inicial
El primer paso es almacenar tu clave de API de forma segura, en una variable de entorno:
export XAI_API_KEY="xai-your-key-here"
Nunca incrustes tu clave directamente en el código fuente. La razón es sencilla: una clave escrita en un archivo acaba tarde o temprano en un repositorio de Git, y una clave subida a un repositorio público es explotada en minutos por bots que escanean los commits, mientras la factura sigue llegando a tu nombre.
A continuación, elige un SDK. El SDK nativo de xAI para Python se instala con pip install xai-sdk. Si tu código ya llama a OpenAI, la biblioteca openai funciona tal cual, gracias a la compatibilidad de formato. En el lado de JavaScript, añades el SDK de IA de Vercel con npm install ai @ai-sdk/xai, y se integra con aplicaciones React y Next.js.
Tu primera solicitud
Con el SDK nativo, crear el cliente y abrir una conversación requiere tres líneas:
from xai_sdk import Client
import os
client = Client(api_key=os.getenv("XAI_API_KEY"))
response = client.chat.create(model="grok-4.5")
La ruta compatible con OpenAI es igual de directa: solo cambia la base_url respecto al código existente, razón por la cual muchos equipos migran en pocos minutos.
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
response = client.responses.create(
model="grok-4.5",
input="Explícame el aprendizaje automático en 3 frases."
)
Para comprobar que una clave funciona antes incluso de escribir código, nada supera a una llamada desde la línea de comandos:
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.5",
"input": "Hola, ¿qué tal?"
}'
Qué expone la API
La base es la generación de texto (respuestas conversacionales, redacción, análisis), junto con un modo de razonamiento que resuelve problemas complejos paso a paso. A esto se suma la transmisión en flujo (streaming), que entrega la respuesta token a token en lugar de esperar a que finalice la generación.
Un segundo conjunto da acceso a información: búsqueda en tiempo real en la web y en X, y RAG, que consulta colecciones de documentos que hayas construido. La vertiente multimodal abarca la comprensión de imágenes que proporciones, la generación de imágenes y vídeos con grok-imagine, y la voz, con conversaciones habladas y síntesis de voz (TTS).
Por último, tres mecanismos hacen que la API sea programable en el sentido estricto: la llamada a funciones, que permite al modelo invocar tus propias funciones; las salidas estructuradas, que garantizan JSON utilizable sin un posprocesamiento frágil; y la ejecución de código en el servidor.
Elige tu modelo
El razonamiento varía según el modelo. grok-4.7, el modelo insignia, ofrece un razonamiento configurable: el parámetro reasoning_effort (low, medium, high o xhigh) establece la profundidad de su pensamiento, solicitud a solicitud. grok-4.3 sigue siendo la opción económica y de contexto muy largo, a aproximadamente la mitad de precio. Existen versiones de los modelos sin razonamiento para tareas simples: la reformulación o la clasificación no necesitan deliberación interna.
Las convenciones de nomenclatura afectan a la estabilidad de tu aplicación:
grok-4.20: la última versión estable recomendadagrok-4.20-latest: la versión más reciente (puede cambiar)grok-4.20-0309: una versión fijada a una fecha concreta (9 de marzo)
En producción, una versión fijada protege tus prompts de cambios silenciosos en el modelo; latest vale para la exploración, siempre que aceptes que el comportamiento pueda variar.
Límites de tasa y buenas prácticas
La API impone límites de tasa para mantener la estabilidad del servicio: en el nivel de entrada, unos 10 millones de tokens por minuto y 1.800 solicitudes por minuto para modelos como grok-4.3, y más a medida que subes de nivel. Los modelos de generación de imágenes y vídeo tienen sus propios límites, mucho más bajos, de 30 a 300 solicitudes por minuto dependiendo del modelo, así que vigílalos si ofreces un servicio de cara al consumidor.
Unos pocos hábitos marcan la diferencia entre un prototipo y una integración sólida. Activa la transmisión en flujo para respuestas largas, porque treinta segundos frente a una pantalla en blanco parecen una caída del servicio. Pasa un ID de conversación para beneficiarte del caché. Deriva cada tarea al modelo adecuado: grok-4.3 para volumen simple, grok-4.20 para razonamiento. Gestiona los errores con reintentos y retroceso exponencial, o un pico de tráfico se convertirá en una avalancha de solicitudes rechazadas. Y supervisa tu uso en la consola antes de descubrir la factura total a final de mes.
Puntos clave
- La API de xAI es compatible con el formato de OpenAI, lo que facilita la migración
- Hay varios SDK disponibles: el nativo de xAI, el de OpenAI y el SDK de IA de Vercel
- La API cubre texto, imágenes, vídeo, voz y búsqueda
- Dos niveles de modelos: grok-4.7 (insignia, razonamiento configurable) y grok-4.3 (económico, contexto de 1 M)
- Guarda siempre tu clave de API en una variable de entorno, nunca incrustada en el código