Wan 视频生成
视频生成是异步任务。创建任务后保存返回的 id / task_id,再通过查询接口轮询结果。
任务 ID 和成功响应中的视频 URL 均在 24 小时内有效,请及时查询并转存视频。
创建视频生成任务
POST /api/v3/contents/generations/tasks
Wan 3.0
Wan 3.0 支持文生视频、首帧 / 首尾帧视频生成,以及基于图片、视频、音频、文件或网页的参考视频生成。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 使用 wan3.0-video 或 wan3.0-video-prime。 |
input.prompt | string | 条件必填 | 视频描述或素材使用指令,最多 5000 个字符;与 input.media 至少填写一项。 |
input.media | array | 条件必填 | 参考素材列表,每项包含 type 和公网可访问的 url;与 input.prompt 至少填写一项。 |
parameters.resolution | string | 否 | 480P / 720P / 1080P,默认 1080P。 |
parameters.ratio | string | 否 | adaptive、16:9、9:16、1:1、4:3 或 3:4,默认 adaptive。 |
parameters.duration | integer | 否 | 2 至 30 秒,默认 5 秒;传 -1 时由模型智能选择时长。包含参考视频时,输入与输出视频总时长不能超过 30 秒。 |
parameters.audio | boolean | 否 | 输出是否包含音轨,默认 true;关闭声音不改变计费价格。 |
parameters.prompt_extend | boolean | 否 | 是否启用提示词智能改写,默认 true。设置为 false 可减少约 20 至 60 秒处理时间,但可能降低生成效果。 |
parameters.enable_thinking | boolean | 否 | 是否启用深度思考,默认 false;使用 file 或 link 时必须设为 true。 |
parameters.seed | integer | 否 | 随机种子,取值范围为 0 至 2147483647。 |
parameters.watermark | boolean | 否 | 是否添加“AI生成”水印,默认 false。 |
input.media 类型
type | 用途 | 数量与格式限制 |
|---|---|---|
reference_image | 参考图片 | 最多 10 张;支持 JPEG、JPG、PNG、BMP、WEBP,不支持透明通道;单张不超过 20 MB,单边 240 至 8000 像素,长宽比不超过 8:1。 |
first_frame | 严格指定首帧 | 最多 1 张,图片格式与尺寸限制同上。 |
last_frame | 严格指定尾帧 | 最多 1 张,且必须同时提供 first_frame。 |
reference_video | 参考视频 | 最多 5 段、总时长不超过 15 秒,单段 1 至 15 秒;支持 MP4、MOV,单文件小于 100 MB,单边 240 至 4096 像素,长宽比不超过 8:1。 |
reference_audio | 参考音频 | 最多 5 段、总时长不超过 15 秒,单段 1 至 15 秒;支持 WAV、MP3,单文件小于 15 MB。 |
file | 参考文件 | 最多 1 个,不得与 link 同时使用;支持 DOCX、DOC、XLSX、XLS、PPTX、PPT、PDF、TXT、KEY、PAGES、NUMBERS、MD,不超过 100 MB,分页格式不超过 50 页。 |
link | 参考网页 | 最多 1 个,不得与 file 同时使用;网页必须公开且无需登录。 |
first_frame/last_frame属于严格首尾帧模式,不能与reference_image、reference_video、reference_audio、file或link混用。- 全能参考模式可以组合使用参考图片、参考视频和参考音频,并通过
input.prompt说明每项素材的用途。 - 使用
file或link时必须设置parameters.enable_thinking: true。
调用示例
文生视频
curl -X POST "https://api.example.com/api/v3/contents/generations/tasks" \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"model": "wan3.0-video",
"input": {
"prompt": "清晨的山谷云海翻涌,镜头缓慢向前推进,电影感自然光"
},
"parameters": {
"resolution": "1080P",
"ratio": "adaptive",
"duration": 10,
"audio": true,
"prompt_extend": true,
"watermark": false
}
}'Wan 2.7
模型能力
| 模型 | 用途 | 输入要求 |
|---|---|---|
wan2.7-t2v | 文生视频 | 在 input.prompt 中描述视频内容。 |
wan2.7-i2v | 首帧、首尾帧或视频续写 | input.media 至少包含一个图像、音频或视频素材的有效组合。 |
wan2.7-r2v | 参考生视频 | input.media 必须包含 reference_image 或 reference_video。 |
请求参数
| 参数 | 类型 | 说明 |
|---|---|---|
model | string | 使用上方三个公开模型名之一。 |
input.prompt | string | 正向提示词,支持中英文。 |
input.negative_prompt | string | 不希望出现在视频中的内容,可选。 |
input.media | array | 图像、音频或视频素材列表;t2v 不需要传入。 |
parameters.resolution | string | 720P / 1080P,默认 1080P。 |
parameters.duration | integer | 2 至 15 秒,默认 5 秒;r2v 使用参考视频时最多生成 10 秒。 |
parameters.ratio | string | t2v / r2v 支持 16:9、9:16、1:1、4:3、3:4,默认 16:9;i2v 跟随输入素材。 |
parameters.prompt_extend | boolean | 是否开启提示词智能改写,默认 true。 |
parameters.watermark | boolean | 是否添加“AI生成”水印,默认 false。 |
parameters.seed | integer | 随机种子,取值范围为 0 至 2147483647。 |
input.media 类型
| 模型 | type | 用途 |
|---|---|---|
wan2.7-i2v | first_frame | 首帧图片。 |
wan2.7-i2v | last_frame | 尾帧图片,需与首帧同时使用。 |
wan2.7-i2v | driving_audio | 驱动音频,需与首帧或首尾帧同时使用。 |
wan2.7-i2v | first_clip | 用于续写的首段视频,可与尾帧组合。 |
wan2.7-r2v | reference_image | 参考图片。 |
wan2.7-r2v | reference_video | 参考视频;对应输出时长最多 10 秒。 |
- 每个媒体项必须包含公网可访问的
url;图片也可使用接口支持的 Base64 数据。 - 同一
type在media中最多出现一次。 first_clip模式中的duration表示输入片段与续写内容合并后的目标总时长。
调用示例
文生视频
curl -X POST "https://api.example.com/api/v3/contents/generations/tasks" \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"model": "wan2.7-t2v",
"input": {
"prompt": "清晨的山谷云海翻涌,镜头缓慢向前推进,电影感自然光"
},
"parameters": {
"resolution": "1080P",
"duration": 5,
"ratio": "16:9",
"watermark": false
}
}'创建任务响应
创建任务响应示例:
{
"id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"task_id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"object": "video",
"model": "wan3.0-video",
"status": "queued",
"progress": 0,
"created_at": 1779381684
}创建成功后保存响应中的 id 或 task_id,用于后续查询任务。
查询视频生成任务
GET /api/v3/contents/generations/tasks/{task_id}
路径参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
task_id | string | 是 | 创建任务时返回的 id 或 task_id。 |
调用示例
curl "https://api.example.com/api/v3/contents/generations/tasks/<task_id>" \
-H "Authorization: Bearer <YOUR_API_KEY>"响应参数
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 任务 ID。 |
model | string | 创建任务时使用的模型。 |
status | string | 任务进度状态:queued、running、succeeded 或 failed。 |
created_at | integer | 任务创建时间,Unix 时间戳。 |
updated_at | integer | 任务状态更新时间,Unix 时间戳。 |
content | object / null | 任务成功时返回结果对象,视频地址位于 content.video_url。 |
usage | object / null | 任务用量信息,可能为 null。 |
error | object / null | 失败信息,任务失败时读取 error.code 和 error.message。 |
响应示例
任务完成响应示例:
{
"id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"model": "wan3.0-video",
"status": "succeeded",
"created_at": 1779381684,
"updated_at": 1779381864,
"content": {
"video_url": "https://example.com/generated-video.mp4"
},
"usage": null,
"error": null
}轮询建议
queued或running:继续按合理间隔查询,不要高频轮询或重复创建相同任务。succeeded:从content.video_url读取视频地址并立即下载或转存,链接超过 24 小时会失效。failed:读取error.code和error.message,修正请求后重新创建任务。- 遇到
HTTP 429或临时性5xx时使用带随机抖动的指数退避。
Last updated on