万相3.0-视频生成API
更新时间 2026-09-07 09:14:57
最近更新时间: 2026-09-07 09:14:57
本文介绍万相3.0-视频生成模型调用API。
模型简介
万相 3.0 视频生成是全能一体化视频生成大模型,统一支持文生视频、图生视频(首帧 / 首尾帧)、参考生视频、视频编辑、视频延长、文件 / 网页解析生成视频等能力。最大输出时长 30 秒,固定输出帧率 30fps。
支持模型
| 模型 | 版本说明 | 适用场景 |
|---|---|---|
| wan3.0‑video | 标准版 | 追求视频画面质量、动态细节,非强时延约束业务 |
| wan3.0‑video‑prime | 高速版 | 能力对齐标准版,生成速度更快,高并发、低时延诉求业务 |
调用流程
接口采用异步任务模式,分两步执行:
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 | 是 | 输入主体,prompt与media二选一必填 |
| input.prompt | string | 条件必选 | 生成描述; 参考模式支持图1、视频1、音频1引用 media 内素材 |
| input.media | array | 条件必选 | 媒体素材数组,数组项为素材对象 {type,url};不同 type 有组合互斥规则 |
| input.media[].type | string | 是 | 素材类型 - first_frame:首帧图像。最多1张,严格作为视频第一帧。 - last_frame:尾帧图像。最多1张,严格作为视频最后一帧。 - reference_image:参考图像。最多10张。 - reference_video:参考视频。最多5段,总时长不大于15秒。 - reference_audio:参考音频。最多5段,总时长不大于15秒。 - file:文件。最多1个,不可与 link 同时输入。 - link:网页链接。最多1个,不可与 file 同时输入。 |
| input.media[].url | string | 是 | 素材地址 |
| parameters | object | 否 | 视频生成参数 |
| parameters.resolution | string | 否 | 输出分辨率档位,默认1080P; 可选1080P/720P/480P |
| parameters.ratio | string | 否 | 宽高比,默认adaptive自适应; 可选16:9/4:3/1:1/3:4/9:16 |
| parameters.duration | integer | 否 | 输出时长秒 |
| parameters.audio | boolean | 否 | 是否输出音轨,默认 true; 开关音频计费一致 |
| parameters.prompt_extend | boolean | 否 | 是否开启 prompt 智能扩写 |
| 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 |
| usage | object | 用量统计,仅任务成功返回 |
| usage.input_video_duration | integer | 输入的视频的时长,单位秒 |
| usage.output_video_duration | integer | 输出视频的时长,单位秒 其值等同于 input.duration 的入参值。 |
| usage.duration | integer | 总的视频时长,用于计费。 等于 input_video_duration +output_video_duration。 |
| usage.fps | integer | 生成视频的帧率。默认值为30 |
| usage.SR | integer | 生成视频的分辨率档位。示例值:720。 |
| usage.video_count | integer | 生成视频的数量。固定为 1。 |
| usage.ratio | string | 生成视频的宽高比。示例值:16:9 |
请求/响应示例
文生视频创建任务
请求
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": "wan3.0-video",
"input": {
"prompt": "一只小猫在月光下的屋顶上奔跑,城市的霓虹灯在远处闪烁,电影级画质。"
},
"parameters": {
"resolution": "720P",
"ratio": "16:9",
"duration": 5,
"prompt_extend": true
}
}'正常响应
{
"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://xxx/xxx.mp4"
},
"usage": {
"video_count": 1,
"duration": 5.0,
"input_video_duration": 0.0,
"output_video_duration": 5.0,
"fps": 30,
"SR": 720,
"ratio": "16:9"
}
}