Skip to main content
POST
cURL
Gebruik dit endpoint om een Veo 3.1-videotaak te starten. De API retourneert onmiddellijk een task ID, dus sla de geretourneerde id op en poll de taak totdat deze een eindstatus bereikt. POST /v1/videos gebruikt multipart/form-data; geef scalaire instellingen door als formuliervelden en media-invoer als input_reference-bestandsvelden.

Kies een model

Kies een invoermodus

Stel duur en grootte in

Gebruik voor de OpenAI-compatibele route seconds voor de duur en size voor de uitvoergrootte. Verstuur waarden als formuliervelden. Stel size in op een van de onderstaande WxH-waarden.

Taakverloop

1

Maak de taak

Verstuur de multipart form-aanvraag en sla de geretourneerde id op.
2

Poll de taak

Gebruik Veo3 Retrieve totdat status completed, failed of error is.
3

Download het resultaat

Wanneer de taak completed is, download je het MP4-bestand uit de respons van de voltooide taak.

Autorisaties

Authorization
string
header
vereist

Bearer authentication. Use your CometAPI API key.

Body

multipart/form-data
model
enum<string>
vereist

Veo 3.1 model ID. Use veo3.1-fast for the default route or veo3.1 when you specifically need the standard model.

Beschikbare opties:
veo3.1-fast,
veo3.1
Voorbeeld:

"veo3.1-fast"

prompt
string
vereist

Text prompt for the video job.

Voorbeeld:

"A paper kite floats above a field."

seconds
enum<string>
standaard:4

Requested clip duration. Use 4, 6, or 8. Send the value as a form field string.

Beschikbare opties:
4,
6,
8
Voorbeeld:

"4"

size
string

Supported WxH size values: 1280x720, 720x1280, 1920x1080, 3840x2160. Default is 1280x720.

Voorbeeld:

"1280x720"

input_reference
file

Optional first-frame image file for image-to-video.

Respons

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

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:

"veo3.1-fast"

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.