Cómo usar la API de Grok 4.7: guía paso a paso con curl, Python y JavaScript

Crea una clave de la API de xAI y envía tu primera solicitud a Grok 4.7. Después añade nivel de razonamiento, preguntas de seguimiento, búsqueda web, control de costos y pautas de contenido.

Graphic of a terminal window sending a request to a cloud and getting a reply, for a guide to the Grok 4.7 API

Grok 4.7 es el modelo más nuevo y potente de la API de xAI, y puedes llamarlo desde una terminal o un script corto en pocos minutos. Esta guía te lleva paso a paso: crear una clave, enviar una primera solicitud con curl, Python y JavaScript y luego usar las funciones que querrás después: nivel de razonamiento, preguntas de seguimiento, búsqueda web en vivo, control de costos y las nuevas pautas de contenido. Los comandos siguen la documentación oficial en docs.x.ai, revisada el 15 de noviembre de 2026.

Puntos clave

  • Grok 4.7 es el modelo más potente de la API de xAI, con una ventana de contexto de 500.000 tokens.
  • Crea una clave en console.x.ai, guárdala como XAI_API_KEY y llama a la Responses API con curl o con el SDK de OpenAI.
  • Ajusta el nivel de razonamiento de low a xhigh, continúa chats con previous_response_id y añade la herramienta web_search para obtener respuestas actuales.
  • Cada respuesta indica su precio exacto en cost_in_usd_ticks, y las pautas opcionales rechazan nsfw, violence o profanity.

Una nota sobre el nombre: la documentación ahora llama a la empresa SpaceXSI, pero el servicio sigue siendo «the xAI API», la dirección sigue siendo api.x.ai y la variable de la clave sigue siendo XAI_API_KEY.

Qué necesitas

  • Una cuenta en console.x.ai con créditos cargados. La guía de inicio rápido indica que cargues créditos antes de usar la API.
  • Una terminal con curl. Con eso basta para toda la guía.
  • Opcional: Python con pip, o Node.js con npm, si quieres llamar a la API desde código.

Grok 4.7 de un vistazo

Estos datos provienen de la página de Grok 4.7 y de la página de precios a fecha del 15 de noviembre de 2026. Los precios cambian, así que revísalos antes de hacer un presupuesto.

CaracterísticaValor
Nombre del modelogrok-4.7
Ventana de contexto500.000 tokens
Fecha de corte del conocimientoMayo de 2026
EntradaTexto e imágenes
SalidaTexto
Precio, prompts de menos de 200k tokens2,00 US$ de entrada, 0,50 US$ de entrada en caché, 6,00 US$ de salida por cada millón de tokens
Precio, prompts de 200k tokens o más4,00 US$ de entrada, 1,00 US$ de entrada en caché, 12,00 US$ de salida por cada millón de tokens
Nivel de razonamientolow, medium, high (predeterminado) o xhigh

En cifras

500.000 tokensventana de contexto

2,00 US$de entrada por millón de tokens, menos de 200k

6,00 US$de salida por millón de tokens, menos de 200k

Paso 1: Crea una clave de API

  1. Inicia sesión en console.x.ai y añade créditos.
  2. Abre la página API Keys y crea una clave.
  3. Guárdala en una variable de entorno para que nunca quede en tu código:
Terminal
export XAI_API_KEY="your_api_key"

En Windows PowerShell, usa en su lugar $env:XAI_API_KEY="your_api_key". Trata la clave como una contraseña. No la pegues en documentos compartidos ni la subas a un repositorio.

Paso 2: Envía tu primera solicitud con curl

La documentación recomienda la Responses API, en https://api.x.ai/v1/responses. Este es el ejemplo de la guía de inicio rápido:

Terminal
curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "input": "Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}"
  }'

Resultado esperado: un objeto JSON. La respuesta está dentro de la lista output, en un elemento de tipo message cuyo contenido es de tipo output_text. El mismo objeto tiene un id (lo usarás en el paso 5) y un bloque usage con el recuento de tokens.

Diagrama de flujo desde cargar créditos de xAI y crear una clave de API hasta leer la primera respuesta de Grok 4.7

Paso 3: Llámalo desde Python o JavaScript

La API funciona con los SDK de OpenAI si los apuntas a la URL base de xAI. Instala uno:

Terminal
pip install openai
Terminal
npm install openai

Python:

Código
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1",
)

response = client.responses.create(
    model="grok-4.7",
    input="Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}",
)

print(response.output_text)

JavaScript (guárdalo como archivo .mjs para que import y await de nivel superior funcionen en Node.js):

Código
import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.XAI_API_KEY,
  baseURL: 'https://api.x.ai/v1',
});

