Qwen 万相视频换人（wan2.2-animate-mix）

说明
对外保持阿里官方风格路径与请求/响应结构，用于视频换人异步任务提交与查询。
https://help.aliyun.com/zh/model-studio/wan-animate-mix-api

1) 提交任务

Method：POST
路径：/qwen/api/v1/services/aigc/image2video/video-synthesis
Content-Type：application/json

请求头

Header	必填	说明
Authorization	是	平台 Token（直接传 token 字符串，不是 Bearer）。
X-DashScope-Async	建议	建议固定传 `enable`，保持与官方调用习惯一致。

请求体

字段	类型	必填	说明
model	string	是	固定 `wan2.2-animate-mix`
input.image_url	string	是	人物图片 URL
input.video_url	string	是	参考视频 URL
input.watermark	bool	否	是否加水印，默认 `false`
parameters.mode	string	否	`wan-std` / `wan-pro`，默认 `wan-std`
parameters.check_image	bool	否	是否图片检测，默认 `true`

提交成功响应示例

{
  "request_id": "e23e22a3-bc5f-4d03-877a-4b29b3f1f819",
  "output": {
    "task_id": "a3cb77b8-7f55-490e-9b69-a42d4010368e",
    "task_status": "PENDING"
  }
}

2) 查询任务

Method：GET
路径：/qwen/api/v1/tasks/{task_id}
也支持：/qwen/api/v1/tasks?task_id=xxx

请求头

Header	必填	说明
Authorization	是	平台 Token（直接传 token 字符串）。

说明：查询接口带 10 秒缓存（同一任务短时间重复查询会命中缓存）。

查询成功响应示例（完成）

{
  "output": {
    "end_time": "2026-02-28 22:53:43.654",
    "results": {
      "video_url": "http://dashscope-result-hz.oss-cn-hangzhou.aliyuncs.com/xxx.mp4?Expires=xxx"
    },
    "scheduled_time": "2026-02-28 22:52:33.267",
    "submit_time": "2026-02-28 22:52:24.474",
    "task_id": "a3cb77b8-7f55-490e-9b69-a42d4010368e",
    "task_status": "SUCCEEDED"
  },
  "request_id": "1e272167-1817-4c83-818c-202bb86f4f75",
  "usage": {
    "video_duration": 2.4,
    "video_ratio": "standard"
  }
}

状态说明

task_status	含义
PENDING	排队中
RUNNING	处理中
SUCCEEDED	成功
FAILED / CANCELED / UNKNOWN	失败

3) 错误返回格式

{
  "code": "InvalidParameter",
  "message": "parameters.mode 仅支持 wan-std 或 wan-pro",
  "request_id": "9f6a2d75c12f9f42"
}

常见错误码：

InvalidPath：路径错误

MethodNotAllowed：请求方法错误

InvalidParameter：参数错误

ModelNotSupported：模型不支持

ModelNotFound：模型未配置或未启用

NoAvailableGroup / NoAvailableProvider：无可用分组/源站

UpstreamRequestFailed：上游请求失败

UpstreamInvalidResponse：上游响应格式异常

TaskNotFound：任务不存在或已过期

4) 计费口径（当前实现）

该接口走自定义计费：先按 30 秒预扣。

任务成功后按 usage.video_duration 结算，退还差额。

任务失败：按失败逻辑回退。

任务日志口径：

扣费 = 预扣

退款 = 差额退款

实扣 = 扣费 - 退款

Qwen 万相视频换人（wan2.2-animate-mix）

1) 提交任务#

请求头#

请求体#

提交成功响应示例#

2) 查询任务#

请求头#

查询成功响应示例（完成）#

状态说明#

3) 错误返回格式#

4) 计费口径（当前实现）#