1. 万相
HBoom
  • 豆包
    • 视频生成
      • 创建视频生成任务(Seedance 2.0)
      • 查询视频生成任务列表
      • 查询单个视频生成任务
      • 删除视频生成任务
    • 图像生成
      • 图生图
    • 素材管理
      • Seedance SDK 接入示例
      • 真人认证
        • CreateVisualValidateSession 发起真人 H5 认证
        • GetVisualValidateResult 换取真人 GroupId(通常平台内部自动调用)
      • 素材
        • CreateAsset 入库素材(传 URL,异步)
        • GetAsset 查询素材状态(轮询)
        • ListAssets 列出素材(Filter 过滤)
        • UpdateAsset 更新素材(如备注名)
        • DeleteAsset 删除素材
      • 素材分组
        • ListAssetGroups 查询素材资产组合列表
        • CreateAssetGroup 建素材分组(虚拟人像 AIGC)
        • DeleteAssetGroup 删除素材分组
        • GetAssetGroup 查询单个分组信息
        • UpdateAssetGroup 更新分组(名称/描述)
  • 大模型
    • OpenAI
      • gpt-6-astra
      • Chat Completions(OpenAI 对话)
      • Images Generations(文生图)
      • Images Edits(图像编辑)
      • Models(列出平台可用模型)
    • Claude
      • claude-fable-5-1
    • Gemini
      • generateContent（流式）
      • gemini-omni-flash-preview 接口使用文档
      • generateContent(Gemini 原生)
      • gemini-3.8-flash
      • gemini-2.5-computer-use-preview-10-2025
  • 可灵
    • 文生视频
      POST
    • 查询任务列表
      GET
    • 查询单个任务（文生视频）
      GET
    • 多模态视频生成（omni）
      POST
    • 多图参考生视频
      POST
    • 动作控制生视频
      POST
    • 图生视频（含首尾帧）
      POST
    • 查询单个任务（图生视频）
      GET
    • 视频延长
      POST
    • 多模态视频编辑 · 初始化
      POST
    • 多模态视频编辑
      POST
  • Grok
    • 文生视频
      POST
    • 图生视频
      POST
    • 参考图生视频
      POST
    • 视频编辑
      POST
    • 视频延长
      POST
    • 查询视频结果
      GET
  • Vidu
    • 查询任务生成结果
    • 文生视频1080P有声
    • 图生视频1080P
    • 首尾帧生视频1080P
    • 参考文生视频720P
    • 参考文生图1080p
  • 万相
    • 参考生视频
      POST
    • 数字人视频
      POST
    • 查询任务
      GET
    • wan3.0-video-prime
      POST
  • 智谱
    • glm-5.3
    • glm-5.3-flash
  • MiniMax
    • MiniMax-H3_创建 H3-Context-IR 任务
    • MiniMax-H3_创建视频再生成任务
    • MiniMax-H3_取消或删除任务
    • MiniMax-H3_查询任务列表
    • MiniMax-H3_查询任务
    • MiniMax-H3_创建视频生成任务
  • deepseek
    • deepseek-flash
    • deepseek-v4-flash-vision-exp
    • deepseek-v4.1-flash
  • 腾讯混元
    • hy4-preview
  1. 万相

参考生视频

POST
/api/v1/services/aigc/video-generation/video-synthesis

03-参考生视频#

接口地址: https://gw.hbapis.com/ali/api/v1/services/aigc/video-generation/video-synthesis
以参考图片/参考视频中的主体形象（人物、角色、物品等）为基准生成视频，并在提示词中通过引用语法指定各参考素材的用途。适用于保持角色一致性的连续创作场景。
参考生视频包含两套协议，目前仅支持:wan2.7-r2v模型，请求体结构不同，注意区分：
模型协议参考素材字段提示词引用语法分辨率参数音频多镜头
wan2.7-r2v、wan2.7-r2v-2026-06-12新版input.media（对象数组，type + url）中文「图1 / 视频1」，英文「Image 1 / Video 1」，图与视频分别计数parameters.resolution（720P/1080P）默认生成有声视频，无需设置；支持 reference_voice 音色参考不支持 shot_type，在 prompt 中写分镜脚本实现
wan2.6-r2v旧版input.reference_urls（字符串数组）character1、character2（图和视频按数组顺序统一计数）parameters.size（宽*高，如 1280*720）不支持 audio 参数（仅 flash 版支持）parameters.shot_type（single/multi）
wan2.6-r2v-flash旧版同 wan2.6-r2v同上同上支持 audio（true 有声 / false 无声）同上

