Submit video generation task - API Doc-CometAPI

Request

Header Params

Authorization

string

required

Example:

Body Params application/json

prompt

string

required

Text description for video generation, it is recommended to describe scenes, actions, styles, etc. in detail

model

enum<string>

required

Name of the model to use

Allowed values:

veo3veo3-fastveo3-proveo3-framesveo3-fast-framesveo3-pro-frames

Default:

veo3-fast

images

array[string]

optional

Array of reference image URLs, used to assist video generation

enhance_prompt

boolean

required

Whether to enhance the prompt

Examples

Text-to-videoimage

{
    "prompt": "An orange cat flying in the blue sky with white clouds, sunlight pouring onto its fur, creating a beautiful and dreamlike scene",
    "model": "veo3",
    "enhance_prompt": true
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

cURL

Text-to-videoimage

curl --location --request POST 'https://api.cometapi.com/veo/v1/api/video/submit' \
--header 'Authorization: {{api-key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "An orange cat flying in the blue sky with white clouds, sunlight pouring onto its fur, creating a beautiful and dreamlike scene",
    "model": "veo3",
    "enhance_prompt": true
}'

Responses

🟢200Successful Response

application/json

Body

id

string

required

The unique identifier for this chat completion.

object

string

required

Object type

created

integer

required

Unix timestamp when the chat completion was created

model

string

required

Specific model name.

system_fingerprint

string

required

Fingerprint representing the backend configuration used for the model run.

choices

array [object {3}]

required

A list containing chat completion result options. If the n parameter in the request is greater than 1, there may be multiple options here.

index

integer

optional

Index of this choice in the list, starting from 0.

message

object

optional

Message object generated by the model.

finish_reason

string

optional

Reason why the model stopped generating tokens.

usage

object

required

Token usage statistics for this request.

completion_tokens

integer

required

Number of tokens in the completion content generated by the model.

completion_tokens_details

object

required

More detailed information about tokens in the generated content

prompt_tokens

integer

required

Number of tokens in the input prompt.

prompt_tokens_details

object

required

More detailed information about tokens in the input prompt.

total_tokens

integer

required

Total number of tokens used in this request

Example



> Video generation task created
> Task ID: `veo3: 16240615-a563-4d26-819d-a8559ce7d524`
> To prevent task interruption, you can continuously track progress from the following links:
> [Data Preview
](https: //asyncdata.net/web/veo3:16240615-a563-4d26-819d-a8559ce7d524) | [Source Data](https://asyncdata.net/source/veo3:16240615-a563-4d26-819d-a8559ce7d524)
> Waiting for processing.

> 🤔 Analyzing if prompt needs enhancement

> Type: Text-to-video generation
> 🎬 Starting video generation.......................................

> ✅ Preview video generated
> [📺 Online Preview
](https: //filesystem.site/cdn/20250620/b6dn4mQpz27ZHZBvh9u95N9G12ya0n.mp4) | [⏬ Download Video](https://filesystem.site/cdn/download/20250620/b6dn4mQpz27ZHZBvh9u95N9G12ya0n.mp4)

> 🔄 Optimizing video quality..................................

> 🎉 High-quality video generated

[▶️ Watch Online
](https: //filesystem.site/cdn/20250620/kGNathDwlJBJKy0uRc0HyfUWWvyGVr.mp4) | [⏬ Download Video](https://filesystem.site/cdn/download/20250620/kGNathDwlJBJKy0uRc0HyfUWWvyGVr.mp4)