Grok Imagine Video 1.5

Genera con Grok Imagine Video 1.5 clips de 6 a 15 segundos con sonido a partir de un prompt o una imagen, en 480p o 720p, facturados por segundo y entregados como tarea.

Grok Imagine Video 1.5 es el modelo de vídeo de xAI. Una sola solicitud crea un clip de 6 a 15 segundos con sonido a partir de un prompt, o de un prompt más una imagen, en 480p o 720p y en 16:9, 9:16 o 1:1. Envía la solicitud, guarda el identificador de tarea devuelto y lee el vídeo terminado desde la tarea. Las imágenes se envían como URL.

ID de modelo

ID de modelo	Entradas	Resoluciones	Duración
`grok-imagine-video-1-5`	texto, una imagen	`480p`, `720p`	De 6 a 15 segundos

Consulta la página del modelo para ver los precios actuales.

Ejemplo rápido

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1-5",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in, birdsong. No text, no logos.",
    "resolution": "480p",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'

Endpoint

POST https://api.seedrouter.ai/v1/videos/generations

Encabezado	Valor
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

La respuesta es una tarea ({"id": "task_...", "status": "processing"}), no el vídeo terminado. Consulta GET /v1/tasks/{task_id} para obtener el resultado. Guarda las claves de API en código del lado del servidor.

Parámetros

Campo	Tipo	Por defecto	Notas
`model`	cadena	obligatorio	`grok-imagine-video-1-5`
`prompt`	cadena	obligatorio	Hasta 10.000 caracteres. También es obligatorio con una imagen.
`image_urls`	lista de URL	ninguno	Como máximo una imagen. Con ella, el clip es de imagen a vídeo; sin ella, de texto a vídeo.
`resolution`	enumeración	`480p`	`480p` o `720p`.
`duration`	entero	`8`	De 6 a 15 segundos.
`aspect_ratio`	enumeración	`16:9`	`16:9`, `9:16` o `1:1`. Con una imagen, el clip sigue la forma de la imagen.
`audio`	booleano	`true`	Se acepta por compatibilidad. Todos los clips tienen sonido: `false` no crea un clip sin sonido.
`fallback`	objeto	ninguno	`{"enabled": true}` o `{"enabled": false}`. Se acepta por compatibilidad y se ignora.

El esquema es estricto: los campos desconocidos se rechazan en lugar de ignorarse. callback_url no está disponible; consulta la tarea en su lugar.

Imagen a vídeo

Envía una imagen en image_urls y describe lo que ocurre después en prompt. El clip empieza con la imagen y mantiene su forma, así que una imagen vertical produce un clip vertical, sea cual sea el valor de aspect_ratio.

{
  "model": "grok-imagine-video-1-5",
  "prompt": "The subject slowly turns toward the camera, soft natural light, gentle breeze, quiet room tone.",
  "image_urls": ["https://example.com/start.png"],
  "resolution": "720p",
  "duration": 6
}

Entradas multimedia

La imagen es una URL HTTP(S) pública. No se aceptan URI de datos base64: sube el archivo a tu propio almacenamiento y envía su URL. Usa una imagen JPG o PNG de 10 MB o menos.

Factores de coste

Consulta la sección de precios del modelo para ver las tarifas actuales. Grok Imagine Video 1.5 se factura por segundo de vídeo, a una tarifa que depende de la resolución:

cost = duration × rate per second for the resolution

Texto a vídeo e imagen a vídeo cuestan lo mismo. La duración se conoce cuando se acepta la solicitud, así que el importe reservado es el importe cobrado. Consulta los cargos definitivos en el historial de uso de tu cuenta. Las tareas fallidas no se cobran.

Esquema de salida

El envío devuelve la tarea:

{"id": "task_...", "model": "grok-imagine-video-1-5", "status": "processing", "created_at": 1789689600}

Consultar la tarea

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Sondea cada 10–20 segundos hasta que status sea completed o failed. Que se agote el tiempo de red durante el sondeo no significa que la generación haya fallado: conserva el identificador de tarea y reanuda la comprobación. No crees otra tarea para consultar el progreso.

Tarea completada

{
  "id": "task_...",
  "model": "grok-imagine-video-1-5",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689720,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

En nuestras pruebas, los clips de 8 segundos en 720p llegaron como MP4 (H.264) con una pista de audio AAC en 1280 × 720 para 16:9, 720 × 1280 para 9:16 y 720 × 720 para 1:1, 111–133 segundos después del envío. Los clips en 480p llegaron en 45–84 segundos.

Errores

Las solicitudes rechazadas antes de crear una tarea devuelven un error HTTP con un objeto error y no se cobran. Una tarea que falla después de aceptarse devuelve HTTP 200 al consultarla, con status: "failed" y un objeto error.

Consulta el catálogo de errores común para ver códigos, estados HTTP y pautas de reintento.

{
  "id": "task_...",
  "model": "grok-imagine-video-1-5",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Si el propio envío agota el tiempo de espera, revisa tus tareas antes de volver a enviar: puede que la primera solicitud se haya aceptado.

Consejos

Describe el sujeto, el lugar, el movimiento de cámara y la luz, e indica los sonidos que quieres; el audio se genera junto con la imagen.
Haz los borradores en 480p y luego renderiza la toma final en 720p con la misma solicitud.
Para vídeo vertical, envía aspect_ratio: "9:16" o una imagen vertical.
Añade no text, no logos para evitar marcas inventadas.