鉴权方式#

Bearer Token
在 Header 添加参数Authorization，其值为在 Bearer 之后拼接 Token
示例：
Authorization: Bearer ********************

请求参数#

请求头#

参数类型必填默认值说明
Content-Typestring是application/json数据交换格式
Authorizationstring是鉴权信息，Bearer {API_KEY}
官方要求的 X-DashScope-Async: enable 头由平台自动补充，调用时无需携带。

请求体 — wan2.7-r2v（新版协议）#

参数类型必填默认值说明
modelstring是wan2.7-r2v 或 wan2.7-r2v-2026-06-12
input.promptstring是提示词，中英文，≤5000 字符（超出截断） 引用语法见上文「提示词引用语法」
input.negative_promptstring否反向提示词，≤500 字符
input.mediaarray of object是参考素材数组。首帧图像最多 1 张；参考图像 + 参考视频至少 1 个且合计 ≤ 5；素材为主体角色时应仅含单一角色
input.media[].typestring是素材类型： reference_image — 参考图像（主体角色/场景参考） reference_video — 参考视频（主体角色 + 音色参考，不建议空镜） first_frame — 首帧图像（可与主体参考联合控制）
input.media[].urlstring是素材地址。图像支持公网 HTTP(S) URL 或 Base64（data:{MIME_type};base64,{data}）；视频支持公网 HTTP(S) URL
input.media[].reference_voicestring否音频 URL，指定该素材主体角色的音色（仅参考音色，与说话内容无关）。参考视频含音频且未指定时默认用视频原声；同时传入时 reference_voice 优先。建议音频语种与提示词语种一致
parameters.resolutionstring否1080P分辨率档位，可选 720P/1080P，影响费用
parameters.ratiostring否16:9宽高比，可选 16:9/9:16/1:1/4:3/3:4 已传首帧图像时自动忽略，按首帧宽高比生成近似比例
parameters.durationinteger否5视频时长（秒），影响费用 参考素材含视频时取 2–10 整数；不含视频时取 2–15 整数
parameters.prompt_extendboolean否true提示词智能改写，短提示词提升明显，但增加耗时
parameters.watermarkboolean否false右下角「AI生成」水印
parameters.seedinteger否随机取值 [0, 2147483647]；相同 seed 也不保证结果完全一致

请求体 — wan2.6-r2v（旧版协议）#

参数类型必填默认值说明
modelstring是wan2.6-r2v 或 wan2.6-r2v-flash
input.promptstring是提示词，≤1500 字符 用 character1、character2 引用参考角色（按数组顺序统一计数）
input.negative_promptstring否反向提示词，≤500 字符
input.reference_urlsarray of string是参考文件 URL 数组，图/视频混传：图像 0–5 个、视频 0–3 个、图像 + 视频合计 ≤ 5，影响费用 ⚠️ 旧字段 reference_video_urls 已废弃，请勿使用
parameters.sizestring否1920*1080输出分辨率，必须写具体像素「宽*高」（不能写 1:1 或 720P），影响费用 720P 档：1280*720(16:9)、720*1280(9:16)、960*960(1:1)、1088*832(4:3)、832*1088(3:4) 1080P 档：1920*1080(16:9)、1080*1920(9:16)、1440*1440(1:1)、1632*1248(4:3)、1248*1632(3:4)
parameters.durationinteger否5视频时长（秒），取 2–10 整数，影响费用
parameters.shot_typestring否single镜头类型：single 单镜头 / multi 多镜头；优先级高于 prompt 中的描述
parameters.audioboolean否true仅 wan2.6-r2v-flash 支持。true 有声 / false 无声（生成无声视频必须显式设为 false），影响费用
parameters.watermarkboolean否false右下角「AI生成」水印
parameters.seedinteger否随机取值 [0, 2147483647]

参考素材限制#

