Skip to main content
POST
cURL
使用此端点创建 Wan 文生视频任务。API 会立即返回任务 ID,因此请保存返回的 id,并轮询任务直到其达到终态状态。 POST /v1/videos 使用 multipart/form-data;将标量控制项作为表单字段传递。

选择模型

设置时长和尺寸

size 设置为下方目标模型支持的 WxH 值之一。

Wan 2.7 尺寸值

Wan 2.6 尺寸值

任务流程

1

创建任务

发送 multipart 表单请求并保存返回的 id
2

轮询任务

调用 获取 Wan 视频,直到 statuscompletedfailederror
3

下载结果

当任务为 completed 时,调用 获取 Wan 视频内容 下载 MP4 文件。

授权

Authorization
string
header
必填

Bearer authentication. Use your CometAPI API key.

请求体

multipart/form-data
model
enum<string>
必填

Wan model ID for this endpoint.

可用选项:
wan2.6,
wan2.7
示例:

"wan2.6"

prompt
string
必填

Text prompt that describes the video to generate.

示例:

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

seconds
string

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

示例:

"5"

size
string

Supported WxH size values. For wan2.6: 1280x720, 720x1280, 1088x832, 832x1088, 1920x1080, 1080x1920, 1440x1440, 1632x1248, 1248x1632. For wan2.7: 1280x720, 720x1280, 1920x1080, 1080x1920, 1440x1440. Default is 1920x1080.

示例:

"1280x720"

响应

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

id
string
必填

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

示例:

"task_example"

object
string
必填

Object type. Video tasks return video.

示例:

"video"

model
string
必填

Model ID used for the task.

示例:

"wan2.6"

status
enum<string>
必填

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

可用选项:
queued,
in_progress,
completed,
failed,
error
示例:

"queued"

progress
integer
必填

Task progress as a coarse percentage.

必填范围: 0 <= x <= 100
示例:

0

created_at
integer
必填

Task creation time as a Unix timestamp in seconds.

示例:

1779938152

task_id
string

Compatibility alias for id when present.

示例:

"task_example"

completed_at
integer

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

示例:

1779938219

video_url
string

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

示例:

"<temporary-video-url>"

error
object

Failure details. This field appears when the task fails.