API de Grok: claves, endpoints, modelos y una primera solicitud

Qué es la API de Grok

La API de Grok es la interfaz de pago para desarrolladores de SpaceXSI (antes xAI). Da a tu propio código acceso a la misma familia de modelos Grok que impulsa las apps de Grok, además de modelos de imagen, vídeo y voz. Pagas por token, por imagen, por segundo de vídeo o por minuto de audio.

La API es independiente de los planes para consumidores. La página de precios de The X Subscription incluye “Grok API access” en Plus, pero también dice que el uso de la API se factura aparte. SpaceXSI no explica cómo se combinan ambas cosas, así que cuenta con pagar las llamadas a la API con crédito de la consola.

Los casos de uso principales son los habituales: chat y razonamiento en tus propias apps, agentes que llaman a herramientas, comprensión de documentos e imágenes, y generación multimedia. Para una definición sencilla, consulta la entrada API de nuestro glosario.

Cómo conseguir una clave de la API de Grok

La guía rápida de SpaceXSI describe cuatro pasos:

1. Crea una cuenta en console.x.ai.
2. Carga crédito prepago. La documentación dice que se necesita crédito para que las llamadas funcionen.
3. Abre la página API Keys y genera una clave.
4. Guarda la clave como una variable de entorno llamada XAI_API_KEY, no en tu código fuente.

La facturación es prepago por defecto. Cuando se acaba el crédito, las solicitudes se rechazan. Puedes activar la recarga automática, que tiene un mínimo de $5. La facturación con factura está desactivada por defecto y hay que solicitarla al equipo de ventas de SpaceXSI.

URL base, SDK y endpoints

Todas las solicitudes van a la URL base https://api.x.ai/v1. La documentación indica tres formas de llamarla:

• xai_sdk, el SDK oficial para Python.
• El SDK de OpenAI (Python y JavaScript), apuntando a la URL base de xAI.
• El Vercel AI SDK, mediante el paquete @ai-sdk/xai.

Responses API o Chat Completions

La Responses API en /v1/responses es la interfaz principal de SpaceXSI. Chat Completions en /v1/chat/completions sigue siendo compatible. Con Grok 4.7, las llamadas a la Responses API siempre devuelven el razonamiento cifrado. El endpoint antiguo /v1/completions se sustituye por /v1/chat/completions.

Los endpoints de estilo Anthropic están obsoletos

Los endpoints compatibles con Anthropic /v1/messages y /v1/complete están marcados como obsoletos. SpaceXSI remite a los usuarios a la Responses API o a gRPC. No hay fecha de retirada, pero los proyectos nuevos no deberían basarse en ellos.

Endpoint regional de EE. UU.

Un endpoint de EE. UU. en https://us.api.x.ai/v1 mantiene la inferencia en Estados Unidos. Cuesta 1,1 veces las tarifas globales y solo sirve grok-4.7 y grok-4.6. Los detalles están en nuestra página de precios de la API de Grok.

Una primera solicitud mínima

Este ejemplo llama a la Responses API con curl. Da por hecho que tu clave está guardada en XAI_API_KEY:

curl https://api.x.ai/v1/responses -H "Authorization: Bearer $XAI_API_KEY" -H "Content-Type: application/json" -d '{"model": "grok-4.7", "input": "Explain a context window in one sentence."}'

Hay dos ajustes que conviene conocer desde el primer día:

• reasoning_effort: Grok 4.7 acepta low, medium, high (el valor predeterminado) o xhigh.
• prompt_cache_key (o la cabecera x-grok-conv-id): SpaceXSI recomienda encarecidamente configurarlo. Sin él, una solicitud puede llegar a un servidor con la caché fría y pagar el precio completo de entrada.

Los nombres de los campos pueden cambiar. Revisa la referencia de solicitudes en la documentación oficial antes de pasar a producción.

Modelos en la API de Grok

Estos son los modelos de texto actuales, con precios en USD por 1M de tokens. Los prompts de más de 200k tokens cuestan el doble.

Grok 4.7 Fast no está en la API pública. Solo se ofrece en Cursor y Grok Build. Varios modelos antiguos, como grok-3, grok-4-0709, Grok 4 Fast y grok-code-fast-1, se retiraron el 15 de mayo de 2026. Las llamadas a grok-code-fast-1 ahora se redirigen a grok-build-0.1.

La API también sirve los modelos de imagen y vídeo de Grok Imagine y los modelos de Grok Voice. Consulta Grok Imagine y la guía de la API de Grok Voice.

Herramientas integradas

Los modelos de Grok pueden llamar a herramientas del lado del servidor que SpaceXSI ejecuta por ti. La página de precios menciona:

• Web Search e Image Search.
• X Search, que devuelve publicaciones y perfiles de X.
• Code Execution.
• File attachment search y Collections Search para recuperar información de tus propios documentos.
• Las herramientas view_image, view_x_video y Remote MCP, que solo se cobran por tokens.

La mayoría de las herramientas se facturan por cada 1.000 llamadas, además del coste de los tokens. Cada modelo tiene también topes de solicitudes y tokens por nivel, que explicamos en nuestra página de límites de uso de la API de Grok.

Preguntas frecuentes