Skip to main content
POST
Usa este endpoint para crear una tarea de texto a video o de imagen a video de Vidu Q3. La API devuelve inmediatamente un ID de tarea, así que guarda el id devuelto y consulta la tarea hasta que alcance un estado terminal. POST /v1/videos usa multipart/form-data. Envía los controles escalares como campos de formulario y referencia las imágenes como campos de archivo input_reference.

​
Elige un modo de entrada

Para confirmar un ID de modelo de Vidu disponible para tu clave de API, usa Mostrar modelos disponibles.

​
Usar imágenes de referencia

Para imagen a video, carga una imagen de referencia mediante el campo multipart input_reference. El archivo puede tener un tamaño máximo de 20 MB. La imagen guía la composición y la apariencia del video generado. Usa el Prompt para describir el movimiento, el comportamiento de la cámara y los detalles que el video debe conservar.

​
Establece la duración y el tamaño

Establece size en uno de los valores WxH siguientes.

​
Flujo de la tarea

1

Crear la tarea

Envía la solicitud de formulario multipart y guarda el id devuelto.
2

Consultar la tarea

Llama a Recuperar un video de Vidu hasta que status sea completed, failed o error.
3

Descargar el resultado

Cuando la tarea esté completed, llama a Recuperar el contenido del video de Vidu para descargar el archivo MP4.

Autorizaciones

​
Authorization
string
header
requerido

Bearer authentication. Use your CometAPI API key.

Cuerpo

multipart/form-data
​
model
string
requerido

Vidu Q3 model ID for this route. Choose an available model from the Models page.

Ejemplo:

"viduq3-turbo"

​
prompt
string
requerido

Text prompt that describes the video to generate. For image-to-video, describe the motion and camera behavior that should animate the reference image.

Ejemplo:

"An astronaut walks through soft blue fog with a slow cinematic camera move."

​
seconds
string

Requested clip duration in seconds. Use an integer from 1 through 16. Default is 5.

Ejemplo:

"1"

​
size
string

Supported WxH size values: 960x528, 1280x720, 1920x1080. Default is 1280x720.

​
input_reference
file

One reference image file for image-to-video. Omit this field for text-to-video. The file can be up to 20 MB. The image guides the composition and appearance of the generated video.

Respuesta

Task created. Store the returned id and poll GET /v1/videos/{task_id}.

​
id
string
requerido

Task ID. Use this value with retrieve and content endpoints.

Ejemplo:

"task_example"

​
object
string
requerido

Object type. Video tasks return video.

Ejemplo:

"video"

​
model
string
requerido

Model ID used for the task.

Ejemplo:

"viduq3-turbo"

​
status
enum<string>
requerido

Task lifecycle status. Poll until the value is completed, failed, or error.

Opciones disponibles:
queued,
in_progress,
completed,
failed,
error
Ejemplo:

"queued"

​
progress
integer
requerido

Task progress as a coarse percentage.

Rango requerido: 0 <= x <= 100
Ejemplo:

0

​
created_at
integer
requerido

Task creation time as a Unix timestamp in seconds.

Ejemplo:

1779938152

​
task_id
string

Compatibility alias for id when present.

Ejemplo:

"task_example"

​
completed_at
integer

Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.

Ejemplo:

1779938219

​
video_url
string

Temporary video delivery URL. This field appears on completed tasks.

Ejemplo:

"<temporary-video-url>"

​
error
object

Failure details. This field appears when the task fails.

Última modificación el 12 de agosto de 2026