Endpoints compatibles con lotes
En esta página
Actualizado el 2 de noviembre de 2026, según la documentación de xAI: el descuento por lotes es del 20 % en modelos de texto elegibles (no del 50 %), los ejemplos siguen la API REST y el
xai-sdkoficial (client.batch.*; la API de lotes de xAI no utiliza el formato de OpenAI, por lo que el SDK de OpenAI no es aplicable), y la API de Responses tiene prioridad sobre Chat Completions, un endpoint heredado en xAI. Fuentes: API de lotes · Referencia REST · Precios de lotes.
Siete endpoints, un único flujo de trabajo
La API de lotes no se limita a la generación de texto. Acepta siete endpoints que cubren texto, imágenes y vídeo, y puedes combinarlos en un único lote para construir pipelines multimodales completos en una sola operación.
Endpoints de texto
/v1/responses — La API de Responses, la que xAI recomienda. Te da acceso a herramientas del lado del servidor (búsqueda web, búsqueda en X, ejecución de código, MCP), llamadas a funciones y salidas estructuradas, y es la primera en recibir nuevas funcionalidades.
/v1/chat/completions — El endpoint de completado original, en el formato de OpenAI. xAI lo mantiene como un endpoint heredado: sigue siendo útil para código existente escrito para él, pero es preferible que un nuevo pipeline comience con Responses.
En los modelos elegibles, el descuento por lotes del 20 % se aplica a ambos endpoints, en todos los tipos de tokens.
Endpoints de imagen
/v1/images/generations — Genera imágenes a partir de un prompt. Los parámetros que utilizarás son aspect_ratio (por ejemplo, "16:9"), resolution ("1k", "1.5k" o "2k"), n para el número de imágenes y response_format ("url" o "b64_json").
/v1/images/edits — Edita una imagen existente, especificada mediante un objeto image que contiene una url (una dirección pública o datos codificados en base64) o el file_id de un archivo subido. Útil para ejecutar transformaciones en serie sobre un catálogo visual.
Las imágenes se facturan a la tarifa estándar, sin descuento por lotes: aquí el valor del procesamiento por lotes es operativo, no financiero.
Endpoints de vídeo
/v1/videos/generations (o /v1/videos) — Genera vídeos a partir de un prompt, con una duración de 1 a 15 segundos (duration, 8 por defecto), en 480p, 720p o 1080p.
/v1/videos/edits — Edita un vídeo existente, pasado en un objeto video (la URL de un archivo .mp4 o un file_id).
/v1/videos/extensions — Amplía un vídeo con un nuevo segmento de 2 a 10 segundos.
Al igual que con las imágenes, los precios del vídeo se mantienen en la tarifa estándar en modo por lotes. Los resultados de imágenes y vídeo se devuelven como URLs firmadas que caducan al cabo de una hora.
Combinación de endpoints en un lote
En un archivo JSONL, cada línea indica su endpoint en el campo url:
{"custom_id": "text-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Resume este artículo: ..."}]}}
{"custom_id": "img-1", "method": "POST", "url": "/v1/images/generations", "body": {"model": "grok-imagine-image-2.0", "prompt": "Logotipo minimalista para una librería de barrio"}}
De este modo, podrías generar las descripciones de tus productos y sus elementos visuales en el mismo lote.
Elección del endpoint adecuado
- Responses: la opción por defecto, esencial en cuanto necesitas herramientas del lado del servidor, salidas estructuradas o las funcionalidades más recientes.
- Chat Completions: continuidad para código ya escrito en el formato de Chat Completions, y nada más.
- Imágenes y vídeo: para producir elementos visuales en serie, teniendo en cuenta que no obtienen descuento.
Puntos clave
- Se aceptan siete endpoints: dos para texto, dos para imágenes y tres para vídeo.
- Responses es el endpoint recomendado; Chat Completions es un endpoint heredado en xAI.
- Solo los tokens en modelos de texto elegibles obtienen el descuento del 20 %.
- El campo
urlde cada línea JSONL determina el endpoint de destino, y los endpoints pueden mezclarse dentro de un lote. - Los resultados de imágenes y vídeo son URLs firmadas válidas durante una hora.