API de Grok: integración directa en tu código

Dos formas de usar Grok desde tu código

Los desarrolladores pueden llamar a los modelos de Grok principalmente de dos maneras. La primera es la API de xAI, gestionada por la propia empresa (ahora bajo la marca SpaceXSI), con claves que obtienes en console.x.ai. La segunda es mediante un router de modelos como OpenRouter, que reúne los modelos de muchos proveedores bajo una sola clave y una única factura. Ambas opciones aceptan solicitudes con el formato Chat Completions de OpenAI, por lo que los SDK oficiales de OpenAI funcionan directamente una vez que cambias la dirección base y el nombre del modelo.

Qué opción elegir

• API de xAI si quieres tener acceso prioritario a todas las funciones de Grok: la lista completa de modelos, la Responses API, herramientas de búsqueda web y en X desde el servidor, generación de imágenes y video con Grok Imagine, voz, tareas por lotes (batch) y descuentos por prompts en caché. URL base: https://api.x.ai/v1.
• OpenRouter si quieres alternar entre Grok y modelos de otras empresas sin contratos adicionales, o si ya tienes una cuenta en OpenRouter. URL base: https://openrouter.ai/api/v1, con identificadores de modelo precedidos por x-ai/. Puedes ver la configuración en la guía de inicio rápido de OpenRouter.

En cualquier caso, mantén tu clave en un servidor o en una variable de entorno. Nunca la incluyas dentro del código de una página web o app móvil, donde cualquiera pueda verla.

Tu primera solicitud a la API de xAI

Crea una clave en la consola, guárdala como XAI_API_KEY y envía un mensaje a Grok 4.7:

curl

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "reasoning_effort": "low",
    "messages": [
      {"role": "system", "content": "Eres un asistente conciso."},
      {"role": "user", "content": "Dame tres consejos para mi primer maratón."}
    ]
  }'

Python, con la librería de OpenAI

import os
from openai import OpenAI

grok = OpenAI(
    api_key=os.environ["XAI_API_KEY"],
    base_url="https://api.x.ai/v1",
)

answer = grok.chat.completions.create(
    model="grok-4.3",
    reasoning_effort="medium",
    messages=[{"role": "user", "content": "¿Es 391 un número primo? Muestra tu comprobación."}],
)
print(answer.choices[0].message.content)

reasoning_effort controla cuánto tiempo piensa el modelo antes de responder. Grok 4.3 acepta none, low, medium, high y xhigh, y usa low por defecto; Grok 4.7 acepta low, medium, high y xhigh, y usa high por defecto. Para Grok 4.20, xAI publica identificadores independientes: grok-4.20-0309-reasoning y grok-4.20-0309-non-reasoning.

Lo mismo a través de OpenRouter

En OpenRouter, guarda la clave en OPENROUTER_API_KEY y usa los identificadores con el prefijo x-ai/. OpenRouter controla el razonamiento mediante un objeto reasoning. Este código en JavaScript funciona en Node.js 18 o superior:

const endpoint = "https://openrouter.ai/api/v1/chat/completions";

const reply = await fetch(endpoint, {
  headers: {
    Authorization: `Bearer ${process.env.OPENROUTER_API_KEY}`,
    "Content-Type": "application/json",
  },
  method: "POST",
  body: JSON.stringify({
    model: "x-ai/grok-4.20",
    reasoning: { enabled: false },
    stream: false,
    messages: [{ role: "user", content: "Reescribe este titular con un tono más tranquilo: ¡LOS PRECIOS VUELVEN A DISPARARSE!" }],
  }),
});
const json = await reply.json();
console.log(json.choices[0].message.content);

Si quieres que el modelo razone, envía reasoning: { effort: "low" } (o medium, high). Agrega exclude: true si prefieres que use el razonamiento para generar la respuesta pero sin incluirlo en el resultado. Usa stream: true para recibir la respuesta a medida que se genera, lo que da una sensación mucho más fluida en interfaces de chat.

Cómo enviar una imagen

Grok 4.20, 4.3 y 4.7 pueden analizar imágenes. Usa el formato de mensaje tipo OpenAI con una lista de partes. La documentación de xAI admite imágenes JPEG y PNG de hasta 20 MiB; puedes pasar una URL pública o una URL en formato base64.