素材数量格式尺寸/时长大小
参考图像wan2.7：图 + 视频合计 ≤ 5；wan2.6：图 0–5 且图 + 视频合计 ≤ 5JPEG、JPG、PNG（不支持透明通道）、BMP、WEBP宽高 240–8000 px；wan2.7 要求宽高比 1:8–8:1≤ 20MB
参考视频wan2.7：图 + 视频合计 ≤ 5；wan2.6：视频 0–3MP4、MOV时长 1–30 秒；wan2.7 要求宽高 240–4096 px、宽高比 1:8–8:1≤ 100MB
首帧图像（仅 wan2.7 first_frame）最多 1 张同参考图像同参考图像≤ 20MB
参考音频（仅 wan2.7 reference_voice）每个素材可挂 1 个WAV、MP3时长 1–10 秒≤ 15MB

计费说明#

计费按查询结果中的 usage.duration 计算：duration = 输入参考视频时长 + 输出视频时长。即传入参考视频时，其时长也计入计费时长（例如输入参考视频 5 秒 + 输出 10 秒，按 15 秒计）。纯参考图输入时 input_video_duration 为 0。
影响费用的参数：分辨率（wan2.7 的 resolution / wan2.6 的 size，1080P 高于 720P）、duration、参考素材（wan2.6 的 reference_urls）、audio（仅 wan2.6-r2v-flash，有声/无声价格不同）。

请求示例#

返回响应 (200 成功)#

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

请求参数

Authorization
Bearer Token
在 Header 添加参数
Authorization
，其值为在 Bearer 之后拼接 Token
示例：
Authorization: Bearer ********************
or
API Key
在 header 添加参数
x-api-key
示例：
x-api-key: ********************
or
Header 参数

Body 参数application/json必填

示例
{
    "model": "wan2.7-r2v-2026-06-12",
    "input": {
        "prompt": "视频1抱着图3，在图4的椅子上弹奏一支舒缓的乡村民谣，并说道：“今天的阳光真好。”图1手中拿着图2，路过视频1，把手中的图2放到视频1旁边的桌子上，并说道：“真好听，能不能再唱一遍”。 ",
        "media": [
            {
                "type": "reference_image",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260408/sjuytr/wan-r2v-object-girl.jpg",
                "reference_voice": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260408/gbqewz/wan-r2v-girl-voice.mp3"
            },
            {
                "type": "reference_video",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qigswt/wan-r2v-role2.mp4",
                "reference_voice": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260408/isllrq/wan-r2v-boy-voice.mp3"
            },
            {
                "type": "reference_image",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/rtjeqf/wan-r2v-object3.png"
            },
            {
                "type": "reference_image",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qpzxps/wan-r2v-object4.png"
            },
            {
                "type": "reference_image",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/wfjikw/wan-r2v-backgroud5.png"
            }
        ]
    },
    "parameters": {
        "resolution": "720P",
        "ratio": "16:9",
        "duration": 10,
        "prompt_extend": false,
        "watermark": true
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "wan2.7-r2v-2026-06-12",
    "input": {
        "prompt": "视频1抱着图3，在图4的椅子上弹奏一支舒缓的乡村民谣，并说道：“今天的阳光真好。”图1手中拿着图2，路过视频1，把手中的图2放到视频1旁边的桌子上，并说道：“真好听，能不能再唱一遍”。 ",
        "media": [
            {
                "type": "reference_image",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260408/sjuytr/wan-r2v-object-girl.jpg",
                "reference_voice": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260408/gbqewz/wan-r2v-girl-voice.mp3"
            },
            {
                "type": "reference_video",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qigswt/wan-r2v-role2.mp4",
                "reference_voice": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260408/isllrq/wan-r2v-boy-voice.mp3"
            },
            {
                "type": "reference_image",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/rtjeqf/wan-r2v-object3.png"
            },
            {
                "type": "reference_image",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qpzxps/wan-r2v-object4.png"
            },
            {
                "type": "reference_image",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/wfjikw/wan-r2v-backgroud5.png"
            }
        ]
    },
    "parameters": {
        "resolution": "720P",
        "ratio": "16:9",
        "duration": 10,
        "prompt_extend": false,
        "watermark": true
    }
}'

返回响应

🟢200成功
application/json
成功
Bodyapplication/json

示例
{}
修改于 2026-08-26 07:24:34
上一页
参考文生图1080p
下一页
数字人视频
Built with