const response = await client.responses.create({
  model: 'grok-4.7',
  input: 'Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}',
});

console.log(response.output_text);

Ambos imprimen solo el texto del modelo. xAI también tiene su propio paquete de Python (pip install xai-sdk), y la documentación dice que no hay problema en combinar los dos.

Paso 4: Elige cuánto piensa el modelo

Grok 4.7 siempre razona antes de responder. No puedes desactivarlo, pero la guía de razonamiento te permite fijar el esfuerzo. El valor predeterminado es high. Usa low para llamadas rápidas y sencillas y xhigh para los problemas más difíciles, cuando una respuesta más lenta es aceptable.

Terminal
curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -m 3600 \
  -d '{
    "model": "grok-4.7",
    "reasoning": {"effort": "low"},
    "input": "Summarise the difference between TCP and UDP in three bullet points."
  }'

La opción -m 3600 deja que la solicitud dure hasta una hora antes de que curl se rinda. La documentación la usa en sus ejemplos de razonamiento porque el razonamiento profundo puede tardar. En Python, el mismo ajuste es reasoning={"effort": "low"}.

Escala de los niveles de razonamiento de Grok 4.7, de low a xhigh, con high marcado como predeterminado

Paso 5: Haz una pregunta de seguimiento sin reenviar el chat

Por defecto, la Responses API guarda cada intercambio en los servidores de xAI durante 30 días, según la guía de generación de texto. Así puedes continuar una conversación pasando el id de la respuesta anterior:

Terminal
curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -m 3600 \
  -d '{
    "model": "grok-4.7",
    "previous_response_id": "The previous response ID",
    "input": [
        {
            "role": "user",
            "content": "How do stars form?"
        }
    ]
}'

Sustituye el marcador por el id de tu respuesta anterior. Si prefieres que no se guarden las solicitudes, añade "store": false a la solicitud y guarda tú mismo el historial.

¿Sabías que…?

Por defecto, la Responses API guarda cada intercambio en los servidores de xAI durante 30 días. Añade «store»: false a una solicitud si prefieres guardar tú mismo el historial de la conversación.

Paso 6: Deja que Grok busque en la web

La página de modelos lo dice sin rodeos: sin herramientas de búsqueda, Grok no sabe nada más allá de sus datos de entrenamiento. Para obtener respuestas actuales, añade la herramienta de búsqueda web:

Terminal
curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
  "model": "grok-4.7",
  "input": [
    {
      "role": "user",
      "content": "What were the main technology headlines this week?"
    }
  ],
  "tools": [
    {
      "type": "web_search"
    }
  ]
}'

Grok decide cuántas búsquedas hace. A 15 de noviembre de 2026, la búsqueda web cuesta 5 US$ por cada 1.000 llamadas, además del cobro normal por tokens, así que un prompt con mucha investigación cuesta más que uno simple.

Paso 7: Mira cuánto costó cada solicitud

Cada respuesta indica su precio exacto en un campo llamado cost_in_usd_ticks, descrito en la guía de control de costos. Un dólar estadounidense equivale a 10.000.000.000 ticks. Si tienes jq instalado, esto muestra la cifra de una sola llamada:

Terminal
curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "input": "Say hello"
  }' | jq '.usage.cost_in_usd_ticks'

Divide el resultado entre 10.000.000.000 para obtener dólares. El ejemplo de la propia documentación: 37756000 ticks son unos 0,0038 US$.

¿Sabías que…?

xAI cobra las solicitudes en ticks: un dólar estadounidense equivale a 10.000.000.000 ticks. El ejemplo de la documentación de 37756000 ticks sale a unos 0,0038 US$.

Paso 8 (opcional): Añade pautas de contenido

En octubre de 2026, xAI añadió controles de moderación personalizados. Adjuntas una lista guidelines a una solicitud y Grok rechaza ese tipo de contenido mientras escribe. Hay tres categorías, nsfw, violence y profanity, y el único comportamiento disponible hoy es decline.

Terminal
curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "input": "Write a short story about a knight.",
    "guidelines": [
      { "type": "policy", "category": "violence", "behavior": "decline" },
      { "type": "policy", "category": "nsfw", "behavior": "decline" }
    ]
  }'

Las pautas solo se aplican a la solicitud que las incluye, así que envíalas cada vez. Con el SDK de OpenAI para Python, pasa la lista dentro de extra_body, porque ese SDK no tiene un parámetro guidelines propio.

Errores comunes y soluciones

Los códigos de estado de abajo provienen de la página de depuración de xAI y de las guías enlazadas arriba.

