API介绍
通义万相 Wan2.2 由阿里巴巴通义团队推出，是一款开源的电影级视频生成模型。模型融合光影、色彩与镜头语言三大电影美学元素，并提供超60项可控参数，显著提升画面创作的可控性与效率。Wan2.2 单次可生成 5秒高清短视频，适合电影级片段、广告创意与数字内容生产，兼具开源属性与专业视觉效果，是内容创作者与企业在AIGC视频领域的高效工具。
API调试台
登录后，探索更多精彩功能！ 点击登录
API列表 (2)
| API描述 | 接口地址 | 请求方法 | 稳定性 | 参数说明 |
|---|---|---|---|---|
I2V（图生成视频阿里云） | POST | 稳定 | 查看详情 | |
文档详情 I2V（图片生成视频）API是阿里云通义万相提供的图生视频服务，支持将静态图片转换为动态视频内容。该API提供多个模型版本，满足不同的生成速度、画质和功能需求。 支持模型wanx2.1-i2v-turbo 生成速度更快，表现均衡。 主要功能特点多分辨率支持：提供480P、720P、1080P多种分辨率选项 异步处理本接口采用异步处理模式：
价格：wanx2.1-i2v-turbo 0.05 PTC/秒 请求参数 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}}Content-Typestring可选 示例值: application/jsonBody参数 application/jsonmodelenum<string>必需 模型名称，用于指定使用哪个图生视频模型。 枚举值: wanx2.1-i2v-turbowanx2.1-i2v-pluswan2.2-i2v-pluswan2.2-i2v-flashwan2.5-i2v-previewwan2.6-i2vwan2.7-i2v示例值: wan2.2-i2v-plusinputobject必需 输入的基本信息，包括提示词、图像、音频等 promptstring可选 文本提示词，用于描述生成视频中期望包含的元素和视觉特点。 支持语言：中英文 长度限制：
字符计算：每个汉字/字母占一个字符，超过部分会自动截断 特殊说明：当使用视频特效参数（template不为空）时，prompt参数无效，无需填写 示例值: 一只猫在草地上奔跑negative_promptstring可选 反向提示词，用于描述不希望在视频画面中看到的内容，可以对视频画面进行限制。 支持语言：中英文 长度限制：不超过500个字符，超过部分会自动截断 示例值: 低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良img_urlstring必需 首帧图像的URL或Base64编码数据（必填）。 图像格式：JPEG、JPG、PNG（不支持透明通道）、BMP、WEBP 图像分辨率：宽度和高度范围为[360, 2000]像素 文件大小：不超过10MB 输入方式：
本地文件：可通过上传文件获取临时URL 示例值: https://file.302.ai/gpt/imgs/20250610/5da3c994668c42908e45d74227f21e17.jpgaudio_urlstring可选 音频文件的URL，模型将使用该音频生成视频。 支持模型：wan2.6-i2v、wan2.5-i2v-preview 音频格式：wav、mp3 音频时长：3～30秒 文件大小：不超过15MB 协议支持：HTTP或HTTPS协议，本地文件可通过上传文件获取临时URL 超限处理：
示例值: https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250923/fttrns/%E9%94%A6%E7%91%9F.mp3reference_video_urlsarray[string]可选 参考视频URL列表。 支持模型：wan2.6-r2v 示例值: [
"https://cdn.wanx.aliyuncs.com/static/demo-wan26/vace.mp4"
]templatestring可选 视频特效模板的名称。若未填写，表示不使用任何视频特效。 注意事项：
可用特效示例：
示例值: flyingmediaarray[object]可选 typeenum<string>必需 枚举值: first_framelast_framedriving_audiofirst_clipurlstring必需 parametersobject可选 视频生成参数设置，用于控制视频的分辨率、时长、音频等 resolutionenum<string>可选 指定生成的视频分辨率档位，用于调整视频的清晰度（总像素）。 重要提示：resolution直接影响费用，同一模型：1080P > 720P > 480P 分辨率说明：
各模型支持的分辨率：
枚举值: 480P720P1080P示例值: 1080Pprompt_extendboolean可选 是否开启提示词智能改写功能。 功能说明：系统会自动优化和扩展用户输入的提示词，以获得更好的生成效果 默认值：true（默认开启） 示例值: trueaudioboolean可选 是否自动添加音频。 支持模型：wan2.5-i2v-preview、wan2.6-i2v 生效条件：仅当audio_url为空时生效 功能说明：
默认值：true（默认开启） 示例值: truedurationenum<integer>可选 视频时长设置（单位：秒）。 各模型支持的时长：
枚举值: 3451015shot_typeenum<string>可选 镜头类型设置。 支持模型：wan2.6-i2v 可选值：
枚举值: singlemulti示例值: multiseedinteger可选 随机数种子。取值范围为[0, 2147483647]。未指定时，系统自动生成随机种子。若需提升生成结果的可复现性，建议固定seed值。请注意，由于模型生成具有概率性，即使使用相同seed，也不能保证每次生成结果完全一致。
watermarkboolean可选 是否添加水印标识，水印位于视频右下角，文案固定为”AI 生成”。
| ||||
Tasks（获取任务结果） | GET | 稳定 | 查看详情 | |
文档详情 获取任务结果 价格：0 PTC/次 请求参数 Path参数task_idstring必需 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}} | ||||
API价格表
| 模型 | 说明 | 302.AI价格 |
|---|
wan2.2-i2v-plus 480p | 图生成视频 |
|
wan2.2-i2v-plus 1080p | 图生成视频 |
|
Tasks | 获取任务结果 |
|