La URL base de la API
En esta página
El punto de entrada de la API de Grok
Todas las solicitudes a la API de xAI pasan por una única URL base. Es fundamental comprender esa URL y los endpoints disponibles antes de escribir tu primera línea de código.
La URL base
La API de Grok reside en esta dirección:
https://api.x.ai/v1
Esta URL es la raíz de todos los endpoints. Por ejemplo, para crear una respuesta, la URL completa es https://api.x.ai/v1/responses.
¿Por qué /v1?
El prefijo /v1 indica la versión de la API. El versionado permite a xAI evolucionar la API sin romper aplicaciones existentes. Si aparece una versión 2, coexistirá con la v1 durante un periodo de transición.
Compatibilidad con el ecosistema OpenAI
Una característica fundamental de la API de xAI es su compatibilidad con el formato de OpenAI. En la práctica, si ya tienes código que funciona con la API de OpenAI, solo necesitas cambiar dos ajustes para usar Grok:
- La URL base: sustituye
https://api.openai.com/v1porhttps://api.x.ai/v1 - La clave de API: sustituye tu clave de OpenAI por tu clave de xAI
Esa compatibilidad se extiende a la mayoría de herramientas y bibliotecas del ecosistema OpenAI: LangChain, LlamaIndex, LiteLLM y muchas otras funcionan con Grok sin cambios en el código.
Los endpoints principales
La API expone varios endpoints agrupados por funcionalidad.
Generación de texto
POST /v1/responses: el endpoint principal para generar respuestas (formato moderno)POST /v1/chat/completions: el endpoint compatible con OpenAI (formato heredado, aún soportado)
Generación de contenido multimedia
POST /v1/images/generations: generar imágenesPOST /v1/images/edits: editar imágenes existentesPOST /v1/videos/generations: generar vídeosPOST /v1/tts: síntesis de voz (texto a voz)
Gestión de archivos
POST /v1/files: subir un archivoGET /v1/files: listar archivos subidos
Tiempo real
wss://api.x.ai/v1/realtime: agente de voz sobre WebSocket
Configuración de la URL en tus SDK
Cuando usas un SDK compatible con OpenAI, debes especificar la URL base explícitamente:
from openai import OpenAI
client = OpenAI(
api_key="xai-your-key",
base_url="https://api.x.ai/v1"
)
Con el SDK nativo de xAI, la URL ya viene preconfigurada y no necesitas ajustar nada.
Prueba de conectividad
Antes de escribir cualquier código, una llamada directa valida toda la cadena (URL, clave, red):
curl https://api.x.ai/v1/models \
-H "Authorization: Bearer xai-your-key"
La respuesta enumera los modelos disponibles con tu clave. También es la forma más fiable de conocer los ID de modelo exactos disponibles en tu cuenta, sin depender de documentación que pueda cambiar. Mantén este hábito: valida cada nuevo entorno (máquina, CI, servidor) con esta misma llamada antes de cualquier despliegue.
Límites y cuotas
La API aplica límites de tasa para cada equipo y cada modelo. Si los superas, recibirás un error HTTP 429. La consola de xAI muestra tus cuotas actuales y tu uso en tiempo real.
Puntos clave
- La URL base es
https://api.x.ai/v1para todos los endpoints - La API es compatible con el formato de OpenAI: cambia la URL y la clave, y listo
- El endpoint principal de generación es
POST /v1/responses - El endpoint heredado
POST /v1/chat/completionssigue disponible por compatibilidad