万相 Wan 视频生成 · 概述

文档版本：v1.0.0 | 最后更新：2026-07-22
本平台已完整适配通义万相（Wan）官方视频生成接口，请求与响应均为透传，参数语义与官方一致。

能力简介

万相视频生成支持以下任务类型：

任务类型	接口路径	说明
文生视频	`POST /ali/api/v1/services/aigc/video-generation/video-synthesis`	根据文本提示词生成视频，wan2.7/wan2.6 支持自动配音与多镜头叙事。
图生视频	`POST /ali/api/v1/services/aigc/video-generation/video-synthesis`	以图片为首帧生成视频；支持首尾帧过渡、音频驱动（wan2.7）。
参考生视频	`POST /ali/api/v1/services/aigc/video-generation/video-synthesis`	以参考图/参考视频中的主体形象为基准生成视频，提示词中可用 `[Image 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，需通过查询接口轮询状态；任务成功后响应中包含视频下载地址（有效期 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
        │  返回 output.video_url
        ▼
下载视频文件

接口地址

路径规则：在平台域名后追加渠道前缀 /ali，再拼接官方原始路径即可。
例如官方 https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
→ 平台 https://platform.shuyanai.com/ali/api/v1/services/aigc/video-generation/video-synthesis

鉴权

所有请求均通过 HTTP Authorization 头携带 Bearer Token 进行鉴权：

Authorization: Bearer {API_KEY}

{API_KEY} 为您在平台控制台创建的接口密钥。

请求头

头部	必填	说明
`Authorization`	是	`Bearer {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	按指令编辑，时长可继承输入视频
`wan2.6-t2v`	文生视频	video-generation	720P/1080P（size），2–15 秒
`wan2.6-i2v`、`wan2.6-i2v-flash`	图生视频	video-generation	480P–1080P（依模型），flash 为高性价比版
`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 秒
`wanx2.1-vace-plus`	通用视频编辑 VACE	video-generation	固定 720P、5 秒
`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	即时返回检测结果

实际可用模型以平台控制台模型列表为准。

任务状态值

状态	含义
`PENDING`	任务排队中
`RUNNING`	任务处理中
`SUCCEEDED`	任务执行成功
`FAILED`	任务执行失败
`CANCELED`	任务已取消
`UNKNOWN`	任务不存在或状态未知（task_id 不存在或已超 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://dashscope-result-sh.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx"
  },
  "usage": {
    "duration": 5,
    "video_count": 1,
    "SR": 1080
  }
}

生成的视频与 task_id 有效期均为 24 小时，请及时下载或转存。
生成耗时通常为 1–5 分钟（依模型与时长），建议以 15 秒左右的间隔轮询查询接口。

00-概述

万相 Wan 视频生成 · 概述

能力简介

标准调用流程

接口地址

鉴权

请求头

模型总览

任务状态值

响应格式

相关文档

00-概述

万相 Wan 视频生成 · 概述#

能力简介#

标准调用流程#

接口地址#

鉴权#

请求头#

模型总览#

任务状态值#

响应格式#

相关文档#

万相 Wan 视频生成 · 概述

能力简介

标准调用流程

接口地址

鉴权

请求头

模型总览

任务状态值

响应格式

相关文档