Opprett en Veo 3-video

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
}

Opprett en Veo 3.1-video fra tekst eller et bilde. API-et returnerer umiddelbart en oppgave-ID. Lagre den returnerte id for å polle oppgaven og laste ned den fullførte videoen. POST /v1/videos bruker multipart/form-data. Send kontroller som skjemafelt og et bilde som et input_reference-filfelt.

Velg en modell

Modell-ID	Når du bør bruke den	Merknader
`veo3.1-fast`	Standardvalg for de fleste korte klipp	Raskere Veo 3.1-rute.
`veo3.1`	Bruk når du spesifikt ønsker standardmodellen Veo 3.1	Standard Veo 3.1-rute.

Velg en inndatamodus

Mål	Obligatoriske felt	Valgfrie felt
Tekst-til-video	`model`, `prompt`	`seconds`, `size`
Bilde-til-video	`model`, `prompt`, én `input_reference`-bildefil	`seconds`, `size`

For å animere et bilde laster du opp én fil via input_reference og bruker feltet én gang. Bildet angir åpningsbildet; prompt beskriver bevegelsen og kamerafunksjonen som følger.

Angi varighet og størrelse

For denne OpenAI-kompatible ruten angir du varigheten med en eksplisitt heltallsverdi for seconds og utdataformatet med size. Send begge verdiene som skjemafelt.

Modell-ID	`seconds`	Standard
`veo3.1-fast`	`4`, `6`, `8`	`4` sekunder, `1280x720`
`veo3.1`	`4`, `6`, `8`	`4` sekunder, `1280x720`

Angi size til én av WxH-verdiene nedenfor.

Oppløsningsnivå	Bildeformat	`size` (`WxH`)
`720p`	`16:9`	`1280x720`
	`9:16`	`720x1280`
`1080p`	`16:9`	`1920x1080`
`4K`	`16:9`	`3840x2160`

Oppgaveflyt

Opprett oppgaven

Send forespørselen med multipart-skjemaet og lagre den returnerte id.

Poll oppgaven

Bruk Veo3 Retrieve til status er completed, failed eller error.

Last ned resultatet

Når oppgaven er completed, laster du ned MP4-filen fra svaret for den fullførte oppgaven.

Autorisasjoner

Authorization

string

header

påkrevd

Bearer authentication. Use your CometAPI API key.

Kropp

multipart/form-data

model

enum<string>

påkrevd

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

Tilgjengelige alternativer:

veo3.1-fast,

veo3.1

Eksempel:

"veo3.1-fast"

prompt

string

påkrevd

Text prompt for the video job.

Eksempel:

"A paper kite floats above a field."

seconds

enum<integer>

standard:4

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

Tilgjengelige alternativer:

4,

6,

8

Eksempel:

4

size

string

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

Eksempel:

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

Svar

Task created. Store the returned id and poll GET /v1/videos/{task_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:

"veo3.1-fast"

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

Innholdsmoderering

API-nøkler

Velg en modell

Velg en inndatamodus

Angi varighet og størrelse

Oppgaveflyt

Autorisasjoner

Kropp

Svar

​Velg en modell

​Velg en inndatamodus

​Angi varighet og størrelse

​Oppgaveflyt

Autorisasjoner

Kropp

Svar

Velg en modell

Velg en inndatamodus

Angi varighet og størrelse

Oppgaveflyt