API介绍
Wan2.7 Video 是阿里旗下的高性能视频生成旗舰模型，专为极致的视觉叙事与动态逼真度而生。该模型基于先进的视频扩散架构，不仅具备强大的指令理解力，更在视频的时间一致性、物理运动模拟及光影渲染上取得了突破性进展。Wan2.7 Video 能够从简单的自然语言描述出发，生成具有电影质感、符合物理规律的连续视频流，是影视创作、创意短片及广告视觉领域的顶级生产力工具。
───────────────────────────────────────────────────────────────────
核心能力
极致的动态逼真度： 完美平衡了画面精度与动态连贯性，有效解决了视频生成中常见的物体形变、背景闪烁等问题，确保成片具备专业级的视觉流畅度。
精准的物理规律模拟： 内置对复杂物理现象的深度理解，无论是人物的自然姿态、织物的纹理飘动，还是复杂的流体特效，都能在生成中精准还原现实质感。
强大的长叙事与分镜处理： 能够深刻理解长文本 Prompt 中的复杂场景逻辑，保持角色与环境的长期一致性，支持连贯的镜头语言，轻松构建具有叙事性的视频片段。
工业级生成效率： 针对生产场景进行深度优化，在保证高质量输出的前提下，极大提升了视频推理的响应速度，助力创作者在短时间内完成多版本创意迭代。
API调试台
登录后，探索更多精彩功能！ 点击登录
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可选 视频特效模板的名称。若未填写，表示不使用任何视频特效。 注意事项：
可用特效示例：
示例值: flyingparametersobject可选 视频生成参数设置，用于控制视频的分辨率、时长、音频等 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 | 稳定 | 查看详情 | |
文档详情 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可选 视频特效模板的名称。若未填写，表示不使用任何视频特效。 注意事项：
可用特效示例：
示例值: flyingparametersobject可选 视频生成参数设置，用于控制视频的分辨率、时长、音频等 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 生成”。
| ||||
API价格表
| 模型 | 说明 | 302.AI价格 |
|---|
wan2.7-i2v（图生成视频） | 720p |
|
wan2.7-i2v（图生成视频） | 1080p |
|
Tasks | 获取任务结果 |
|