Vidu Q4 Preview

No. viduq4-preview requiere imágenes: una imagen inicial para I2V o de 1 a 15 referencias para R2V. R2V también admite hasta 3 clips de audio de referencia. No admite generación solo con texto ni control conjunto del fotograma inicial y final.

first_frame_image o el rol first_frame seleccionan I2V, al igual que una imagen sin rol ni audio de referencia. El rol reference_image (alias reference), varias imágenes o imágenes sin rol con audio de referencia seleccionan R2V. No mezcles un fotograma inicial explícito con referencias o su audio. image_urls e image_with_roles comparten un máximo de 15 referencias. PNG, JPEG/JPG y WEBP: hasta 50 MB por imagen; la solicitud Base64 debe ocupar menos de 20 MB.

El prompt es opcional en I2V y obligatorio en R2V, con hasta 20.000 caracteres en ambos modos. Describe la acción, la escena y cómo deben guiar el vídeo las referencias.

Duración entera de 3–16 segundos, 5 por defecto. Resoluciones: 540p, 720p, 1080p, 2K o 4K, con 720p por defecto. R2V admite 1:1, 9:16, 16:9, 3:4 y 4:3; el valor predeterminado es 16:9. aspect_ratio tiene prioridad sobre su alias size. I2V ignora ambos campos y sigue la imagen inicial.

El audio generado vale true por defecto; false crea vídeo silencioso al mismo precio. R2V acepta 0–3 MP3 de referencia, de 3–12 segundos y hasta 50 MB cada uno. El proveedor comprueba formato y duración; un clip inválido puede causar un fallo con reembolso. Seed acepta un entero; omitirlo o usar 0 solicita un valor aleatorio.

I2V y R2V tienen la misma tarifa: duración por el precio actual por segundo de la resolución elegida. No hay recargo por imágenes o audio de referencia, y activar o desactivar el audio generado cuesta lo mismo. Consulta el precio de tu cuenta. Las tareas fallidas se reembolsan íntegramente.

POST /v1/videos/generations devuelve un task_id. Consulta GET /v1/tasks/{task_id} cada 5–10 segundos hasta completed o failed. Los enlaces del vídeo aparecen en result.videos[].url.

Guarda los vídeos en un plazo de 72 horas y revisa la caducidad indicada en la respuesta. Un tiempo de consulta agotado no implica un fallo de generación; reanuda la consulta de la misma tarea sin volver a enviarla.