Skip to main content
Referencia de API para xai/grok-imagine-video-1.5-preview, servida por Comfy Router desde xAI. Entrada: Texto, Imagen · Salida: Video

Inicio rápido

Crea una clave en tu espacio de trabajo de Comfy y expórtala como COMFY_API_KEY. Los fragmentos de Python y TypeScript usan los SDK de Comfy (pip install comfy-sdk y npm install @comfyorg/sdk); el fragmento de cURL es la misma llamada sobre HTTP sin procesar. ID del modelo: xai/grok-imagine-video-1.5-preview Endpoint: POST https://api.comfy.org/v2/models/xai/grok-imagine-video-1.5-preview
El mismo cuerpo, enviado a POST https://api.comfy.org/v2/models/xai/grok-imagine-video-1.5-preview/requests. Router responde 201 con un request_id en cuanto se admite la ejecución, y el resultado se recopila cuando está listo, desde este proceso o desde otro. Entrega en cola explica el estado, la cancelación y la recopilación.

Esquema

Entrada

string
predeterminado:"\"16:9\""
Relación de aspecto del video generadoValores posibles: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3
integer
predeterminado:"8"
Duración del video en segundos. Rango [1, 15]. Predeterminado 8.Rango: 1 a 15
object
Objeto de imagen de entrada para los endpoints de xAI
string
Tipo de la entrada de imagenValores posibles: image_url
string
requerido
URL de la imagen de entrada (URL pública o URI de datos codificada en base64)
string
Modelo que se va a usar. Compatibles: grok-imagine-video (predeterminado), grok-imagine-video-1.5-preview, grok-imagine-video-1.5, grok-imagine-video-1.5-lite. El id obsoleto grok-imagine-video-beta es un alias de grok-imagine-video.
object
Destino de salida opcional para el video generado
string
requerido
Prompt para la generación del video. Máximo 4,096 caracteres.
object[]
Una o más imágenes de referencia para guiar la generación del video (modo referencia a video). Son mutuamente excluyentes con image. Router solo reenvía application/json y ni este objeto ni XAIImageObject aceptan un file_id, así que las entradas de imagen respaldadas por archivos no son compatibles en esta ruta.
string
requerido
URL de la imagen de referencia. Admite URL HTTPS (públicas) o URL de datos codificadas en base64 (por ejemplo, data:image/jpeg;base64,…).
string
Resolución del video de salida
string
Tamaño del video de salida
string
Un identificador único que representa a tu usuario final
Generado a partir del esquema que Router sirve en GET /v2/models/xai/grok-imagine-video-1.5-preview/openapi.json, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor.

Salida

string
Nunca lleva un motivo en este documento: un motivo de bloqueo no vacío es un rechazo por moderación de la entrada, que Router responde como un error de Comfy Router en lugar de con este cuerpo. Aquí está ausente, es null o está vacío.
string
El modelo usado para generar el video
string
Ausente o done en este documento. pending es el cuerpo de un sondeo que Router no ha finalizado y nunca se devuelve como un 200; Router acepta un estado faltante cuando video.url está poblado, así que quien llama no debe exigirlo.Valores posibles: done
object
Información de uso de la solicitud de generación de video
integer
El costo de esta solicitud expresado en ticks de USD. Un centavo de dólar equivale a 100,000,000 ticks, así que un dólar estadounidense equivale a 10,000,000,000 ticks.
object
requerido
La generación finalizada. Requerido aquí, a diferencia del documento de sondeo: un resultado terminal sin video.url se responde como un error de Comfy Router, así que un 200 siempre lo incluye.
integer
Duración del video generado en segundos
boolean
Indica si el video generado por el modelo respeta las reglas de moderación
string
requerido
No vacío en este documento. Router informa éxito solo cuando este campo está poblado; es la URL realojada y firmada por Comfy descrita arriba, o la propia URL de corta duración de xAI cuando no se pudo realizar el realojamiento.

Ejemplos

Entrada

Salida

Antes de lanzar

Los SDK crean una Idempotency-Key y la reutilizan para los reintentos automáticos. Para los reintentos manuales, reutiliza la clave original. Router puede mantener la conexión abierta hasta 10 minutos. Cuando una solicitud falla, Router envía un encabezado de respuesta X-Comfy-Error-Type que explica el motivo. Un 422 significa que Router rechazó la entrada antes de llamar al proveedor, y un 413 significa que el cuerpo de la solicitud era más grande de lo que Router acepta. Descarga los recursos generados de inmediato, porque las URL de resultados pueden caducar. Cualquier límite de tamaño mencionado en la descripción de un campo más arriba es el límite propio del proveedor para ese campo, citado de la especificación del proveedor. Router aplica un tope aparte al cuerpo completo de la solicitud, con el que cuentan los medios codificados en base64: consulta tamaño del cuerpo de la solicitud. Esta página documenta un modelo socio al que se llama a través de Comfy Router. El mismo paquete comfy-sdk / @comfyorg/sdk también incluye un segundo cliente, para ejecutar todo un gráfico de flujo de trabajo de ComfyUI en Comfy Cloud: Comfy(api_key=...) / new Comfy({ apiKey }), con client.workflows, client.assets y client.jobs. Consulta SDK de Comfy.

Encabezados

Autenticación, idempotencia, IDs de solicitud, agrupaciones de errores, ritmo de reintentos y límites de gasto.

Uso de la API de Router

Descubrimiento de modelos, errores de validación, reintentos y facturación.

Limitaciones

Lo que Router no hace hoy y qué usar en su lugar.