1. 概述
万相视频接口采用异步任务模式,创建成功后通过任务 ID 查询状态和视频地址。
baseUrl:https://token.soar.qjclouds.cn/laserEr/00000000/v1- 创建路径:
/video/generations/{apiType} - 查询路径:
/video/resource-actions/{apiType} - 鉴权:
Authorization: Bearer <api_key> - 请求体:阿里云原厂 API JSON 格式
2. 鉴权
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | string | 是 | Bearer <api_key> |
Content-Type | string | 是 | application/json |
3. 万相 3.0 生视频
3.1 文生视频
apiType:TextToVideo- 请求地址:
POST https://token.soar.qjclouds.cn/laserEr/00000000/v1/video/generations/TextToVideo
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型编码,以当前 API Key 已开通的万相视频模型为准。 |
input | object | 是 | 模型输入信息。 |
input.prompt | string | 条件必填 | 视频内容或编辑意图提示词;与 input.media 至少填写一项。 |
parameters | object | 否 | 视频处理参数。 |
parameters.resolution | string | 否 | 分辨率档位;万相 3.0 支持 480P、720P、1080P。 |
parameters.ratio | string | 否 | 宽高比;adaptive 自动适配素材,也可传模型支持的固定比例。 |
parameters.duration | integer | 否 | 输出时长(秒);万相 3.0 支持 2–30 秒,其他模型以实际能力为准。 |
parameters.prompt_extend | boolean | 否 | 是否启用提示词智能改写。 |
请求示例
JSON
{
"model": "wan3.0-video-cn",
"input": {
"prompt": "20秒21:9超宽银幕毛绒宇宙冒险片段,整体采用超精细毛绒材质、电影级太空尺度、可爱外形与强烈动作反差、夸张FPV运镜和真实软体物理。一艘由毛绒布、纽扣、拉链与填充棉制成的宇宙飞船,载着兔子、狐狸和乌鸦三只小型毛绒动物,在由巨大毛线行星、绒毛星云和布偶巨兽组成的宇宙中高速逃亡。一只覆盖深蓝长绒毛、眼睛像两枚玻璃纽扣的巨大星际鲸兽从星云中追赶飞船。动态包括拉链飞船弹射起航、贴着毛线行星高速绕行、巨鲸从后方冲出、穿越纽扣小行星带、被鲸兽吞入体内、沿金色拉链从背部逃出、巨鲸如泄掉填充棉般缓慢变扁、最终穿越粉紫色绒毛星云向彩色纽扣太阳飞去。"
},
"parameters": {
"resolution": "480P",
"ratio": "adaptive",
"duration": 20,
"prompt_extend": true
}
}响应参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
output.task_id | string | 是 | 任务 ID,用于查询状态和结果。 |
output.task_status | string | 是 | 初始状态,通常为 PENDING。 |
request_id | string | 是 | 请求唯一标识。 |
code | string | 否 | 失败时的错误码。 |
message | string | 否 | 失败时的错误详情。 |
响应示例
JSON
{
"output": {
"task_id": "d219e56f-ec03-47fd-b117-b4cc60949395",
"task_status": "PENDING"
},
"request_id": "ab017ef9-1494-474e-8b71-46679da8f373"
}3.2 图生视频
apiType:ImageToVideo- 请求地址:
POST https://token.soar.qjclouds.cn/laserEr/00000000/v1/video/generations/ImageToVideo
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型编码,以当前 API Key 已开通的万相视频模型为准。 |
input | object | 是 | 模型输入信息。 |
input.prompt | string | 条件必填 | 视频内容或编辑意图提示词;与 input.media 至少填写一项。 |
input.media | array<object> | 是 | 输入素材列表,顺序对应提示词中的图像或视频编号。 |
input.media[].type | string | 是 | first_frame、last_frame、reference_image、reference_video、reference_audio、file 或 link;可用值和组合随任务而异。 |
input.media[].url | string | 是 | 公网 HTTP/HTTPS URL,或原厂协议支持的临时 URL / Base64 数据。 |
parameters | object | 否 | 视频处理参数。 |
parameters.resolution | string | 否 | 分辨率档位;万相 3.0 支持 480P、720P、1080P。 |
parameters.ratio | string | 否 | 宽高比;adaptive 自动适配素材,也可传模型支持的固定比例。 |
parameters.duration | integer | 否 | 输出时长(秒);万相 3.0 支持 2–30 秒,其他模型以实际能力为准。 |
parameters.prompt_extend | boolean | 否 | 是否启用提示词智能改写。 |
请求示例
JSON
{
"model": "wan3.0-video-cn",
"input": {
"prompt": "wan3.0-video-cn",
"media": [
{
"type": "first_frame",
"url": "https://cdn.translate.alibaba.com/r/wanx-demo-1.png"
}
]
},
"parameters": {
"resolution": "720P",
"ratio": "adaptive",
"duration": 5
}
}响应参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
output.task_id | string | 是 | 任务 ID,用于查询状态和结果。 |
output.task_status | string | 是 | 初始状态,通常为 PENDING。 |
request_id | string | 是 | 请求唯一标识。 |
code | string | 否 | 失败时的错误码。 |
message | string | 否 | 失败时的错误详情。 |
响应示例
JSON
{
"output": {
"task_id": "2aa15572-bc3b-42fe-a642-309f9d5ffa8d",
"task_status": "PENDING"
},
"request_id": "c559b6cc-65e8-49f4-9c43-4d04387a901f"
}3.3 参考生视频
apiType:ReferenceToVideo- 请求地址:
POST https://token.soar.qjclouds.cn/laserEr/00000000/v1/video/generations/ReferenceToVideo
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型编码,以当前 API Key 已开通的万相视频模型为准。 |
input | object | 是 | 模型输入信息。 |
input.prompt | string | 条件必填 | 视频内容或编辑意图提示词;与 input.media 至少填写一项。 |
input.media | array<object> | 是 | 输入素材列表,顺序对应提示词中的图像或视频编号。 |
input.media[].type | string | 是 | first_frame、last_frame、reference_image、reference_video、reference_audio、file 或 link;可用值和组合随任务而异。 |
input.media[].url | string | 是 | 公网 HTTP/HTTPS URL,或原厂协议支持的临时 URL / Base64 数据。 |
parameters | object | 否 | 视频处理参数。 |
parameters.resolution | string | 否 | 分辨率档位;万相 3.0 支持 480P、720P、1080P。 |
parameters.ratio | string | 否 | 宽高比;adaptive 自动适配素材,也可传模型支持的固定比例。 |
parameters.duration | integer | 否 | 输出时长(秒);万相 3.0 支持 2–30 秒,其他模型以实际能力为准。 |
parameters.prompt_extend | boolean | 否 | 是否启用提示词智能改写。 |
请求示例
JSON
{
"model": "wan3.0-video-cn",
"input": {
"prompt": "视频1抱着图3,在图4的椅子上弹奏一支舒缓的乡村民谣,并说道:\"今天的阳光真好。\"图1手中拿着图2,路过视频1,把手中的图2放到视频1旁边的桌子上,并说道:\"真好听,能不能再唱一遍\"。",
"media": [
{"type": "reference_image", "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260408/sjuytr/wan-r2v-object-girl.jpg"},
{"type": "reference_video", "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qigswt/wan-r2v-role2.mp4"},
{"type": "reference_image", "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/rtjeqf/wan-r2v-object3.png"},
{"type": "reference_image", "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qpzxps/wan-r2v-object4.png"},
{"type": "reference_image", "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/wfjikw/wan-r2v-backgroud5.png"}
]
},
"parameters": {
"resolution": "720P",
"ratio": "adaptive",
"duration": 5
}
}响应参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
output.task_id | string | 是 | 任务 ID,用于查询状态和结果。 |
output.task_status | string | 是 | 初始状态,通常为 PENDING。 |
request_id | string | 是 | 请求唯一标识。 |
code | string | 否 | 失败时的错误码。 |
message | string | 否 | 失败时的错误详情。 |
响应示例
JSON
{
"output": {
"task_id": "723ce25f-c4ba-4996-a1e5-c2c4ef1199c9",
"task_status": "PENDING"
},
"request_id": "af4a3e0e-7592-4d5a-a427-13cf910afefd"
}3.4 参考生视频-基于文件
apiType:ReferenceToVideo- 请求地址:
POST https://token.soar.qjclouds.cn/laserEr/00000000/v1/video/generations/ReferenceToVideo
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型编码,以当前 API Key 已开通的万相视频模型为准。 |
input | object | 是 | 模型输入信息。 |
input.prompt | string | 条件必填 | 视频内容或编辑意图提示词;与 input.media 至少填写一项。 |
input.media | array<object> | 是 | 输入素材列表,顺序对应提示词中的图像或视频编号。 |
input.media[].type | string | 是 | first_frame、last_frame、reference_image、reference_video、reference_audio、file 或 link;可用值和组合随任务而异。 |
input.media[].url | string | 是 | 公网 HTTP/HTTPS URL,或原厂协议支持的临时 URL / Base64 数据。 |
parameters | object | 否 | 视频处理参数。 |
parameters.resolution | string | 否 | 分辨率档位;万相 3.0 支持 480P、720P、1080P。 |
parameters.ratio | string | 否 | 宽高比;adaptive 自动适配素材,也可传模型支持的固定比例。 |
parameters.duration | integer | 否 | 输出时长(秒);万相 3.0 支持 2–30 秒,其他模型以实际能力为准。 |
parameters.prompt_extend | boolean | 否 | 是否启用提示词智能改写。 |
请求示例
JSON
{
"model": "wan3.0-video-cn",
"input": {
"prompt": "一支高端智能眼镜产品广告,整体风格极简、未来感、时尚高级,光影克制,画面以黑色、银灰色、冰蓝色为主色调,局部点缀柔和白光与参数UI图形。开场在纯黑背景中,一副智能眼镜从黑暗中缓缓浮现,镜腿边缘掠过精致高光,镜框轮廓在冷冽边缘光下被勾勒出来,镜头超近距离掠过镜片、鼻托、转轴、镜腿与材质细节,展现金属与高性能复合材料的细腻质感,表面处理高级克制,线条轻薄流畅。随后产品在空中缓慢旋转,画面以极简动态图形同步展示核心参数信息。随后镜头快速收拢,所有零件精准回归组装成完整产品,切换到年轻模特佩戴展示,模特五官立体、气质自信,穿着简洁高级的都市时尚服装,在极简空间和城市光影环境中自然转头、抬手、行走、微笑,镜头从正面、侧面、斜后方展示眼镜佩戴状态,突出轻薄贴合、时尚轮廓与日常百搭属性。结尾在纯色背景中,产品悬浮定格,镜头缓慢推进到品牌logo和核心slogan,整体音乐极简电子氛围配合精准鼓点,节奏干净有力,画面质感高级、克制、纯粹,具有强烈品牌记忆点和国际化科技审美。",
"media": [
{
"type": "file",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260806/ebapmr/glass.pptx"
}
]
},
"parameters": {
"resolution": "480P",
"ratio": "adaptive",
"duration": 10,
"prompt_extend": true
}
}响应参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
output.task_id | string | 是 | 任务 ID,用于查询状态和结果。 |
output.task_status | string | 是 | 初始状态,通常为 PENDING。 |
request_id | string | 是 | 请求唯一标识。 |
code | string | 否 | 失败时的错误码。 |
message | string | 否 | 失败时的错误详情。 |
响应示例
JSON
{
"output": {
"task_id": "02b0ed72-14ea-4171-89ac-af63a0995589",
"task_status": "PENDING"
},
"request_id": "d93945c4-20f2-4d4d-917a-415fe351028b"
}3.5 视频编辑
apiType:VideoEdit- 请求地址:
POST https://token.soar.qjclouds.cn/laserEr/00000000/v1/video/generations/VideoEdit
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型编码,以当前 API Key 已开通的万相视频模型为准。 |
input | object | 是 | 模型输入信息。 |
input.prompt | string | 条件必填 | 视频内容或编辑意图提示词;与 input.media 至少填写一项。 |
input.media | array<object> | 是 | 输入素材列表,顺序对应提示词中的图像或视频编号。 |
input.media[].type | string | 是 | first_frame、last_frame、reference_image、reference_video、reference_audio、file 或 link;可用值和组合随任务而异。 |
input.media[].url | string | 是 | 公网 HTTP/HTTPS URL,或原厂协议支持的临时 URL / Base64 数据。 |
parameters | object | 否 | 视频处理参数。 |
parameters.resolution | string | 否 | 分辨率档位;万相 3.0 支持 480P、720P、1080P。 |
parameters.ratio | string | 否 | 宽高比;adaptive 自动适配素材,也可传模型支持的固定比例。 |
parameters.duration | integer | 否 | 输出时长(秒);万相 3.0 支持 2–30 秒,其他模型以实际能力为准。 |
parameters.prompt_extend | boolean | 否 | 是否启用提示词智能改写。 |
请求示例
JSON
{
"model": "wan3.0-video-cn",
"input": {
"prompt": "将整个画面转换为黏土风格",
"media": [
{
"type": "reference_video",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260402/ldnfdf/wan2.7-videoedit-style-change.mp4"
}
]
},
"parameters": {
"resolution": "720P",
"prompt_extend": true
}
}响应参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
output.task_id | string | 是 | 任务 ID,用于查询状态和结果。 |
output.task_status | string | 是 | 初始状态,通常为 PENDING。 |
request_id | string | 是 | 请求唯一标识。 |
code | string | 否 | 失败时的错误码。 |
message | string | 否 | 失败时的错误详情。 |
响应示例
JSON
{
"output": {
"task_id": "5d887993-7987-485f-888d-1568f5a9078f",
"task_status": "PENDING"
},
"request_id": "370c9a2e-ff3a-46aa-97ca-ffd444fa915a"
}4. 万相 2.7 生视频
4.1 文生视频
apiType:TextToVideo- 请求地址:
POST https://token.soar.qjclouds.cn/laserEr/00000000/v1/video/generations/TextToVideo
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型编码,以当前 API Key 已开通的万相视频模型为准。 |
input | object | 是 | 模型输入信息。 |
input.prompt | string | 条件必填 | 视频内容或编辑意图提示词;与 input.media 至少填写一项。 |
parameters | object | 否 | 视频处理参数。 |
parameters.resolution | string | 否 | 分辨率档位;万相 3.0 支持 480P、720P、1080P。 |
parameters.ratio | string | 否 | 宽高比;adaptive 自动适配素材,也可传模型支持的固定比例。 |
parameters.duration | integer | 否 | 输出时长(秒);万相 3.0 支持 2–30 秒,其他模型以实际能力为准。 |
parameters.prompt_extend | boolean | 否 | 是否启用提示词智能改写。 |
parameters.watermark | boolean | 否 | 是否添加 AI Generated 水印。 |
请求示例
JSON
{
"model": "wan2.7-t2v-cn",
"input": {
"prompt": "一只可爱的橘猫在草地上奔跑"
},
"parameters": {
"resolution": "720P",
"ratio": "16:9",
"prompt_extend": true,
"watermark": true,
"duration": 15
}
}响应参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
output.task_id | string | 是 | 任务 ID,用于查询状态和结果。 |
output.task_status | string | 是 | 初始状态,通常为 PENDING。 |
request_id | string | 是 | 请求唯一标识。 |
code | string | 否 | 失败时的错误码。 |
message | string | 否 | 失败时的错误详情。 |
响应示例
JSON
{
"output": {
"task_id": "0d9e7084-cdd7-4c63-a610-53d8d75f735f",
"task_status": "PENDING"
},
"request_id": "59b10c57-6380-498c-8026-4751d69170b0"
}4.2 图生视频
apiType:ImageToVideo- 请求地址:
POST https://token.soar.qjclouds.cn/laserEr/00000000/v1/video/generations/ImageToVideo
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型编码,以当前 API Key 已开通的万相视频模型为准。 |
input | object | 是 | 模型输入信息。 |
input.prompt | string | 条件必填 | 视频内容或编辑意图提示词;与 input.media 至少填写一项。 |
input.media | array<object> | 是 | 输入素材列表,顺序对应提示词中的图像或视频编号。 |
input.media[].type | string | 是 | first_frame、last_frame、reference_image、reference_video、reference_audio、file 或 link;可用值和组合随任务而异。 |
input.media[].url | string | 是 | 公网 HTTP/HTTPS URL,或原厂协议支持的临时 URL / Base64 数据。 |
parameters | object | 否 | 视频处理参数。 |
parameters.resolution | string | 否 | 分辨率档位;万相 3.0 支持 480P、720P、1080P。 |
parameters.ratio | string | 否 | 宽高比;adaptive 自动适配素材,也可传模型支持的固定比例。 |
parameters.duration | integer | 否 | 输出时长(秒);万相 3.0 支持 2–30 秒,其他模型以实际能力为准。 |
parameters.prompt_extend | boolean | 否 | 是否启用提示词智能改写。 |
parameters.watermark | boolean | 否 | 是否添加 AI Generated 水印。 |
请求示例
JSON
{
"model": "wan2.7-i2v-cn",
"input": {
"prompt": "一幅都市奇幻艺术的场景。一个充满动感的涂鸦艺术角色。一个由喷漆所画成的少年,正从一面混凝土墙上活过来。他一边用极快的语速演唱一首英文rap,一边摆着一个经典的、充满活力的说唱歌手姿势。场景设定在夜晚一个充满都市感的铁路桥下。灯光来自一盏孤零零的街灯,营造出电影般的氛围,充满高能量和惊人的细节。视频的音频部分完全由rap构成,没有其他对话或杂音。",
"media": [
{
"type": "first_frame",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png"
},
{
"type": "driving_audio",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/ozwpvi/rap.mp3"
}
]
},
"parameters": {
"resolution": "720P",
"duration": 2,
"prompt_extend": true,
"watermark": true
}
}响应参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
output.task_id | string | 是 | 任务 ID,用于查询状态和结果。 |
output.task_status | string | 是 | 初始状态,通常为 PENDING。 |
request_id | string | 是 | 请求唯一标识。 |
code | string | 否 | 失败时的错误码。 |
message | string | 否 | 失败时的错误详情。 |
响应示例
JSON
{
"output": {
"task_id": "eebd99b3-b941-44a9-b9b4-fea0d6d877e5",
"task_status": "PENDING"
},
"request_id": "83d45912-556a-4728-b26c-7a19d2e009da"
}4.3 参考生视频
apiType:ReferenceToVideo- 请求地址:
POST https://token.soar.qjclouds.cn/laserEr/00000000/v1/video/generations/ReferenceToVideo
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型编码,以当前 API Key 已开通的万相视频模型为准。 |
input | object | 是 | 模型输入信息。 |
input.prompt | string | 条件必填 | 视频内容或编辑意图提示词;与 input.media 至少填写一项。 |
input.media | array<object> | 是 | 输入素材列表,顺序对应提示词中的图像或视频编号。 |
input.media[].type | string | 是 | first_frame、last_frame、reference_image、reference_video、reference_audio、file 或 link;可用值和组合随任务而异。 |
input.media[].url | string | 是 | 公网 HTTP/HTTPS URL,或原厂协议支持的临时 URL / Base64 数据。 |
parameters | object | 否 | 视频处理参数。 |
parameters.resolution | string | 否 | 分辨率档位;万相 3.0 支持 480P、720P、1080P。 |
parameters.ratio | string | 否 | 宽高比;adaptive 自动适配素材,也可传模型支持的固定比例。 |
parameters.duration | integer | 否 | 输出时长(秒);万相 3.0 支持 2–30 秒,其他模型以实际能力为准。 |
parameters.prompt_extend | boolean | 否 | 是否启用提示词智能改写。 |
parameters.watermark | boolean | 否 | 是否添加 AI Generated 水印。 |
input.media[].reference_voice | string | 否 | 参考音色 URL,与参考图片或视频搭配使用。 |
请求示例
JSON
{
"model": "wan2.7-r2v-cn",
"input": {
"prompt": "视频1抱着图3,在图4的椅子上弹奏一支舒缓的乡村民谣,并说道:“今天的阳光真好。”图1手中拿着图2,路过视频1,把手中的图2放到视频1旁边的桌子上,并说道:“真好听,能不能再唱一遍”。 ",
"media": [
{
"type": "reference_image",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260408/sjuytr/wan-r2v-object-girl.jpg",
"reference_voice": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260408/gbqewz/wan-r2v-girl-voice.mp3"
},
{
"type": "reference_video",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qigswt/wan-r2v-role2.mp4",
"reference_voice": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260408/isllrq/wan-r2v-boy-voice.mp3"
},
{
"type": "reference_image",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/rtjeqf/wan-r2v-object3.png"
},
{
"type": "reference_image",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qpzxps/wan-r2v-object4.png"
},
{
"type": "reference_image",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/wfjikw/wan-r2v-backgroud5.png"
}
]
},
"parameters": {
"resolution": "720P",
"ratio": "16:9",
"duration": 2,
"prompt_extend": false,
"watermark": true
}
}响应参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
output.task_id | string | 是 | 任务 ID,用于查询状态和结果。 |
output.task_status | string | 是 | 初始状态,通常为 PENDING。 |
request_id | string | 是 | 请求唯一标识。 |
code | string | 否 | 失败时的错误码。 |
message | string | 否 | 失败时的错误详情。 |
响应示例
JSON
{
"output": {
"task_id": "5f9fa3d3-8072-45c5-8606-7b38a6e1b12d",
"task_status": "PENDING"
},
"request_id": "5a2a59da-d478-481e-b08f-b3583a5b6a0c"
}4.4 视频编辑
apiType:VideoEdit- 请求地址:
POST https://token.soar.qjclouds.cn/laserEr/00000000/v1/video/generations/VideoEdit
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型编码,以当前 API Key 已开通的万相 2.7 视频编辑模型为准。 |
input | object | 是 | 模型输入信息。 |
input.prompt | string | 是 | 视频编辑指令,描述需要修改的画面内容、风格或效果。 |
input.media | array<object> | 是 | 待编辑视频素材列表。 |
input.media[].type | string | 是 | 固定为 video。 |
input.media[].url | string | 是 | 待编辑视频的公网 HTTP/HTTPS URL,或原厂协议支持的临时 URL。 |
parameters | object | 否 | 视频编辑参数。 |
parameters.resolution | string | 否 | 输出分辨率档位,示例为 720P;具体可选值以模型能力为准。 |
parameters.prompt_extend | boolean | 否 | 是否启用提示词智能改写。 |
parameters.watermark | boolean | 否 | 是否在输出视频右下角添加“AI Generated”水印。 |
请求示例
JSON
{
"model": "wan2.7-videoedit-cn",
"input": {
"prompt": "将整个画面转换为黏土风格",
"media": [
{
"type": "video",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260402/ldnfdf/wan2.7-videoedit-style-change.mp4"
}
]
},
"parameters": {
"resolution": "720P",
"prompt_extend": true,
"watermark": true
}
}响应参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
output.task_id | string | 是 | 任务 ID,用于查询状态和结果。 |
output.task_status | string | 是 | 初始状态,创建成功通常为 PENDING。 |
request_id | string | 是 | 请求唯一标识,用于链路追踪和问题排查。 |
code | string | 否 | 请求失败时返回的错误码。 |
message | string | 否 | 请求失败时返回的错误详情。 |
响应示例
JSON
{
"output": {
"task_id": "7665350c-fa13-464d-a372-19f23ba1860f",
"task_status": "PENDING"
},
"request_id": "fee91905-fdde-46a8-a9db-fd03101a021a"
}5. 视频任务查询
apiType:QueryVideo- 请求地址:
POST https://token.soar.qjclouds.cn/laserEr/00000000/v1/video/resource-actions/QueryVideo
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 创建任务时使用的模型编码。 |
taskId | string | 是 | 创建任务返回的 output.task_id。 |
请求示例
JSON
{
"model": "wan3.0-video-cn",
"taskId": "5d887993-7987-485f-888d-1568f5a9078f"
}响应参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
output.task_id | string | 是 | 任务 ID。 |
output.task_status | string | 是 | PENDING、RUNNING、SUCCEEDED、FAILED、CANCELED 或 UNKNOWN。 |
output.submit_time | string | 否 | 提交时间。 |
output.scheduled_time | string | 否 | 调度时间。 |
output.end_time | string | 否 | 结束时间。 |
output.orig_prompt | string | 否 | 原始提示词。 |
output.video_url | string | 否 | 成功后的视频 URL,通常有效 24 小时。 |
usage | object | 否 | 用量与输出规格统计。 |
usage.input_video_duration | integer | 否 | 输入视频时长。 |
usage.output_video_duration | integer | 否 | 输出视频时长。 |
usage.video_count | integer | 否 | 输出数量。 |
usage.SR | integer | 否 | 分辨率档位。 |
request_id | string | 是 | 请求唯一标识。 |
响应示例
JSON
{
"output": {
"task_id": "5d887993-7987-485f-888d-1568f5a9078f",
"task_status": "SUCCEEDED",
"submit_time": "2026-09-11 10:10:01.903",
"scheduled_time": "2026-09-11 10:10:01.972",
"end_time": "2026-09-11 10:13:36.775",
"orig_prompt": "将整个画面转换为黏土风格",
"video_url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/1d/62/20260911/87820a8a/1563170-metadata_UiLhUKaE_daf37b2e2176.mp4?Expires=1789179215&OSSAccessKeyId=LTAI5tPxpiCM2hjmWrFXrym1&Signature=ENouvs7BPuadH8R7Z8KETg0w1OI%3D"
},
"usage": {
"duration": 10,
"resolution": null,
"size": null,
"input_video_duration": 5,
"output_video_duration": 5,
"video_count": 1,
"SR": 720,
"total_tokens": null
},
"request_id": "13bf4ae2-39cd-9145-a6c4-f2fd481b35ca"
}