参考图生视频：参考图/视频保持主体特征创建视频任务
curl --request POST \
--url https://api.apiyi.com/wan/api/v1/services/aigc/video-generation/video-synthesis \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-DashScope-Async: <x-dashscope-async>' \
--data '
{
"model": "wan2.7-r2v",
"input": {
"prompt": "一位身穿这件礼服的女孩在洒满夕阳的花园里缓步行走，微风轻拂裙摆，电影级光影",
"media": [
{
"type": "reference_image",
"url": "https://your-cdn.com/dress.png"
}
]
}
}
'{
"output": {
"task_id": "acda59b4-3b10-4789-a5e5-edadae48adcb",
"task_status": "PENDING"
},
"request_id": "..."
}Wan2.7 视频生成（阿里云）
Wan2.7 参考图生视频 API 参考
Wan2.7-r2v 参考图生视频 API 参考与在线调试：参考图/视频保持主体特征，支持多主体互动、音色参考与多宫格分镜。
POST
/
wan
/
api
/
v1
/
services
/
aigc
/
video-generation
/
video-synthesis
参考图生视频：参考图/视频保持主体特征创建视频任务
curl --request POST \
--url https://api.apiyi.com/wan/api/v1/services/aigc/video-generation/video-synthesis \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-DashScope-Async: <x-dashscope-async>' \
--data '
{
"model": "wan2.7-r2v",
"input": {
"prompt": "一位身穿这件礼服的女孩在洒满夕阳的花园里缓步行走，微风轻拂裙摆，电影级光影",
"media": [
{
"type": "reference_image",
"url": "https://your-cdn.com/dress.png"
}
]
}
}
'{
"output": {
"task_id": "acda59b4-3b10-4789-a5e5-edadae48adcb",
"task_status": "PENDING"
},
"request_id": "..."
}Documentation Index
Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
Use this file to discover all available pages before exploring further.
右侧 Playground 可直接调试：在 Authorization 填
Bearer sk-your-api-key，填好 model / input.media / parameters 后发起请求。提交成功返回 task_id，轮询与下载见下方说明。本页是
wan2.7-r2v（参考图生视频）的创建接口：给参考图/参考视频，模型保留其中的主体（人物/动物/物体）和场景特征，生成单角色表演或多角色互动视频。需要更多参考图（≤9 张）可考虑 HappyHorse r2v。完整异步流程见 Wan 概览。- 参考素材引用约定：prompt 中用「图1 / 图2」指代
reference_image、「视频1 / 视频2」指代reference_video，顺序与media数组一致（图和视频分别计数）。仅一张图/一个视频时可简写为「参考图片」「参考视频」。 - 数量限制：
reference_image+reference_video合计 ≤5；first_frame最多 1 张。 - 创建请求走
/wan/api/v1/...并带X-DashScope-Async: enable，不要用/v1/videos。
代码示例
curl -X POST "https://api.apiyi.com/wan/api/v1/services/aigc/video-generation/video-synthesis" \
-H "X-DashScope-Async: enable" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "wan2.7-r2v",
"input": {
"prompt": "一位身穿这件礼服的女孩在洒满夕阳的花园里缓步行走，微风轻拂裙摆，电影级光影",
"media": [
{"type": "reference_image", "url": "https://your-cdn.com/dress.png"}
]
},
"parameters": {"resolution": "720P", "duration": 5, "prompt_extend": true, "watermark": true}
}'
参数与媒体速查
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
model | string | ✓ | — | 固定 wan2.7-r2v |
input.prompt | string | ✓ | — | ≤5000 字符，用「图1/视频1」指代参考素材 |
input.media | array | ✓ | — | 见下方媒体表 |
parameters.resolution | string | 1080P | 720P / 1080P | |
parameters.ratio | string | 16:9 | 16:9 / 9:16 / 1:1 / 4:3 / 3:4（传首帧图时忽略） | |
parameters.duration | int | 5 | 含参考视频时 2–10；不含时 2–15 | |
parameters.prompt_extend | bool | true | 智能改写 | |
parameters.watermark | bool | false | 「AI 生成」水印 |
media[] 取值
type | 张数/限制 | 说明 |
|---|---|---|
reference_image | 与 video 合计 ≤5 | 参考图，提供主体（人物/动物/物体）或场景；可附 reference_voice 指定音色 |
reference_video | 与 image 合计 ≤5 | 参考视频，提供主体与音色参考；不建议传空镜视频 |
first_frame | ≤1 | 可选首帧，联合控制起始画面 |
reference_voice | 附属字段 | 附在某条 reference_image/reference_video 上，指定该主体音色（wav/mp3，1–10s） |
响应格式
{
"output": { "task_id": "acda59b4-3b10-4789-a5e5-edadae48adcb", "task_status": "PENDING" },
"request_id": "..."
}
提交后 轮询
GET /v1/tasks/{task_id} 直到 completed，再从 result_url 下载 mp4（不带 Authorization 头，24 小时过期）。参考生视频耗时通常 1–5 分钟，建议轮询间隔 10 秒、客户端超时 20 分钟。完整循环见 Wan 概览 · 异步调用流程。授权
在 API易控制台获取的 API Key
请求头
异步处理开关，必须设置为 enable
可用选项:
enable 请求体
application/json
此页面对您有帮助吗？
⌘I