Een Vidu-video maken

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
}

Gebruik dit endpoint om een Vidu Q3-taak voor tekst-naar-video of afbeelding-naar-video te maken. De API retourneert onmiddellijk een taak-ID, dus sla de geretourneerde id op en poll de taak totdat deze een eindstatus bereikt. POST /v1/videos gebruikt multipart/form-data. Verzend scalaire instellingen als formuliervelden en verwijs naar referentieafbeeldingen als input_reference-bestandsvelden.

Een invoermodus kiezen

Doel	Vereiste velden	Optionele velden
Tekst-naar-video	`model`, `prompt`	`seconds`, `size`
Afbeelding-naar-video	`model`, `prompt`, één `input_reference`-bestand	`seconds`, `size`

Om een Vidu-model-ID te bevestigen dat beschikbaar is voor je API-key, gebruik Beschikbare modellen weergeven.

Referentieafbeeldingen gebruiken

Upload voor afbeelding-naar-video één referentieafbeelding via het multipart-veld input_reference. Het bestand mag maximaal 20 MB groot zijn. De afbeelding bepaalt de compositie en het uiterlijk van de gegenereerde video. Gebruik de prompt om de beweging, het cameragedrag en de details te beschrijven die de video moet behouden.

Duur en formaat instellen

Model-ID	`seconds`	Standaard
`viduq3-turbo`	geheel getal `1`-`16`	`5` seconden, `1280x720`
`viduq3`	geheel getal `1`-`16`	`5` seconden, `1280x720`

Stel size in op een van de onderstaande WxH-waarden.

Resolutieniveau	Beeldverhouding	`size` (`WxH`)
`540p`	`16:9`	`960x528`
`720p`	`16:9`	`1280x720`
`1080p`	`16:9`	`1920x1080`

Taakverloop

De taak maken

Verzend het multipart-formulierverzoek en sla het geretourneerde id op.

De taak pollen

Roep Een Vidu-video ophalen aan totdat status gelijk is aan completed, failed of error.

Het resultaat downloaden

Wanneer de taak completed is, roep Vidu-videocontent ophalen aan om het MP4-bestand te downloaden.

Autorisaties

Authorization

string

header

vereist

Bearer authentication. Use your CometAPI API key.

Body

multipart/form-data

model

string

vereist

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

Voorbeeld:

"viduq3-turbo"

prompt

string

vereist

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

Voorbeeld:

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

Voorbeeld:

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

Respons

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

string

vereist

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

Voorbeeld:

"task_example"

object

string

vereist

Object type. Video tasks return video.

Voorbeeld:

"video"

model

string

vereist

Model ID used for the task.

Voorbeeld:

"viduq3-turbo"

status

enum<string>

vereist

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

Beschikbare opties:

queued,

in_progress,

completed,

failed,

error

Voorbeeld:

"queued"

progress

integer

vereist

Task progress as a coarse percentage.

Vereist bereik: 0 <= x <= 100

Voorbeeld:

0

created_at

integer

vereist

Task creation time as a Unix timestamp in seconds.

Voorbeeld:

1779938152

task_id

string

Compatibility alias for id when present.

Voorbeeld:

"task_example"

completed_at

integer

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

Voorbeeld:

1779938219

video_url

string

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

Voorbeeld:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

Laatst gewijzigd op 12 augustus 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
}

Contentmoderatie

API-sleutels

Een invoermodus kiezen

Referentieafbeeldingen gebruiken

Duur en formaat instellen

Taakverloop

Autorisaties

Body

Respons

​Een invoermodus kiezen

​Referentieafbeeldingen gebruiken

​Duur en formaat instellen

​Taakverloop

Autorisaties

Body

Respons

Een invoermodus kiezen

Referentieafbeeldingen gebruiken

Duur en formaat instellen

Taakverloop