通用视频编辑

做什么：同一个模型同时支持视频生成与通用编辑，输入可以是文本、图像、视频的组合。下面按功能分四种用法，提交方式一致，只是 input.function 与部分参数不同。

功能一 · 视频重绘（video_repainting）

按提示词把已有视频的画面重绘为新的风格。

curl

curl --location 'https://api.allyang.cn/qwen/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer <API-Key>" \
--header 'Content-Type: application/json' \
--data '{
    "model": "wanx2.1-vace-plus",
    "input": {
        "function": "video_repainting",
        "prompt": "<目标风格与画面描述>",
        "video_url": "<源视频地址>"
    },
    "parameters": {
        "prompt_extend": false,
        "control_condition": "depth"
    }
}'

功能二 · 局部编辑（video_edit）

给定视频、蒙版图与蒙版帧，只改蒙版指定区域。

curl

curl --location 'https://api.allyang.cn/qwen/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer <API-Key>" \
--header 'Content-Type: application/json' \
--data '{
    "model": "wanx2.1-vace-plus",
    "input": {
        "function": "video_edit",
        "prompt": "<局部修改描述>",
        "mask_image_url": "<蒙版图地址>",
        "video_url": "<源视频地址>",
        "mask_frame_id": 1
    },
    "parameters": {
        "prompt_extend": false,
        "mask_type": "tracking",
        "expand_ratio": 0.05
    }
}'

功能三 · 视频续写（video_extension）

以一段已有视频开头，向后延展生成新内容。

curl

curl --location 'https://api.allyang.cn/qwen/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer <API-Key>" \
--header 'Content-Type: application/json' \
--data '{
    "model": "wanx2.1-vace-plus",
    "input": {
        "function": "video_extension",
        "prompt": "<续写画面描述>",
        "first_clip_url": "<起始视频片段地址>"
    },
    "parameters": {
        "prompt_extend": false
    }
}'

功能四 · 画面扩展（video_outpainting）

向四周扩展画面，生成更大的画幅。

curl

curl --location 'https://api.allyang.cn/qwen/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer <API-Key>" \
--header 'Content-Type: application/json' \
--data '{
    "model": "wanx2.1-vace-plus",
    "input": {
        "function": "video_outpainting",
        "prompt": "<扩展后画面描述>",
        "video_url": "<源视频地址>"
    },
    "parameters": {
        "prompt_extend": false,
        "top_scale": 1.5,
        "bottom_scale": 1.5,
        "left_scale": 1.5,
        "right_scale": 1.5
    }
}'

查询任务

四种功能共用查询路径：

curl

curl -X GET https://api.allyang.cn/qwen/api/v1/tasks/<task_id> \
--header "Authorization: Bearer <API-Key>"

成功返回示例（含自动扩写前后的提示词对照）：

json

{
    "request_id": "851985d0-fbba-9d8d-a17a-xxxxxx",
    "output": {
        "task_id": "208e2fd1-fcb4-4adf-9fcc-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-05-15 16:14:44.723",
        "scheduled_time": "2025-05-15 16:14:44.750",
        "end_time": "2025-05-15 16:20:09.389",
        "video_url": "<生成视频地址>",
        "orig_prompt": "<你提交的原始提示词>",
        "actual_prompt": "<服务端扩写后实际使用的提示词>"
    },
    "usage": {
        "video_duration": 5,
        "video_ratio": "standard",
        "video_count": 1
    }
}

可用模型

模型名称	模型简介	输出视频格式
wanx2.1-vace-plus	万相 2.1 专业版；支持多模态输入、多图参考与视频编辑	时长最长 5 秒帧率 30 fps 格式 mp4（H.264 编码）

事实冲突与修正（重要）

源文档「视频画面扩展」示例中的请求地址被直接写成了上游服务域名，与其余示例使用本站域名不一致；本站已统一改为 https://api.allyang.cn/... 形式。
源文档注脚提到「使用华北 2（北京）地域模型需替换 URL」，属上游地域口径，与本站接入无关，已删除；本站侧只需使用统一域名。
上游控制台文档链接已移除（本站文档不保留外部链接）；如需该模型原始规范，请联系平台对接人。