Lo que vesCausa probableSolución
401 UnauthorizedFalta el encabezado de autorización o la clave no es válidaEnvía Authorization: Bearer <your key> y comprueba que la variable está definida con echo $XAI_API_KEY
400 Bad RequestUn argumento no válido en el cuerpo o la URL, o una clave de API incorrectaRevisa el JSON, la dirección del endpoint y la clave
403 ForbiddenTu clave o tu equipo no tienen permiso, o están bloqueadosPide permiso al administrador de tu equipo
404 Not FoundNo se encontró el modelo de la solicitud, o la URL está mal escritaRevisa la ortografía grok-4.7 y la dirección del endpoint
415 Unsupported Media TypeCuerpo vacío, o falta el encabezado Content-Type: application/jsonAñade el encabezado y un cuerpo válido
422 Unprocessable EntityUn campo tiene un formato no válido, por ejemplo una categoría de guidelines desconocidaCompara el campo con la documentación. En el caso de las pautas, el error enumera los valores válidos
429 Too Many RequestsAlcanzaste un límite de frecuenciaVe más despacio y vuelve a intentarlo con una espera creciente. Los límites suben automáticamente con el gasto total de tu equipo
Error al configurar stop, una penalización de presencia o una penalización de frecuenciaLos modelos de razonamiento no los aceptanElimínalos
La solicitud agota el tiempo de esperaEl razonamiento tardó más de lo que permite tu clienteAumenta el tiempo de espera de tu cliente (los ejemplos de la documentación usan 3.600 segundos) o baja el nivel de razonamiento

Si todo falla a la vez, revisa status.x.ai antes de depurar tu propio código.

Conclusión

Ya tienes una clave que funciona, una primera solicitud y cinco ajustes que la mayoría de los proyectos necesitan: nivel de razonamiento, conversaciones guardadas, búsqueda web, costo por solicitud y pautas de contenido. La documentación también cubre streaming, salidas estructuradas, subida de archivos y llamadas a funciones.

Si estás comparando proveedores, nuestra guía de la API de Gemini 4 Hydrogen sigue los mismos pasos para el modelo de Google. Si prefieres tenerlo todo en tu propio equipo, mira cómo ejecutar un modelo en local con Ollama. Y si quieres a Grok en tus llamadas en lugar de en tu código, aquí tienes cómo añadir Grok a Zoom, Google Meet o Teams.

Preguntas frecuentes

¿Cuánto cuesta la API de Grok 4.7?

Para prompts de menos de 200k tokens, 2,00 US$ de entrada, 0,50 US$ de entrada en caché y 6,00 US$ de salida por cada millón de tokens. Los prompts de 200k tokens o más cuestan el doble. La búsqueda web suma 5 US$ por cada 1.000 llamadas. Precios a 15 de noviembre de 2026.

¿Puedo usar el SDK de OpenAI con la API de Grok?

Sí. Apunta el SDK de OpenAI para Python o JavaScript a la URL base https://api.x.ai/v1 con tu XAI_API_KEY y llama a responses.create con el modelo grok-4.7. xAI también tiene su propio paquete xai-sdk, y la documentación dice que combinarlos no es problema.

¿Por qué mi solicitud a la API de Grok agota el tiempo de espera?

Grok 4.7 siempre razona antes de responder, y el razonamiento profundo puede tardar. Aumenta el tiempo de espera de tu cliente (los ejemplos de la documentación usan 3.600 segundos) o baja el nivel de razonamiento.

¿Se puede desactivar el razonamiento en Grok 4.7?

No. Grok 4.7 siempre razona antes de responder. Solo puedes fijar el esfuerzo en low, medium, high o xhigh, y high es el predeterminado.

Test rápido

¿Cuál es el nivel de razonamiento predeterminado de Grok 4.7?

  • low (bajo)
  • medium (medio)
  • high (alto)

La guía de razonamiento fija high como valor predeterminado.

¿Cuántos ticks hacen un dólar estadounidense?

  • 10,000,000,000
  • 1,000,000
  • 37,756,000

La guía de control de costos dice que un dólar estadounidense equivale a 10.000.000.000 ticks.

¿Qué suele significar un error 401 Unauthorized?

  • Alcanzaste un límite de frecuencia
  • Falta un encabezado o la clave no es válida
  • El nombre del modelo está mal escrito

La página de depuración de xAI señala como causa la falta del encabezado de autorización o una clave no válida.

Fuentes

Enlaces revisados por última vez el 15 de noviembre de 2026.

Escrito por Mindloop Editorial

The Mindloop Experience editorial team writes clear, carefully sourced explainers and how-tos on tech, science, money and culture, for anyone who likes to know how things actually work.

Acerca de Mindloop Experience

Respuestas

Escribe una respuesta

Más de Mindloop Experience

Ver todo de Mindloop Experience

Puedes aplaudir hasta 50 veces.