API介绍
来自通义万相的视频生成服务
API调试台
登录后，探索更多精彩功能！ 点击登录
API列表 (19)
| API描述 | 接口地址 | 请求方法 | 稳定性 | 参数说明 |
|---|---|---|---|---|
T2V（文字生成视频） | POST | 稳定 | 查看详情 | |
文档详情 根据文本提示词生成视频内容。支持多种模型和参数配置，包括视频分辨率、时长、音频配置等。 功能特性
异步处理本接口采用异步处理模式：
任务通常需要1-5分钟完成，具体时间取决于队列情况和服务负载。 价格： 请求参数 Header参数Authorizationstring必需 示例值: Bearer {{YOUR_API_KEY}}Content-Typeenum<string>必需 枚举值: application/json示例值: application/jsonBody参数 application/jsonmodelenum<string>必需 视频生成模型名称。不同模型具有不同的特性和价格。 模型说明：
枚举值: wanx2.1-t2v-turbowanx2.1-t2v-pluswan2.2-t2v-pluswan2.5-t2v-previewwan2.6-t2v示例值: wanx2.1-t2v-turboinputobject必需 输入参数，包含文本提示词和可选的音频文件 promptstring必需 文本提示词，用于描述期望生成的视频内容。支持中英文。 长度限制：
提示词建议：
示例：
示例值: 一只小猫在月光下奔跑negative_promptstring可选 反向提示词，用于描述不希望在视频中出现的内容。 长度限制: 最多500个字符 常用反向提示词：
示例值: 低分辨率、模糊、变形、多余的手指、比例不良audio_urlstring可选 自定义音频文件的URL地址。仅 wan2.5-t2v-preview 和 wan2.6-t2v 模型支持。 音频要求：
处理规则：
注意：提供 audio_url 时，parameters.audio 参数将被忽略。 示例值: https://example.com/audio/background-music.mp3parametersobject可选 视频生成的可选参数配置 sizeenum<string>可选 指定生成的视频分辨率，格式为宽*高。 重要： size必须设置为具体数值（如 1280*720），而不是 1:1或480P。 该参数的默认值和可用枚举值依赖于 model 参数，规则如下：
各档位分辨率明细：
枚举值: 832*480480*832624*6241280*720720*1280960*9601088*832832*10881920*10801080*19201440*14401632*12481248*1632示例值: 1280*720prompt_extendboolean可选 是否开启Prompt智能改写功能。 开启后，系统会自动优化和扩展您的提示词，使其更加详细和精确， 建议：对于简短的提示词，建议开启此功能。 示例值: trueaudioboolean可选 是否启用自动配音功能。仅 wan2.5-t2v-preview 和 wan2.6-t2v 模型支持。 注意：
示例值: truedurationenum<string>可选 视频时长（秒）。不同模型支持的时长选项不同。 模型支持情况：
注意：时长越长，费用越高。 枚举值: 3451015示例值: 5 | ||||
Tasks（获取任务结果） | GET | 稳定 | 查看详情 | |
文档详情 获取任务结果 价格：0 PTC/次 请求参数 Path参数task_idstring必需 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}} | ||||
wan-t2v（文字生成视频开源版） | POST | 稳定 | 查看详情 | |
文档详情 来自阿里最新的开源视频生成模型 价格：0.5 PTC/次 请求参数 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}}Content-Typestring可选 示例值: application/jsonBody参数 application/jsonpromptstring必需 提示词 aspect_ratioenum<string>可选 16:9 or 9:16 枚举值: 16:99:16 | ||||
wan-t2v（获取任务结果） | GET | 稳定 | 查看详情 | |
文档详情 来自阿里最新的开源视频生成模型 价格：0 PTC/次 请求参数 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}}Content-Typestring可选 示例值: application/jsonQuery参数request_idstring必需 | ||||
wan-i2v（图片生成视频开源版） | POST | 稳定 | 查看详情 | |
文档详情 来自阿里最新的开源视频生成模型 价格：0.5 PTC/次 请求参数 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}}Content-Typestring可选 示例值: application/jsonBody参数 application/jsonpromptstring必需 提示词 image_urlstring必需 inference_stepsinteger可选 2-40 | ||||
wan-i2v（获取任务结果） | GET | 稳定 | 查看详情 | |
文档详情 来自阿里最新的开源视频生成模型 价格：0 PTC/次 请求参数 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}}Content-Typestring可选 示例值: application/jsonQuery参数request_idstring必需 | ||||
wan-vace（视频编辑） | POST | 稳定 | 查看详情 | |
文档详情 来自阿里最新的开源视频编辑模型 价格：0.4 PTC/次 请求参数 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}}Content-Typestring可选 示例值: application/jsonBody参数 application/jsonpromptstring必需 提示词 negative_promptstring可选 num_framesinteger可选 81-240之间，默认81 frames_per_secondinteger可选 5-24之间，默认16 taskstring可选 depth或inpainting shiftinteger可选 1-10，默认5 resolutionstring可选 480p/580p/720p aspect_ratiostring可选 auto/16:9/9:16 num_inference_stepsinteger可选 2-40，默认30 video_urlstring可选 视频url mask_video_urlstring可选 遮罩视频url ref_image_urlsarray[string]可选 参考图片 enable_prompt_expansionboolean可选 是否开启提示词优化 | ||||
wan-vace（获取任务结果） | GET | 稳定 | 查看详情 | |
文档详情 来自阿里最新的开源视频编辑模型 价格：0 PTC/次 请求参数 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}}Content-Typestring可选 示例值: application/jsonQuery参数request_idstring必需 | ||||
wan2.2-a14b-t2v（文字生成视频） | POST | 稳定 | 查看详情 | |
文档详情 来自阿里最新的开源视频生成模型 价格：0.5 PTC/次 请求参数 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}}Content-Typestring可选 示例值: application/jsonBody参数 application/jsonpromptstring必需 提示词 aspect_ratioenum<string>可选 视频比例 枚举值: 16:99:161:1 | ||||
wan2.2-a14b-t2v（获取任务结果） | GET | 稳定 | 查看详情 | |
文档详情 来自阿里最新的开源视频生成模型 价格：0 PTC/次 请求参数 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}}Content-Typestring可选 示例值: application/jsonQuery参数request_idstring必需 | ||||
wan2.2-a14b-i2v（图片生成视频） | POST | 稳定 | 查看详情 | |
文档详情 来自阿里最新的开源视频生成模型 请求参数 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}}Content-Typestring可选 示例值: application/jsonBody参数 application/jsonpromptstring必需 提示词 image_urlstring必需 resolutionstring可选 设置分辨率 示例值: 480p | ||||
wan2.2-a14b-i2v（获取任务结果） | GET | 稳定 | 查看详情 | |
暂无数据 | ||||
wan2.2-5b-t2v（文字生成视频） | POST | 稳定 | 查看详情 | |
文档详情 来自阿里最新的开源视频生成模型 价格：0.2 PTC/次 请求参数 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}}Content-Typestring可选 示例值: application/jsonBody参数 application/jsonpromptstring必需 提示词 aspect_ratioenum<string>可选 视频比例 枚举值: 16:99:161:1 | ||||
wan2.2-5b-t2v（获取任务结果） | GET | 稳定 | 查看详情 | |
文档详情 来自阿里最新的开源视频生成模型 价格：0 PTC/次 请求参数 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}}Content-Typestring可选 示例值: application/jsonQuery参数request_idstring必需 | ||||
wan2.2-5b-i2v（图片生成视频） | POST | 稳定 | 查看详情 | |
文档详情 来自阿里最新的开源视频生成模型 请求参数 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}}Content-Typestring可选 示例值: application/jsonBody参数 application/jsonpromptstring必需 提示词 image_urlstring必需 resolutionstring可选 示例值: 580p | ||||
wan2.2-5b-i2v（获取任务结果） | GET | 稳定 | 查看详情 | |
文档详情 来自阿里最新的开源视频生成模型 价格：0 PTC/次 请求参数 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}}Content-Typestring可选 示例值: application/jsonQuery参数request_idstring必需 | ||||
阿里云文字生成视频 | POST | 稳定 | 查看详情 | |
文档详情 根据文本提示词生成视频内容。支持多种模型和参数配置，包括视频分辨率、时长、音频配置等。 功能特性
异步处理本接口采用异步处理模式：
任务通常需要1-5分钟完成，具体时间取决于队列情况和服务负载。 价格： 请求参数 Header参数Authorizationstring必需 示例值: Bearer {{YOUR_API_KEY}}Content-Typeenum<string>必需 枚举值: application/json示例值: application/jsonBody参数 application/jsonmodelenum<string>必需 视频生成模型名称。不同模型具有不同的特性和价格。 模型说明：
枚举值: wanx2.1-t2v-turbowanx2.1-t2v-pluswan2.2-t2v-pluswan2.5-t2v-previewwan2.6-t2v示例值: wanx2.1-t2v-turboinputobject必需 输入参数，包含文本提示词和可选的音频文件 promptstring必需 文本提示词，用于描述期望生成的视频内容。支持中英文。 长度限制：
提示词建议：
示例：
示例值: 一只小猫在月光下奔跑negative_promptstring可选 反向提示词，用于描述不希望在视频中出现的内容。 长度限制: 最多500个字符 常用反向提示词：
示例值: 低分辨率、模糊、变形、多余的手指、比例不良audio_urlstring可选 自定义音频文件的URL地址。仅 wan2.5-t2v-preview 和 wan2.6-t2v 模型支持。 音频要求：
处理规则：
注意：提供 audio_url 时，parameters.audio 参数将被忽略。 示例值: https://example.com/audio/background-music.mp3parametersobject可选 视频生成的可选参数配置 sizeenum<string>可选 指定生成的视频分辨率，格式为宽*高。 重要： size必须设置为具体数值（如 1280*720），而不是 1:1或480P。 该参数的默认值和可用枚举值依赖于 model 参数，规则如下：
各档位分辨率明细：
枚举值: 832*480480*832624*6241280*720720*1280960*9601088*832832*10881920*10801080*19201440*14401632*12481248*1632示例值: 1280*720prompt_extendboolean可选 是否开启Prompt智能改写功能。 开启后，系统会自动优化和扩展您的提示词，使其更加详细和精确， 建议：对于简短的提示词，建议开启此功能。 示例值: trueaudioboolean可选 是否启用自动配音功能。仅 wan2.5-t2v-preview 和 wan2.6-t2v 模型支持。 注意：
示例值: truedurationenum<string>可选 视频时长（秒）。不同模型支持的时长选项不同。 模型支持情况：
注意：时长越长，费用越高。 枚举值: 3451015示例值: 5 | ||||
阿里云图片生成视频 | 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-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 | 稳定 | 查看详情 | |
文档详情 获取任务结果 价格：0 PTC/次 请求参数 Path参数task_idstring必需 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}} | ||||
API价格表
| 模型 | 说明 | 302.AI价格 |
|---|
wanx2.1-t2v-turbo | 阿里云文字生成视频 |
|
wanx2.1-t2v-plus | 阿里云文字生成视频 |
|
wan2.2-t2v-plus(480p) | 阿里云文字生成视频 |
|
wan2.2-t2v-plus(1080p) | 阿里云文字生成视频 |
|
wanx2.1-i2v-turbo | 阿里云图片生成视频 |
|
wanx2.1-i2v-plus | 阿里云图片生成视频 |
|
wan2.2-i2v-plus(480p) | 阿里云图片生成视频 |
|
wan2.2-i2v-plus(1080p) | 阿里云图片生成视频 |
|
Tasks（获取任务结果） | 阿里云生成视频结果获取 |
|
wan2.2-a14b-t2v（文字生成视频） | 文字生成视频 |
|
wan2.2-a14b-t2v（获取任务结果） | 获取任务结果 |
|
wan2.2-a14b-i2v（图片生成视频） | 图片生成视频 |
|
wan2.2-a14b-i2v（获取任务结果） | 获取任务结果 |
|
wan2.2-5b-t2v（文字生成视频） | 图片生成视频 |
|
wan2.2-5b-t2v（获取任务结果） | 获取任务结果 |
|
wan2.2-5b-i2v（图片生成视频） | 图片生成视频 |
|
wan2.2-5b-i2v（获取任务结果） | 获取任务结果 |
|
T2V(turbo) | 文字生成视频 |
|
T2V(plus) | 文字生成视频 |
|
Tasks | 获取任务结果 |
|
wan-t2v（文字生成视频开源版） | 文字生成视频开源版 |
|
wan-t2v（获取任务结果） | 获取任务结果 |
|
wan-i2v（图片生成视频开源版） | 图片生成视频开源版 |
|
wan-i2v（获取任务结果） | 图片生成视频开源版 |
|
wan-vace（视频编辑） | 视频编辑开源版 |
|
wan-vace（获取任务结果） | 获取任务结果 |
|
