Skip to Content

Wan 视频生成

Video Tasks
创建任务POST /api/v3/contents/generations/tasks
查询任务GET /api/v3/contents/generations/tasks/{task_id}
wan3.0-videowan3.0-video-primewan2.7-t2vwan2.7-i2vwan2.7-r2v

视频生成是异步任务。创建任务后保存返回的 id / task_id,再通过查询接口轮询结果。

任务 ID 和成功响应中的视频 URL 均在 24 小时内有效,请及时查询并转存视频。

创建视频生成任务

POST /api/v3/contents/generations/tasks

Wan 3.0

Wan 3.0 支持文生视频、首帧 / 首尾帧视频生成,以及基于图片、视频、音频、文件或网页的参考视频生成。

请求参数

参数类型必填说明
modelstring是使用 wan3.0-video 或 wan3.0-video-prime。
input.promptstring条件必填视频描述或素材使用指令,最多 5000 个字符;与 input.media 至少填写一项。
input.mediaarray条件必填参考素材列表,每项包含 type 和公网可访问的 url;与 input.prompt 至少填写一项。
parameters.resolutionstring否480P / 720P / 1080P,默认 1080P。
parameters.ratiostring否adaptive、16:9、9:16、1:1、4:3 或 3:4,默认 adaptive。
parameters.durationinteger否2 至 30 秒,默认 5 秒;传 -1 时由模型智能选择时长。包含参考视频时,输入与输出视频总时长不能超过 30 秒。
parameters.audioboolean否输出是否包含音轨,默认 true;关闭声音不改变计费价格。
parameters.prompt_extendboolean否是否启用提示词智能改写,默认 true。设置为 false 可减少约 20 至 60 秒处理时间,但可能降低生成效果。
parameters.enable_thinkingboolean否是否启用深度思考,默认 false;使用 file 或 link 时必须设为 true。
parameters.seedinteger否随机种子,取值范围为 0 至 2147483647。
parameters.watermarkboolean否是否添加“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。

请求参数

参数类型说明
modelstring使用上方三个公开模型名之一。
input.promptstring正向提示词,支持中英文。
input.negative_promptstring不希望出现在视频中的内容,可选。
input.mediaarray图像、音频或视频素材列表;t2v 不需要传入。
parameters.resolutionstring720P / 1080P,默认 1080P。
parameters.durationinteger2 至 15 秒,默认 5 秒;r2v 使用参考视频时最多生成 10 秒。
parameters.ratiostringt2v / r2v 支持 16:9、9:16、1:1、4:3、3:4,默认 16:9;i2v 跟随输入素材。
parameters.prompt_extendboolean是否开启提示词智能改写,默认 true。
parameters.watermarkboolean是否添加“AI生成”水印,默认 false。
parameters.seedinteger随机种子,取值范围为 0 至 2147483647。
input.media 类型
模型type用途
wan2.7-i2vfirst_frame首帧图片。
wan2.7-i2vlast_frame尾帧图片,需与首帧同时使用。
wan2.7-i2vdriving_audio驱动音频,需与首帧或首尾帧同时使用。
wan2.7-i2vfirst_clip用于续写的首段视频,可与尾帧组合。
wan2.7-r2vreference_image参考图片。
wan2.7-r2vreference_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_idstring是创建任务时返回的 id 或 task_id。

调用示例

curl "https://api.example.com/api/v3/contents/generations/tasks/<task_id>" \ -H "Authorization: Bearer <YOUR_API_KEY>"

响应参数

字段类型说明
idstring任务 ID。
modelstring创建任务时使用的模型。
statusstring任务进度状态:queued、running、succeeded 或 failed。
created_atinteger任务创建时间,Unix 时间戳。
updated_atinteger任务状态更新时间,Unix 时间戳。
contentobject / null任务成功时返回结果对象,视频地址位于 content.video_url。
usageobject / null任务用量信息,可能为 null。
errorobject / 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