Wan
Endpoint: POST https://mps.intl.tencentcloudapi.comAction: CreateAigcVideoTask
Wan 是视频生成模型,支持文生视频、首帧 / 首尾帧生视频,以及图片(10 张)、视频(5 个)、音频(5 个)的多模态参考生成。3.0 系列时长 2~30 秒,最高 1080P 输出,可超分至 4K;另提供 2.2 版本。
基本信息
| 项目 | 值 |
|---|---|
| ModelName | Wan |
| ModelVersion | 3.0 / 3.0-prime / 2.2 |
| 安全护栏解除支持 | 支持 |
各版本支持规格
| 版本 | 分辨率 | 比例 | 时长 |
|---|---|---|---|
3.0 / 3.0-prime | 默认输出:480P / 720P / 1080P超分输出: 2K / 4K | 16:9 / 9:16 / 4:3 / 3:4 / 1:1 / adaptive | 2–30 秒;有参考视频时,输入+输出不超过 30 秒 |
输入条件
| 项目 | 条件 |
|---|---|
| 输出帧率 | 30fps |
| 参考图片 | 最多 10 张 |
| 参考视频 | 最多 5 个,合计 15 秒 |
| 参考音频 | 最多 5 个,合计 15 秒 |
3.0 为标准版本,3.0-prime 是在同等质量下提升处理速度的版本,2.2 为上一代版本。
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
ModelName | 必填 | String | 固定值 Wan |
ModelVersion | 选填 | String | 3.0 / 3.0-prime / 2.2 |
Prompt | 必填 | String | 生成提示词 |
ImageUrl | 选填 | String | 首帧图片 URL |
LastImageUrl | 选填 | String | 尾帧图片 URL。需与 ImageUrl 一起使用 |
Duration | 选填 | Integer | 生成时长(秒)。默认值 5 |
ExtraParameters | 选填 | Object | Resolution / AspectRatio |
AdditionalParameters | 选填 | String | 承载模型专属选项的 JSON 字符串。seed 的传递格式参见附加设置 |
ExtraParameters.EnablelnputComplianceCheck | 选填 | Boolean | 显式传入 false 可解除输入审核。使用前请咨询商务对接人 |
ExtraParameters.EnableOutputComplianceCheck | 选填 | Boolean | 显式传入 false 可解除输出审核。使用前请咨询商务对接人 |
请求示例
json
{
"ModelName": "Wan",
"ModelVersion": "3.0",
"Prompt": "a woman walks through a sunlit marketplace, camera follows behind her",
"Duration": 5,
"ExtraParameters": {
"Resolution": "1080P",
"AspectRatio": "16:9"
},
"Operator": "admin",
"StoreCosParam": {
"CosBucketName": "<bucket-appid>",
"CosBucketRegion": "<bucket-region>",
"CosBucketPath": "/aigc/"
}
}响应示例
json
{
"Response": {
"Status": "DONE",
"Message": "ok",
"Resolution": "1920x1080",
"VideoUrls": [
"https://aigc-output-video-<id>.cos.<region>.myqcloud.com/<file>.mp4?q-sign-algorithm=sha1&..."
],
"RequestId": "<request-id>"
}
}特殊设置
安全护栏解除
输入审核和输出审核可分别设置。
使用安全护栏解除参数前,需先联系商务对接人确认使用权限。即使是在支持的引擎上,也只有显式传入该参数时才会生效。省略该参数则不会解除。
| 参数 | 解除值 | 适用对象 |
|---|---|---|
ExtraParameters.EnablelnputComplianceCheck | false | 解除输入审核 |
ExtraParameters.EnableOutputComplianceCheck | false | 解除输出审核 |
将以下配置合并到已有的生成请求中。要同时解除输入和输出审核,需一并传入两个字段。
json
{
"ExtraParameters": {
"EnablelnputComplianceCheck": false,
"EnableOutputComplianceCheck": false
}
}输出分辨率
通过 ExtraParameters 的 Resolution 与 AspectRatio 指定。不同取值对应的输出分辨率如下。
| ModelVersion | Resolution | AspectRatio | 输出分辨率 |
|---|---|---|---|
3.0 | 1080P | 16:9 | 1920x1080 |
3.0-prime | 720P | 16:9 | 1280x720 |
2.2 | 720P | 16:9 | 1280x704 |
传入首帧图片时,输出比例与输入图片保持一致。
首/尾帧生成
分别在 ImageUrl 和 LastImageUrl 中指定图片 URL。
json
{
"ModelName": "Wan",
"ModelVersion": "3.0",
"ImageUrl": "https://<cdn>/first.png",
"LastImageUrl": "https://<cdn>/last.jpg",
"Prompt": "she opens the window and looks into the distance",
"Duration": 5,
"ExtraParameters": {
"Resolution": "720P"
},
"Operator": "admin",
"StoreCosParam": {
"CosBucketName": "<bucket-appid>",
"CosBucketRegion": "<bucket-region>",
"CosBucketPath": "/aigc/"
}
}