万相 Wan 视频生成 · 概述

万相视频生成接口的请求与响应格式与万相官方接口一致（透传）。

能力简介

任务类型	接口路径	说明
文生视频	`POST /ali/api/v1/services/aigc/video-generation/video-synthesis`	根据文本提示词生成视频，wan2.7 支持自动配音与多镜头叙事
图生视频	`POST /ali/api/v1/services/aigc/video-generation/video-synthesis`	以图片为首帧生成视频；wan2.7 支持首尾帧、音频驱动、视频续写
参考生视频	`POST /ali/api/v1/services/aigc/video-generation/video-synthesis`	以参考图/参考视频中的主体形象生成视频，提示词中用「图1」「视频1」等引用
视频编辑	`POST /ali/api/v1/services/aigc/video-generation/video-synthesis`	对已有视频按指令编辑（改色、换景、增删元素等），wan2.7-videoedit
通用视频编辑 VACE	`POST /ali/api/v1/services/aigc/video-generation/video-synthesis`	多图参考、视频重绘、局部编辑、视频延展、画面扩展（wanx2.1-vace-plus）
首尾帧生视频	`POST /ali/api/v1/services/aigc/image2video/video-synthesis`	输入首帧与尾帧图片，生成中间过渡视频（kf2v 系列）
动作迁移 / 视频换人	`POST /ali/api/v1/services/aigc/image2video/video-synthesis`	让图片人物模仿视频动作（animate-move），或将视频中的人物替换为图片人物（animate-mix）
数字人视频	`POST /ali/api/v1/services/aigc/image2video/video-synthesis`	图片 + 音频生成数字人说话/演唱视频（wan2.2-s2v）
人脸检测	`POST /ali/api/v1/services/aigc/image2video/face-detect`	数字人前置检测，校验图片人脸是否可用（同步接口）
查询任务	`GET /ali/api/v1/tasks/{task_id}`	查询任务状态及结果

除人脸检测为同步接口外，其余均为异步任务：创建任务后返回 output.task_id，再通过查询接口轮询状态；任务成功后从 output.video_url 获取视频地址（有效期 24 小时），请及时下载或转存。

调用流程

创建任务  POST https://platform.shuyanai.com/ali/api/v1/services/aigc/video-generation/video-synthesis
          │  返回 output.task_id
          ▼
查询状态  GET https://platform.shuyanai.com/ali/api/v1/tasks/{task_id}   ← 轮询直至 SUCCEEDED 或 FAILED
          │  返回 output.video_url
          ▼
下载视频

接口地址

路径规则：在 https://platform.shuyanai.com 后加前缀 /ali，再拼接万相官方路径。例如官方 /api/v1/services/aigc/video-generation/video-synthesis 对应 https://platform.shuyanai.com/ali/api/v1/services/aigc/video-generation/video-synthesis。

鉴权与请求头

头部	必填	说明
`Authorization`	是	`Bearer sk-xxx`，`sk-xxx` 为控制台创建的 API Key
`Content-Type`	是	固定为 `application/json`

提示

官方要求的 X-DashScope-Async: enable 请求头由平台自动补充，调用时无需携带，携带也可以。

模型总览

模型	能力	提交端点	主要规格
`wan2.7-t2v`、`wan2.7-t2v-2026-06-12`	文生视频	video-generation	720P/1080P，2–15 秒，有声，多镜头
`wan2.7-i2v`	图生视频（首帧 / 首尾帧 / 音频驱动 / 视频续写）	video-generation	720P/1080P，2–15 秒，有声
`wan2.7-r2v`	参考生视频	video-generation	720P/1080P，2–15 秒
`wan2.7-videoedit`	视频编辑	video-generation	按指令编辑，时长可继承输入视频
`wanx2.1-vace-plus`	通用视频编辑 VACE	video-generation	固定 720P、5 秒
`wan2.6-t2v`	文生视频	video-generation	720P/1080P（size），2–15 秒
`wan2.6-i2v`、`wan2.6-i2v-flash`	图生视频	video-generation	720P/1080P
`wan2.6-r2v`	参考生视频	video-generation	720P/1080P
`wan2.5-t2v-preview`、`wan2.2-t2v-plus`、`wanx2.1-t2v-turbo`、`wanx2.1-t2v-plus`	文生视频（早期版本）	video-generation	分辨率档位依模型，固定或 5/10 秒
`wan2.2-kf2v-flash`、`wanx2.1-kf2v-plus`	首尾帧生视频	image2video	flash：480P/720P/1080P；plus：720P
`wan2.2-animate-move`、`wan2.2-animate-mix`	动作迁移 / 视频换人	image2video	`wan-std` / `wan-pro` 两种服务模式
`wan2.2-s2v`	数字人视频	image2video	480P/720P，时长由音频决定
`wan2.2-s2v-detect`	人脸检测（同步）	face-detect	即时返回检测结果

备注

当前在售型号为 wan2.7-t2v、wan2.7-i2v、wan2.7-r2v、wan2.7-videoedit、wanx2.1-vace-plus，以模型广场为准。表中其他型号暂未上架，调用会返回 model_not_found。

任务状态

状态	含义
`PENDING`	任务排队中
`RUNNING`	任务处理中
`SUCCEEDED`	任务执行成功
`FAILED`	任务执行失败
`CANCELED`	任务已取消
`UNKNOWN`	任务状态未知（如已超过 24 小时有效期）

状态流转：PENDING → RUNNING → SUCCEEDED / FAILED。

响应格式

创建任务：返回 task_id，用于查询。

{
  "output": {
    "task_status": "PENDING",
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
  },
  "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

查询任务：返回任务状态、视频地址与用量。

{
  "request_id": "caa62a12-xxxx",
  "output": {
    "task_id": "eff1443c-xxxx",
    "task_status": "SUCCEEDED",
    "video_url": "https://xxx.mp4?Expires=xxx"
  },
  "usage": {
    "duration": 5,
    "video_count": 1,
    "SR": 1080
  }
}

警告

参数缺失或不合法时，创建接口也可能返回 PENDING，随后查询结果为 FAILED，output.code 为 InvalidParameter，output.message 给出原因（如 Field required: input.prompt）。请以查询结果为准。

生成的视频与 task_id 有效期均为 24 小时。生成耗时通常为 1–5 分钟（依模型与时长），建议每 15 秒左右查询一次。

00-概述

万相 Wan 视频生成 · 概述

能力简介

调用流程

接口地址

鉴权与请求头

模型总览

任务状态

响应格式

相关文档

00-概述

万相 Wan 视频生成 · 概述#

能力简介#

调用流程#

接口地址#

鉴权与请求头#

模型总览#

任务状态#

响应格式#

相关文档#

万相 Wan 视频生成 · 概述

能力简介

调用流程

接口地址

鉴权与请求头

模型总览

任务状态

响应格式

相关文档