Crea un video Vidu

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=viduq3-turbo \
  -F 'prompt=An astronaut walks through soft blue fog with a slow cinematic camera move.' \
  -F seconds=1

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "viduq3-turbo",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Usa questo endpoint per creare un’attività Vidu Q3 da testo a video o da immagine a video. L’API restituisce immediatamente un ID attività, quindi salva il id restituito e interroga l’attività finché non raggiunge uno stato finale. POST /v1/videos usa multipart/form-data. Invia i controlli scalari come campi del modulo e fai riferimento alle immagini di riferimento come campi file input_reference.

Scegli una modalità di input

Obiettivo	Campi obbligatori	Campi facoltativi
Da testo a video	`model`, `prompt`	`seconds`, `size`
Da immagine a video	`model`, `prompt`, un file `input_reference`	`seconds`, `size`

Per verificare un ID modello Vidu disponibile per la tua chiave API, usa Elenca i modelli disponibili.

Usa immagini di riferimento

Per la modalità da immagine a video, carica un’immagine di riferimento tramite il campo multipart input_reference. Il file può avere una dimensione massima di 20 MB. L’immagine guida la composizione e l’aspetto del video generato. Usa il Prompt per descrivere il movimento, il comportamento della telecamera e i dettagli che il video deve preservare.

Imposta durata e dimensioni

ID modello	`seconds`	Predefinito
`viduq3-turbo`	intero `1`-`16`	`5` secondi, `1280x720`
`viduq3`	intero `1`-`16`	`5` secondi, `1280x720`

Imposta size su uno dei valori WxH riportati di seguito.

Livello di risoluzione	Rapporto d’aspetto	`size` (`WxH`)
`540p`	`16:9`	`960x528`
`720p`	`16:9`	`1280x720`
`1080p`	`16:9`	`1920x1080`

Flusso dell’attività

Crea l'attività

Invia la richiesta del modulo multipart e salva il id restituito.

Interroga l'attività

Chiama Recupera un video Vidu finché status non è completed, failed o error.

Scarica il risultato

Quando l’attività è completed, chiama Recupera il contenuto del video Vidu per scaricare il file MP4.

Autorizzazioni

Authorization

string

header

obbligatorio

Bearer authentication. Use your CometAPI API key.

Corpo

multipart/form-data

model

string

obbligatorio

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

Esempio:

"viduq3-turbo"

prompt

string

obbligatorio

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

Esempio:

"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.

Esempio:

"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.

Risposta

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

string

obbligatorio

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

Esempio:

"task_example"

object

string

obbligatorio

Object type. Video tasks return video.

Esempio:

"video"

model

string

obbligatorio

Model ID used for the task.

Esempio:

"viduq3-turbo"

status

enum<string>

obbligatorio

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

Opzioni disponibili:

queued,

in_progress,

completed,

failed,

error

Esempio:

"queued"

progress

integer

obbligatorio

Task progress as a coarse percentage.

Intervallo richiesto: 0 <= x <= 100

Esempio:

0

created_at

integer

obbligatorio

Task creation time as a Unix timestamp in seconds.

Esempio:

1779938152

task_id

string

Compatibility alias for id when present.

Esempio:

"task_example"

completed_at

integer

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

Esempio:

1779938219

video_url

string

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

Esempio:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

Ultima modifica il 12 agosto 2026

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=viduq3-turbo \
  -F 'prompt=An astronaut walks through soft blue fog with a slow cinematic camera move.' \
  -F seconds=1

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "viduq3-turbo",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Moderazione dei contenuti

Chiavi API

Scegli una modalità di input

Usa immagini di riferimento

Imposta durata e dimensioni

Flusso dell’attività

Autorizzazioni

Corpo

Risposta

​Scegli una modalità di input

​Usa immagini di riferimento

​Imposta durata e dimensioni

​Flusso dell’attività

Autorizzazioni

Corpo

Risposta

Scegli una modalità di input

Usa immagini di riferimento

Imposta durata e dimensioni

Flusso dell’attività