万相(2.1-2.6)-文生视频API
更新时间 2026-09-06 17:31:44
最近更新时间: 2026-09-06 17:31:44
万相-文生视频模型基于 文本提示词 ,生成一段流畅的视频。
支持的模型
| 模型 ID | 简介 | 核心能力差异 |
|---|---|---|
| wan2.2‑t2v‑plus | 早期文生视频模型,输出无声视频,时长固定 5s | 不支持音频,视频时长固定 5 秒,支持 480P、1080P 分辨率,默认 1920*1080;prompt 最大 800 字符,默认无声视频 |
| wan2.5‑t2v‑preview | 预览版有声文生视频模型,支持自定义音频输入 | 支持音频输入 / 自动生成背景音乐;时长支持 5/10s;支持 480P/720P/1080P 分辨率;prompt 上限 1500 字符;默认生成有声视频 |
| wan2.6‑t2v | 新一代文生视频模型,支持多镜头叙事、自定义时长 | 支持单 / 多镜头切换;时长 2‑15s 可调;支持自定义音频、自动配乐;720P/1080P;prompt 上限 1500 字符;默认有声视频,shot_type实现多镜头叙事,需要开启prompt_extend:true |
调用流程
接口采用异步任务模式,分两步执行:
step1:调用创建任务接口,成功返回task_id
step2:调用查询任务接口查询对应task_id,直到task_status值为SUCCEEDED,获取生成视频url
接口详情
http调用
请求方式:POST
请求路径:https://ai.ctaigw.cn/v1/services/aigc/video-generation/video-synthesis
请求头
| 参数 | 必填 | 说明 |
|---|---|---|
| Content‑Type | 是 | 固定application/json |
| Authorization | 是 | Bearer ${YOUR_APP_KEY} |
| X‑DashScope‑Async | 是 | 必须enable |
请求参数
| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型调用名称或模型ID |
| input | object | 是 | 输入对象 |
| input.prompt | string | 是 | 正向提示词;wan2.2 最大 800 字符;wan2.5/wan2.6 最大 1500 字符,超出自动截断,中英文支持 |
| input.negative_prompt | string | 否 | 反向提示词,最大 500 字符,过滤不希望出现的画面内容 |
| input.audio_url | string | 否 | 仅 wan2.5‑t2v‑preview、wan2.6‑t2v 支持; 公网 http/https 或 oss 临时 url; 音频格式 mp3/wav,3‑30s,≤15MB; wan2.2 不支持音频参数 |
| parameters | object | 否 | 生成参数对象 |
| parameters.size | string | 否 | 分辨率,格式宽*高; - wan2.2‑t2v‑plus:480P、1080P 档位,默认1920*1080 - wan2.5‑t2v‑preview:480P/720P/1080P 档位,默认1920*1080 - wan2.6‑t2v:720P/1080P 档位,默认1920*1080 |
| parameters.duration | integer | 否 | 视频时长 - wan2.2‑t2v‑plus:固定 5s,不可修改 - wan2.5‑t2v‑preview:仅 5、10 可选,默认 5 - wan2.6‑t2v:2‑15 整数,默认 5 |
| parameters.prompt_extend | boolean | 否 | 是否开启 prompt 智能改写 |
| parameters.shot_type | string | 否 | 仅 wan2.6‑t2v 支持; single单镜头 (默认)、multi多镜头; 生效前提prompt_extend:true |
| parameters.watermark | boolean | 否 | 是否添加水印标识,水印位于视频右下角,文案固定为“AI生成”。 - false:默认值,不添加水印。 - true:添加水印。 |
| parameters.seed | integer | 否 | 随机种子 [0,2147483647]; 相同 seed 结果倾向稳定,但不能保证完全一致 |
响应参数
| 参数 | 类型 | 说明 |
|---|---|---|
| request_id | string | 请求唯一标识,用于问题排查溯源 |
| output | object | 任务输出主体 |
| output.task_id | string | 查询的任务 ID |
| output.task_status | string | 任务状态 - PENDING:任务排队中 - RUNNING:任务处理中 - SUCCEEDED:任务执行成功 - FAILED:任务执行失败 - CANCELED:任务已取消 - UNKNOWN:任务不存在或状态未知 |
查询任务接口详情
http调用
请求方式:GET
请求路径:https://ai.ctaigw.cn/v1/tasks/{task_id}
Path 路径参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| task_id | string | 是 | 创建异步任务接口返回的任务 ID |
请求头
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | 身份认证,格式:Bearer ${YOUR_APP_KEY} |
响应参数
| 参数 | 类型 | 说明 |
|---|---|---|
| request_id | string | 请求唯一标识,用于问题排查溯源 |
| output | object | 任务输出主体 |
| output.task_id | string | 查询的任务 ID |
| output.task_status | string | 任务状态 - PENDING:任务排队中 - RUNNING:任务处理中 - SUCCEEDED:任务执行成功 - FAILED:任务执行失败 - CANCELED:任务已取消 - UNKNOWN:任务不存在或状态未知 |
| output.submit_time | string | 任务提交时间,格式YYYY‑MM‑DD HH:mm:ss.SSS |
| output.scheduled_time | string | 任务调度执行时间 |
| output.end_time | string | 任务结束时间;任务未结束为空 |
| output.video_url | string | 视频URL。仅在 task_status 为 SUCCEEDED 时返回 |
| output.orig_prompt | string | 原始输入的prompt,对应请求参数prompt |
| output.actual_prompt | string | 当 prompt_extend=true 时,系统会对输入 prompt 进行智能改写,此字段返回实际用于生成的优化后 prompt。 - 若 prompt_extend=false,该字段不会返回。 - 注意:wan2.6 模型无论 prompt_extend 取值如何,均不返回此字段。 |
| usage | object | 用量统计,仅任务成功返回 |
| usage.input_video_duration | integer | 输入的视频的时长,单位秒 |
| usage.output_video_duration | integer | 输出视频的时长,单位秒 其值等同于 input.duration 的入参值。 |
| usage.duration | integer | 总的视频时长,用于计费。 等于 input_video_duration +output_video_duration。 仅在使用 wan2.6 模型时返回,用于计费。 |
| usage.SR | integer | 生成视频的分辨率档位。示例值:720。 |
| usage.video_count | integer | 生成视频的数量。固定为 1。 |
| usage.size | string | 仅在使用 wan2.6 模型时返回。生成视频的分辨率。格式为“宽高” |
| usage.video_ratio | string | 仅 wan2.5 及以下版本模型时返回。生成视频的分辨率。格式为“宽高” |
请求/响应示例
创建任务请求示例
请求
curl --location 'https://ai.ctaigw.cn/v1/services/aigc/video-generation/video-synthesis' \
-H 'X-DashScope-Async: enable' \
-H "Authorization: Bearer ${YOUR_APP_KEY}" \
-H 'Content-Type: application/json' \
-d '{
"model": "wan2.6-t2v",
"input": {
"prompt": "复古70年代地铁站,街头音乐家弹奏吉他,路人匆匆走过,镜头缓慢右移",
"audio_url": "https://aaaa.ctyun.cn/audio/01.mp3"
},
"parameters": {
"size": "1280*720",
"prompt_extend": true,
"duration": 10,
"shot_type":"multi"
}
}'正常响应
{
"output": {
"task_status": "PENDING",
"task_id": "xxxx‑xxxx‑xxxx‑xxxx"
},
"request_id": "00d06a841873c0a83bfaf1fae0184625"
}异常响应
{
"error": {
"type:": "Invalid_request",
"code": "missing_parameter",
"message": "Missing required parameters"
}
}查询任务请求示例
请求
curl -X GET https://ai.ctaigw.cn/v1/tasks/{task_id} \
--header "Authorization: Bearer ${YOUR_APP_KEY}"正常响应
{
"request_id": "00d06a841873c0a83bfaf1fae0184625",
"output": {
"task_id": "xxxx‑xxxx‑xxxx‑xxxx",
"task_status": "SUCCEEDED",
"submit_time": "2026-08-26 12:10:05.001",
"scheduled_time": "2026-08-26 12:10:05.201",
"end_time": "2026-08-26 12:10:25.001",
"orig_prompt": "小猫在草地上奔跑,风吹动毛发",
"video_url": "https://aaaa.ctyun.cn/xxx.mp4"
},
"usage": {
"duration": 10,
"input_video_duration": 0,
"output_video_duration": 10,
"video_count": 1,
"SR": 720
}
}