Skip to main content
POST
Bruk dette endepunktet til å opprette en Vidu Q3-oppgave for tekst-til-video eller bilde-til-video. API-et returnerer en oppgave-ID umiddelbart, så lagre den returnerte id og spør oppgaven regelmessig til den når en endelig status. POST /v1/videos bruker multipart/form-data. Send skalarkontroller som skjemafelt og referansebilder som input_reference-filfelt.

​
Velg en inndatamodus

For å bekrefte en Vidu-modell-ID som er tilgjengelig for API-nøkkelen din, bruker du Vis tilgjengelige modeller.

​
Bruk referansebilder

For bilde-til-video laster du opp ett referansebilde gjennom multipart-feltet input_reference. Filen kan være på opptil 20 MB. Bildet styrer komposisjonen og utseendet til den genererte videoen. Bruk prompten til å beskrive bevegelse, kameraoppførsel og detaljer som videoen skal bevare.

​
Angi varighet og størrelse

Angi size til én av WxH-verdiene nedenfor.

​
Oppgaveflyt

1

Opprett oppgaven

Send multipart-skjemaanmodningen og lagre den returnerte id.
2

Spør oppgaven regelmessig

Kall Hent en Vidu-video til status er completed, failed eller error.
3

Last ned resultatet

Når oppgaven er completed, kaller du Hent Vidu-videoinnhold for å laste ned MP4-filen.

Autorisasjoner

​
Authorization
string
header
påkrevd

Bearer authentication. Use your CometAPI API key.

Kropp

multipart/form-data
​
model
string
påkrevd

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

Eksempel:

"viduq3-turbo"

​
prompt
string
påkrevd

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

Eksempel:

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

Eksempel:

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

Svar

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

​
id
string
påkrevd

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

Eksempel:

"task_example"

​
object
string
påkrevd

Object type. Video tasks return video.

Eksempel:

"video"

​
model
string
påkrevd

Model ID used for the task.

Eksempel:

"viduq3-turbo"

​
status
enum<string>
påkrevd

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

Tilgjengelige alternativer:
queued,
in_progress,
completed,
failed,
error
Eksempel:

"queued"

​
progress
integer
påkrevd

Task progress as a coarse percentage.

Nødvendig område: 0 <= x <= 100
Eksempel:

0

​
created_at
integer
påkrevd

Task creation time as a Unix timestamp in seconds.

Eksempel:

1779938152

​
task_id
string

Compatibility alias for id when present.

Eksempel:

"task_example"

​
completed_at
integer

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

Eksempel:

1779938219

​
video_url
string

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

Eksempel:

"<temporary-video-url>"

​
error
object

Failure details. This field appears when the task fails.

Sist endret 12. august 2026