Skip to main content
POST
Create video task

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

model
string
required

Video model ID.

Example:

"gemini-veo31"

prompt
string
required

Text instruction for the video.

Example:

"Waves crashing on rocks, cinematic slow motion"

seconds
string
required

Requested duration. Must be listed in the selected model's capabilities.supported_seconds.

Example:

"6"

size
string

Requested output size. Must be listed in the selected model's capabilities.supported_sizes when provided.

Example:

"1280x720"

Response

Queued video task

id
string
required

Video task ID.

Example:

"video_task_id"

status
enum<string>
required

Video task status.

Available options:
queued,
in_progress,
completed,
failed
Example:

"queued"