Skip to main content
POST
/
v1
/
videos
cURL
curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=viduq3-turbo \
  -F 'prompt=An astronaut walks through soft blue fog with a slow cinematic camera move.' \
  -F seconds=1
{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "viduq3-turbo",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}
Use this endpoint to create a Vidu Q3 text-to-video task. The API returns a task ID immediately, so store the returned id and poll the task until it reaches a terminal status. POST /v1/videos uses multipart/form-data; pass scalar controls as form fields.

​
Choose a model

Model IDInput mode
viduq3-turboText-to-video
viduq3Text-to-video

​
Set duration and size

Model IDsecondsDefault
viduq3-turbointeger 1-165 seconds, 1280x720
viduq3integer 1-165 seconds, 1280x720
Set size to one of the WxH values below.
Resolution tierAspect ratiosize (WxH)
360p16:9640x352
540p16:9960x528
720p16:91280x720
1080p16:91920x1080

​
Task flow

1

Create the task

Send the multipart form request and store the returned id.
2

Poll the task

Call Retrieve a Vidu video until status is completed, failed, or error.
3

Download the result

When the task is completed, call Retrieve Vidu video content to download the MP4 file.

Authorizations

​
Authorization
string
header
required

Bearer authentication. Use your CometAPI API key.

Body

multipart/form-data
​
model
enum<string>
required

Vidu Q3 model ID for this endpoint.

Available options:
viduq3-turbo,
viduq3
Example:

"viduq3-turbo"

​
prompt
string
required

Text prompt that describes the video to generate.

Example:

"An astronaut walks through soft blue fog with a slow cinematic camera move."

​
seconds
string

Requested clip duration in seconds. Use an integer from 1 through 16. Default is 5.

Example:

"1"

​
size
string

Supported WxH size values: 640x352, 960x528, 1280x720, 1920x1080. Default is 1280x720.

Response

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

​
id
string
required

Task ID. Use this value with retrieve and content endpoints.

Example:

"task_example"

​
object
string
required

Object type. Video tasks return video.

Example:

"video"

​
model
string
required

Model ID used for the task.

Example:

"viduq3-turbo"

​
status
enum<string>
required

Task lifecycle status. Poll until the value is completed, failed, or error.

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

"queued"

​
progress
integer
required

Task progress as a coarse percentage.

Required range: 0 <= x <= 100
Example:

0

​
created_at
integer
required

Task creation time as a Unix timestamp in seconds.

Example:

1779938152

​
task_id
string

Compatibility alias for id when present.

Example:

"task_example"

​
completed_at
integer

Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.

Example:

1779938219

​
video_url
string

Temporary video delivery URL. This field appears on completed tasks.

Example:

"<temporary-video-url>"

​
error
object

Failure details. This field appears when the task fails.