xai/grok-imagine-video, 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 comoCOMFY_API_KEY. Los snippets de Python y TypeScript usan los SDK de Comfy (pip install comfy-sdk y npm install @comfyorg/sdk); el snippet de cURL es la misma llamada por HTTP directo.
ID del modelo: xai/grok-imagine-video
Endpoint: POST https://api.comfy.org/v2/models/xai/grok-imagine-video
- Esperar el resultado
- Encolar y recoger más tarde
El mismo cuerpo, enviado a
POST https://api.comfy.org/v2/models/xai/grok-imagine-video/requests. Router responde 201 con un request_id en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso u otro. Entrega en cola explica el estado, la cancelación y la recogida.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:3integer
predeterminado:"8"
Duración del video en segundos. Rango [1, 15]. Valor predeterminado 8.Rango:
1 a 15object
Objeto de imagen de entrada para los endpoints de xAI
string
Tipo de la entrada de imagenValores posibles:
image_urlstring
requerido
URL de la imagen de entrada (URL pública o URI de datos codificado 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 generar el 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). Es mutuamente excluyente con image. Router reenvía solo application/json y ni este objeto ni XAIImageObject aceptan un file_id, así que las entradas de imagen respaldadas por archivo no son compatibles en esta ruta.
string
requerido
URL de la imagen de referencia. Admite URL HTTPS (públicas) o URL de datos codificados 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
GET /v2/models/xai/grok-imagine-video/openapi.json, el mismo documento contra 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 una denegación por moderación de entrada, que Router responde como un error de Comfy Router en lugar de con este cuerpo. Ausente, null o vacío aquí.
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 terminado y nunca se devuelve como un 200; Router acepta un status faltante cuando video.url está poblado, así que quien llama no debe exigirlo.Valores posibles: doneobject
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 USD 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. Es 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 re-alojada y firmada por Comfy descrita arriba, o la propia URL de corta duración de xAI cuando no se pudo realizar el re-alojamiento.
Ejemplos
Entrada
Salida
Antes de lanzar
Los SDK crean unaIdempotency-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.