Ir al contenido principal
Español— Elegir un idioma
Menú

La URL base de la API

Lección 4 de 14 Actualizado el 30 de julio de 2026 Desarrollador
En esta página
  1. El punto de entrada de la API de Grok
  2. La URL base
  3. Compatibilidad con el ecosistema OpenAI
  4. Los endpoints principales
  5. Configuración de la URL en tus SDK
  6. Prueba de conectividad
  7. Límites y cuotas
  8. Puntos clave

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/v1 por https://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ágenes
  • POST /v1/images/edits: editar imágenes existentes
  • POST /v1/videos/generations: generar vídeos
  • POST /v1/tts: síntesis de voz (texto a voz)

Gestión de archivos

  • POST /v1/files: subir un archivo
  • GET /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/v1 para 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/completions sigue disponible por compatibilidad