Skip to main content
POST
Use this endpoint to create a Wan text-to-video or image-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. Send scalar controls as form fields and reference images as input_reference file fields.

​
Choose an input mode

To confirm a Wan model ID that is available to your API key, use List available models.

​
Use reference images

For image-to-video, upload one reference image through the input_reference multipart field. The file can be up to 20 MB. The image guides the composition and appearance of the generated video. Use the prompt to describe motion, camera behavior, and details that the video should preserve. wan3.0 supports both text-to-video and single-reference image-to-video requests on this endpoint.

​
Set duration and size

Set size to one of the WxH values below for the target model.

​
Wan 3.0 size values

​
Wan 2.7 size values

​
Wan 2.6 size values

​
Task flow

1

Create the task

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

Poll the task

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

Download the result

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

Authorizations

​
Authorization
string
header
required

Bearer authentication. Use your CometAPI API key.

Body

multipart/form-data
​
model
string
required

Wan model ID for this route. Choose an available model from the Models page.

Example:

"wan3.0"

​
prompt
string
required

Text prompt that describes the video to generate. For image-to-video, describe the motion and camera behavior that should animate the reference image.

Example:

"A small robot walks through a bright greenhouse with smooth camera movement."

​
seconds
string

Requested clip duration in seconds. For wan3.0, use an integer from 2 through 30. For wan2.6, use 5, 10, or 15. For wan2.7, use an integer from 2 through 15. Default is 5.

Example:

"5"

​
size
string

Supported WxH size values. For wan3.0: 832x480, 480x832, 624x624, 640x480, 480x640, 1280x720, 720x1280, 960x960, 1088x832, 832x1088, 1920x1080, 1080x1920, 1440x1440, 1632x1248, 1248x1632. For wan2.6: 1280x720, 720x1280, 1088x832, 832x1088, 1920x1080, 1080x1920, 1440x1440, 1632x1248, 1248x1632. For wan2.7: 1280x720, 720x1280, 1920x1080, 1080x1920, 1440x1440. Default is 1920x1080.

Example:

"1920x1080"

​
input_reference
file

One reference image file for image-to-video. Omit this field for text-to-video. The file can be up to 20 MB. The image guides the composition and appearance of the generated video.

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:

"wan3.0"

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

Last modified on August 27, 2026