{
  "model": "grok-4.20-0309-non-reasoning",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "image_url", "image_url": {"url": "https://example.com/receipt.png"}},
      {"type": "text", "text": "Enumera los artículos y el total de este recibo."}
    ]
  }]
}

Identificadores de modelos Grok y precios

Estos son los modelos de texto actuales que OpenRouter lista para SpaceXAI, junto con el tamaño de contexto y los precios por millón de tokens (tarifas de lista de OpenRouter, oct. de 2026). La API de xAI cobra las mismas tarifas base para prompts de menos de 200,000 tokens.

Algunos detalles clave de la página de modelos y precios de xAI (precios de lista de xAI, oct. de 2026):

• Los prompts largos cuestan más. Cuando un prompt alcanza los 200,000 tokens, toda la solicitud se factura con una tarifa superior: $4 / $12 para Grok 4.7, y $2.50 / $5 para Grok 4.3 y 4.20.
• Las entradas en caché son más baratas: $0.50 por millón para Grok 4.7 y $0.20 para Grok 4.3 y 4.20, en prefijos de prompt repetidos.
• Procesamiento por lotes (batch): las tareas que pueden esperar tienen descuento; OpenRouter también lista x-ai/grok-4.3:batch a $1 / $2.
• El contexto varía según la plataforma: OpenRouter indica 2,000,000 de tokens para Grok 4.20, mientras que la propia página de xAI especifica 1,000,000.

Los tokens de razonamiento cuentan como tokens de salida, por lo que un modelo con razonamiento puede costar más por respuesta de lo que sugiere su precio básico por token.

Consejos prácticos

• Empieza con Grok 4.20 non-reasoning para chats, reescritura de textos y extracción de datos. Es rápido y económico. Pasa a Grok 4.3 o 4.7 cuando la calidad en tareas complejas sea más importante que la velocidad.
• Ten en cuenta la fecha límite de conocimiento. Según xAI, Grok 4.7 conoce eventos hasta mayo de 2026. Para temas más recientes, incluye los datos directamente en tu prompt o usa las herramientas de búsqueda web y en X de xAI, que se facturan por llamada.
• Define un mensaje de sistema claro con el rol, el tono y el formato de salida deseados, y solicita respuestas en JSON con un esquema definido si tu código necesita procesarlas automáticamente.
• Gestiona los límites de velocidad (rate limits). Si recibes un error 429, implementa reintentos con una breve pausa.
• Cumple con las políticas. El uso de la API está sujeto a la política de uso aceptable de xAI; además, el campo safety_identifier te permite etiquetar solicitudes por usuario final.

Resolución de problemas comunes

• Error 401 o 403: la clave no existe, fue revocada o se cargó en el entorno incorrecto. Imprime sus primeros caracteres en el servidor para verificar que esté disponible.
• Model not found (modelo no encontrado): revisa el prefijo. OpenRouter requiere x-ai/grok-4.7, mientras que xAI usa simplemente grok-4.7.
• Respuestas vacías o muy lentas en modelos de razonamiento: suelen indicar que el modelo agotó su presupuesto de salida pensando. Reduce el esfuerzo de razonamiento o aumenta max_tokens.
• Imagen rechazada: conviértela a JPEG o PNG y asegúrate de que no supere el límite de tamaño.

Preguntas frecuentes

¿La API de Grok es compatible con el SDK de OpenAI?

Sí. Solo debes apuntar el SDK a https://api.x.ai/v1 con tu clave de xAI, o a OpenRouter con tu clave de OpenRouter, e indicar el ID del modelo Grok correspondiente.

¿Existe una API gratuita de Grok?

No hay un plan gratuito permanente. Tanto xAI como OpenRouter cobran por token consumido, aunque hacer pruebas breves cuesta muy poco.

¿Puedo generar imágenes con la API de Grok?

Sí, a través de los modelos Grok Imagine de xAI en un endpoint específico para imágenes. Consulta nuestra página sobre Grok Imagine. Nuestro chat no genera imágenes.

¿Qué modelo de Grok utiliza Grok.Online?

Nuestro chat ofrece Grok 4.20 sin razonamiento, Grok 4.3 con esfuerzo de razonamiento bajo y Grok 4.7 con un límite de hasta 10 mensajes al día, todo conectado a través de OpenRouter.