Een Veo 3-video maken

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=veo3.1-fast \
  -F 'prompt=A paper kite floats above a field.' \
  -F seconds=4 \
  -F size=1280x720

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "veo3.1-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Maak een Veo 3.1-video op basis van tekst of een afbeelding. De API retourneert onmiddellijk een taak-ID. Sla de geretourneerde id op om de taak te pollen en de voltooide video te downloaden. POST /v1/videos gebruikt multipart/form-data. Verzend instellingen als formuliervelden en een afbeelding als een input_reference-bestandsveld.

Een model kiezen

Model-ID	Wanneer je dit gebruikt	Opmerkingen
`veo3.1-fast`	Standaardkeuze voor de meeste korte clips	Snellere Veo 3.1-route.
`veo3.1`	Gebruik dit wanneer je specifiek het standaard Veo 3.1-model wilt	Standaard Veo 3.1-route.

Een invoermodus kiezen

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

Om een afbeelding te animeren, upload je één bestand via input_reference en gebruik je het veld één keer. De afbeelding bepaalt het openingsframe; prompt beschrijft de beweging en het cameragedrag dat volgt.

Duur en grootte instellen

Stel voor deze OpenAI-compatibele route de duur in met een expliciete gehele seconds-waarde en de uitvoergrootte met size. Verzend beide waarden als formuliervelden.

Model-ID	`seconds`	Standaard
`veo3.1-fast`	`4`, `6`, `8`	`4` seconden, `1280x720`
`veo3.1`	`4`, `6`, `8`	`4` seconden, `1280x720`

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

Resolutieniveau	Beeldverhouding	`size` (`WxH`)
`720p`	`16:9`	`1280x720`
	`9:16`	`720x1280`
`1080p`	`16:9`	`1920x1080`
`4K`	`16:9`	`3840x2160`

Taakverloop

De taak maken

Verzend de multipart-formulieraanvraag en sla de geretourneerde id op.

De taak pollen

Gebruik Veo3 Retrieve totdat status de waarde completed, failed of error heeft.

Het resultaat downloaden

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

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<integer>

standaard:4

Requested clip duration in whole seconds. Send 4, 6, or 8 as a form field.

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

One image file that sets the opening frame for image-to-video. Send input_reference once with one file. Use prompt to describe the motion and camera behavior that follow.

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:

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

Laatst gewijzigd op 9 september 2026

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=veo3.1-fast \
  -F 'prompt=A paper kite floats above a field.' \
  -F seconds=4 \
  -F size=1280x720

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "veo3.1-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Contentmoderatie

API-sleutels

Een model kiezen

Een invoermodus kiezen

Duur en grootte instellen

Taakverloop

Autorisaties

Body

Respons

​Een model kiezen

​Een invoermodus kiezen

​Duur en grootte instellen

​Taakverloop

Autorisaties

Body

Respons

Een model kiezen

Een invoermodus kiezen

Duur en grootte instellen

Taakverloop