图转视频 V3 API 接口文档

POST/image/v3/make/imageToVideoapplication/json

请求体

generationModestring可选默认normal

生成模式：normal（默认）为普通模式；advanced 为高级模式，先生成分镜图，再生成视频。

productNamestring可选

商品名称，高级模式使用。

supplementaryRequirementsstring可选

制作补充要求，高级模式使用。

soundRequirementsstring可选

声音要求，高级模式使用。

textRequirementsstring可选

画面文字要求，高级模式使用。

imageUrlstring条件必填

原图地址（单图/首帧模式必传）

格式：jpg、jpeg、png、webp

happyhorse-v2 / minimax-h3-lite 不支持，其他模型的具体支持模式见下方各模型参数支持情况

imageListarray[string]条件必填

多图参考图列表；数量上限见下方各模型参数支持情况。imageUrl 与 imageList 通常二选一；happyhorse-v2 / minimax-h3-lite 必须传 imageList。

videoarray[string]可选

参考视频 URL 列表；支持模型、数量、格式及计费规则见下方参考视频

audioarray[string]可选

参考音频 URL 列表，仅用于自定义描述；支持模型、模型限制与素材组合见下方参考音频。

videoTypestring必填

模型类型；具体支持值见下方各模型参数支持情况

videoTimenumber可选

视频时长（秒）；支持值和默认值见下方各模型参数支持情况。

promptstring条件必填

普通模式为视频提示词，未传 templateKey 时必填；高级模式为可选创意描述，不填时根据商品资料自动构思。可灵模型最多 2500 字符，其他模型最多 4000 字符，超限拒绝。

promptOptimizerboolean可选默认false

是否开启提示词优化；支持范围见下方各模型参数支持情况。

isProboolean可选

是否开启高质量 / Pro 模式（已废弃，建议改用 resolution）；兼容规则见下方各模型参数支持情况

resolutionstring条件必填

视频分辨率；具体支持值、默认值及必传规则见下方各模型参数支持情况

voiceboolean可选

声音开关，仅对开放此参数的模型传入；原生音频输出不要求传此参数。未开放时请省略，不能用 false 请求静音；具体见下方各模型参数支持情况。

lastFrameImageUrlstring可选

尾帧图地址；具体支持模型及限制见下方各模型参数支持情况

aspectRatiostring条件必填

视频比例；具体支持值及必传/自适应规则见下方各模型参数支持情况

Seedance 2.5 的首帧、首尾帧及视频编辑/延长任务不支持自定义比例，详见下方比例限制。

camerastring可选

运镜参数；具体支持模型及可选值见下方各模型参数支持情况

templateKeystring可选

视频模板标识；不能与 generationMode=advanced 同时使用。传入后走模板模式，由服务端根据模板配置自动生成最终 prompt，无需手动传 prompt
固定可选值：
product-showcase：产品展示，适合多角度展示商品外观、材质、细节
ugc-seeding：UGC种草，适合用户视角真实分享体验
pain-solution：痛点解决，适合先呈现痛点再演示产品解决方案
furniture-scene：家居场景，适合展示家具/家居用品在真实室内空间中的摆放、搭配和使用效果
注意：与 prompt 互斥，传了 templateKey 则忽略 prompt

productInfostring可选

商品信息，供模板模式或高级模式使用。高级模式传入非空商品信息时跳过商品分析；未提供时自动分析商品图。建议填写已确认的材质、规格、卖点和使用场景
各模板关注维度：
• product-showcase：展示目标、外观重点、展示点、细节路径、场景化使用、主体锚点
• ugc-seeding：口播素材、推荐点、使用动作、人物/商品锚点、适用场景
• pain-solution：痛点、问题对象、前后状态、解决动作、可观察结果、口播素材
• furniture-scene：空间类型、房间布局、家具摆放、材质色彩、搭配元素、使用动作、光线氛围、镜头重点

languagestring可选默认中文

目标语言（模板模式或高级模式使用）；高级模式未传时默认中文

saleCountrystring可选

销售国家/地区（模板模式或高级模式使用），无默认值

useAssetWhitelistboolean可选默认true

是否使用素材库加白；省略或 null 同默认。true 使用素材库资产，false 直接提交素材 URL；预检规则及人脸审核风险见下方Seedance 素材加白。

高级模式

限时免费：高级模式的分镜生成流程限时免费，视频生成仍按所选模型的原有标准扣点。

将 generationMode 设为 advanced，任务会先生成分镜图，再生成视频。其他参数和结果查询方式沿用普通模式。

请求示例仅比普通模式增加 "generationMode": "advanced"：

JSON

{
  "generationMode": "advanced",
  "imageList": [
    "https://example.com/product-main.jpg",
    "https://example.com/product-detail.jpg"
  ],
  "videoType": "doubao-seedance-2-0",
  "videoTime": 10,
  "prompt": "展示商品外观与使用场景，镜头缓慢推进",
  "resolution": "720p",
  "aspectRatio": "9:16"
}

Seedance 素材加白

useAssetWhitelist 用于选择参考素材进入素材库加白，还是直接以 URL 提交模型，放在本页请求体中，与 videoType 同级。支持情况以所选模型为准。

取值	具体用途与提交方式	预检规则
`true`（默认）	需要入库的参考图片/视频先上传素材库，再用资产 ID 提交，适合需要素材库人像加白的场景。	入库参考图片按素材库限制整组预检后再上传；视频保留已有时长、数量、格式、大小等业务约束，不套用图片像素规则。
`false`	关闭自动入库和历史资产 ID 复用，直接使用素材 URL，适合希望按当前模型规格直传的场景。	按当前模型配置的尺寸、比例、大小、格式、时长等限制预检。

素材库参考图片要求：宽和高均为 300～6000 像素（含边界），宽高比 2:5～5:2（含边界），单张小于 30 MiB（供应商文档标为 30 MB）；支持 JPEG（含 JPG）、PNG、WEBP、TIFF（含 TIF）、GIF、HEIC/HEIF。该规格仅用于图片入库，素材数量、时长及组合等业务约束仍按模型校验。依据：私域虚拟人像素材资产库使用指南。

纯首帧或首尾帧模式保留 first_frame/last_frame 的 URL 语义，即使 useAssetWhitelist=true 也按模型规则预检；此开关不会把首尾帧转换成参考图资产。

人脸审核风险：关闭加白时，包含人脸或真人肖像的素材可能被供应商审核拒绝；开启加白仍须通过素材库和模型审核，不能保证成功。尺寸等预检通过不代表内容审核通过。

如需关闭加白，在本页完整请求中加入 "useAssetWhitelist": false；省略或传 null 均按 true 处理。

各模型参数支持情况

原生有声模型无需传 voice 或参考音频 audio 即可生成声音。仅支持声音开关的模型可传 voice；其他模型请省略，不能用 false 请求静音。参考音频是可选素材，支持范围见素材规则。

模型	分辨率	时长（秒）	参考图 / 帧上限	参考素材模式	生成能力	比例
正在读取模型配置...

Seedance 2.5 比例限制

模型参数中的比例选项不适用于所有任务。Seedance 2.5 在以下场景仅支持自适应，不支持指定固定比例：

任务	aspectRatio	输出比例
首帧生视频	`adaptive` 或不传	跟随首帧图片
首尾帧生视频	`adaptive` 或不传	跟随首帧图片
视频编辑/延长	`adaptive` 或不传	跟随待编辑或延长的原视频

文生视频和普通参考生成仍按当前模型参数选择比例。参考图不等于首帧图片，请按实际任务模式使用。

参考视频

OpenAPI V3 参数边界

本接口使用 imageList 传参考图片，使用 video 传参考视频。video 是 URL 数组，当前公开契约最多支持 1 段参考视频。

素材类型	OpenAPI 参数	支持模型	数量与主要限制
参考图片	`imageList`	见上方请求体中的 `imageList`	数量上限由模型配置决定
参考视频	`video`	doubao-seedance-2-0 / doubao-seedance-2-0-fast / doubao-seedance-2-0-mini / doubao-seedance-2-5 / WAN3	最多 1 段，支持 mp4 / mov

参考视频限制

模型	时长	文件大小	编码 / 画面限制
doubao-seedance-2-0 / doubao-seedance-2-0-fast / doubao-seedance-2-0-mini	1～15 秒	最大 200 MB	H.264/AVC 或 H.265/HEVC；24～60 FPS；单边 300～6000 像素；宽高比 0.4～2.5
doubao-seedance-2-5	1～30 秒	最大 200 MB	H.264/AVC 或 H.265/HEVC；24～60 FPS；单边 300～6000 像素；宽高比 0.4～2.5
WAN3	1～15 秒	最大 100 MB	单边 240～4096 像素；宽高比 1:8～8:1；参考视频时长与输出时长之和不超过 30 秒

实际支持情况以当前环境已发布的图转视频模型配置为准；模型未开放参考视频能力时，提交 video 可能创建失败或不生效。

参考视频计费规则

当 video 传入有效参考视频时，doubao-seedance-2-0、doubao-seedance-2-0-fast、doubao-seedance-2-0-mini、doubao-seedance-2-5 和 WAN3 的基础扣点按 2 倍计算。
基础扣点仍按目标模型已发布配置中的 resolution 和 videoTime 计算，再乘以参考视频倍率；不传参考视频时不加倍。
当前最多支持 1 段参考视频，传入空数组或空白 URL 不计为参考视频。

素材组合规则

参考视频用于补充动作、运镜和节奏，不替代图转视频的商品图片；通常应传 imageUrl 或 imageList。
imageUrl 与 imageList 只能选择一种；使用多张参考图片时传 imageList。
video 可与 imageUrl 或 imageList 一起使用；不要同时传 lastFrameImageUrl，参考素材模式与首尾帧模式互斥，WAN3 会以参考素材模式为准并移除首尾帧输入。
提示词中直接用自然语言描述如何参考视频，例如“参考视频的镜头节奏和动作”；参考视频请通过请求体中的 video 参数传入。
参考视频 URL 必须在任务处理期间保持可访问，建议使用稳定的 HTTPS 地址。

参考视频请求示例

JSON

{
  "imageList": [
    "https://example.com/product-main.jpg",
    "https://example.com/product-detail.jpg"
  ],
  "video": [
    "https://example.com/reference.mp4"
  ],
  "videoType": "doubao-seedance-2-5",
  "videoTime": 15,
  "prompt": "保持商品主体一致，参考视频的运镜节奏和动作展示商品细节",
  "resolution": "720p",
  "aspectRatio": "9:16"
}

参考音频

OpenAPI V3 参数边界

使用顶层 audio 传入参考音频 URL 数组，例如 "audio": ["https://example.com/beat.mp3"]。支持 Seedance 2.0、2.0 Fast、2.0 Mini、2.5、WAN3 和 Vidu Q4。audio 是参考音频输入，不是启用音频输出的必填项；voice 仅用于已开放的声音开关，两者相互独立。参考音频用于自定义描述，请同时传 prompt，说明音频怎样影响画面或声音；视频模板模式不支持参考音频，不要传 templateKey。

参考音频限制

模型（videoType）	最多段数	时长限制	格式、大小与输入要求
doubao-seedance-2-0 doubao-seedance-2-0-fast doubao-seedance-2-0-mini	3 段	每段 2～15 秒；累计 ≤15 秒	mp3 / wav，单文件 ≤15 MB；须同时提供图片
doubao-seedance-2-5	10 段	每段 2～30 秒；累计 ≤30 秒	mp3 / wav，单文件 ≤15 MB；可只传音频
WAN3	5 段	每段 1～15 秒；累计 ≤15 秒	mp3 / wav，单文件 ≤15 MB；须同时提供图片、参考视频或参考文档
viduq4-preview	3 段	以当前模型配置为准	mp3，单文件 ≤50 MB；须同时提供至少一张图片

累计时长是本次请求中所有音频时长之和，例如 Seedance 2.0 的两段音频各 10 秒，合计 20 秒会超限。实际支持情况以当前环境生效的图转视频模型配置为准；未启用参考音频的模型会拒绝请求。

音频地址与校验

支持可直接访问的外部 HTTP(S) 音频链接和本系统 OSS URL。外链会先下载转存到系统 OSS；链接须在任务创建期间可访问，无需额外登录。
外链 URL 路径须以 .mp3 或 .wav 结尾，可带查询参数。服务端按实际媒体格式、文件大小和时长校验；后缀与内容不符、无法读取媒体信息或超过模型限制都会失败。
本接口应传入音频链接数组，不支持站内素材对象格式。

素材组合与计费

audio 可与当前模型支持的 imageUrl、imageList 或 video 组合；imageUrl 与 imageList 通常只能选一种，viduq4-preview 同传时列表优先。Seedance 2.5 可只传音频；WAN3 可用参考视频或参考文档代替图片，但不能只传音频。
audio 不能与 lastFrameImageUrl 同传，参考素材模式与首尾帧模式互斥。
仅提交参考音频不触发参考视频的 2 倍扣点；若同时提交有效参考视频，按上方参考视频计费规则计算。

参考音频请求示例

Seedance 2.0：商品图 + 参考音频

JSON

{
  "imageUrl": "https://example.com/product.jpg",
  "audio": ["https://example.com/beat.mp3"],
  "videoType": "doubao-seedance-2-0",
  "videoTime": 10,
  "prompt": "保持商品外观，让镜头切换跟随参考音频的节奏",
  "resolution": "720p",
  "aspectRatio": "9:16"
}

Seedance 2.5：仅参考音频

JSON

{
  "audio": ["https://example.com/beat.mp3"],
  "videoType": "doubao-seedance-2-5",
  "videoTime": 10,
  "prompt": "根据参考音频的节奏生成商品展示视频",
  "resolution": "720p",
  "aspectRatio": "9:16"
}

WAN3：商品图 + 参考音频

JSON

{
  "imageUrl": "https://example.com/product.jpg",
  "audio": ["https://example.com/reference.wav"],
  "videoType": "WAN3",
  "videoTime": 10,
  "prompt": "保持商品外观，让画面动作跟随参考音频的节奏",
  "resolution": "720p",
  "aspectRatio": "9:16"
}

Vidu Q4：参考图 + 参考音频

JSON

{
  "videoType": "viduq4-preview",
  "imageList": [
    "https://example.com/product.jpg",
    "https://example.com/detail.jpg"
  ],
  "audio": [
    "https://example.com/beat.mp3"
  ],
  "prompt": "保持商品主体一致，画面动作跟随参考音频的节奏",
  "videoTime": 5,
  "resolution": "1080P",
  "aspectRatio": "9:16"
}

请求示例

示例 1：kling-v2-6（可灵 V2.6）— 单图首帧 + 1080p + 声音

JSON

{
  "imageUrl": "https://example.com/image.jpeg",
  "videoType": "kling-v2-6",
  "videoTime": 10,
  "prompt": "商品展示视频",
  "resolution": "1080p",
  "voice": true
}

示例 2：kling-v2-6（可灵 V2.6）— 多图模式 10 秒

JSON

{
  "imageList": [
    "https://example.com/image1.jpeg",
    "https://example.com/image2.jpeg"
  ],
  "videoType": "kling-v2-6",
  "videoTime": 10,
  "prompt": "一只白色比熊穿着红色花棉袄",
  "resolution": "720p"
}

示例 3：wan3 — 5 秒短视频

JSON

{
  "imageUrl": "https://example.com/image.jpeg",
  "videoType": "wan3",
  "videoTime": 5,
  "prompt": "商品展示视频",
  "resolution": "720P"
}

示例 4：happyhorse-v2 — 多图参考生视频

JSON

{
  "imageList": [
    "https://example.com/product1.jpg",
    "https://example.com/product2.jpg",
    "https://example.com/product3.jpg"
  ],
  "videoType": "happyhorse-v2",
  "videoTime": 10,
  "prompt": "商品展示视频",
  "resolution": "1080p",
  "aspectRatio": "16:9"
}

示例 5：doubao-seedance-2-0-mini（豆包 Seedance 2.0 Mini）— 多图模式

JSON

{
  "imageList": [
    "https://example.com/product1.jpg",
    "https://example.com/product2.jpg"
  ],
  "videoType": "doubao-seedance-2-0-mini",
  "videoTime": 10,
  "prompt": "商品展示视频",
  "aspectRatio": "9:16",
  "resolution": "720p"
}

示例 6：kling-v3-omni（可灵 V3-Omni）— 首尾帧模式

JSON

{
  "imageUrl": "https://example.com/first-frame.jpg",
  "lastFrameImageUrl": "https://example.com/last-frame.jpg",
  "videoType": "kling-v3-omni",
  "videoTime": 10,
  "prompt": "商品从展示台缓缓旋转",
  "resolution": "1080p"
}

示例 7：kling-v3-omni（可灵 V3-Omni）— 多图参考图模式

JSON

{
  "imageList": [
    "https://example.com/product1.jpg",
    "https://example.com/product2.jpg",
    "https://example.com/product3.jpg"
  ],
  "videoType": "kling-v3-omni",
  "videoTime": 10,
  "prompt": "商品多角度展示",
  "aspectRatio": "16:9",
  "resolution": "720p"
}

示例 8：模板模式 — 产品展示模板 + doubao-seedance-2-0 多图

JSON

{
  "imageList": [
    "https://example.com/product1.jpg",
    "https://example.com/product2.jpg",
    "https://example.com/product3.jpg"
  ],
  "videoType": "doubao-seedance-2-0",
  "videoTime": 10,
  "resolution": "720p",
  "aspectRatio": "16:9",
  "templateKey": "product-showcase",
  "productInfo": "[展示目标]：展示无线蓝牙耳机的时尚外观和佩戴效果\n[外观重点]：磨砂质感充电仓和金属LOGO\n[展示点]：耳机从充电仓取出→佩戴→触控操作\n[细节路径]：耳塞硅胶套特写→充电仓磁吸开合→LED指示灯\n[场景化使用]：通勤地铁上使用\n[主体锚点]：耳机主体居中",
  "language": "中文",
  "saleCountry": "中国"
}

示例 9：doubao-seedance-2-5（豆包 Seedance 2.5）— 30 秒长视频 + 多图

JSON

{
  "imageList": [
    "https://example.com/product1.jpg",
    "https://example.com/product2.jpg",
    "https://example.com/product3.jpg"
  ],
  "videoType": "doubao-seedance-2-5",
  "videoTime": 30,
  "prompt": "详细展示商品的各个细节和使用场景",
  "aspectRatio": "16:9",
  "resolution": "720p",
  "voice": true
}

示例 10：minimax-h3（MiniMax H3）— 2K 高清 + 首尾帧

JSON

{
  "imageUrl": "https://example.com/first-frame.jpg",
  "lastFrameImageUrl": "https://example.com/last-frame.jpg",
  "videoType": "minimax-h3",
  "videoTime": 10,
  "prompt": "商品从静态到动态的转场效果",
  "aspectRatio": "16:9",
  "resolution": "2k"
}

示例 11：minimax-h3-lite（管理台名称：MiniMax H3）— 768P 多图模式

JSON

{
  "imageList": [
    "https://example.com/product1.jpg",
    "https://example.com/product2.jpg"
  ],
  "videoType": "minimax-h3-lite",
  "videoTime": 10,
  "prompt": "保持商品主体一致，生成自然的商品展示视频",
  "resolution": "768P",
  "aspectRatio": "16:9"
}

示例 12：gemini-omni-flash（Omni Flash 1.1）— 1080P 10 秒竖版

JSON

{
  "imageUrl": "https://example.com/image.jpeg",
  "videoType": "gemini-omni-flash",
  "videoTime": 10,
  "prompt": "电影质感商品展示",
  "resolution": "1080P",
  "aspectRatio": "9:16"
}

示例 13：viduq4-preview（Vidu Q4 Preview）— 单图首帧

JSON

{
  "videoType": "viduq4-preview",
  "imageUrl": "https://example.com/product.jpg",
  "videoTime": 5,
  "prompt": "保持商品外观，镜头缓慢推进展示材质细节",
  "resolution": "720P",
  "promptOptimizer": false
}

提交后返回什么

提交成功后返回任务编号 data.id，表示任务已创建，结果还需等待生成。请保存编号。查看返回示例。

查询生成结果

用任务编号 data.id 调用获取作图结果，每次查询至少间隔 10 秒。data.status=3 表示成功；若生成了图片或视频，从 data.resultList[].url 获取地址。data.status=4 表示失败。查看统一示例。

常见问题

报参数错误：检查 videoType 是否为支持值，videoTime 是否匹配该类型的可选时长；happyhorse-v2 必须传 imageList 而非 imageUrl；kling-v3-omni 多图模式必须传 aspectRatio。V3版本会返回详细的错误提示，包括当前模型支持的所有可选值。
doubao-seedance-2-0-fast / doubao-seedance-2-0-mini 报分辨率错误：两者均不支持 1080p，请传 480p 或 720p。
kling-v3-omni 报尾帧错误：kling-v3-omni 仅 1080P 支持尾帧。
kling-v3-omni 报比例错误：kling-v3-omni 多图模式必传 aspectRatio，可选值为 1:1、16:9、9:16；首尾帧模式仅支持自适应，不传此参数。
gemini-omni-flash 报比例或分辨率错误：Omni Flash 1.1 仅支持 16:9 / 9:16，分辨率仅 720P / 1080P / 4K，时长仅 5 / 10 秒。参考图最多 10 张，超过会报「最多支持 10 张」。
任务失败：检查提示词是否违规、图片地址是否可访问、套餐算力是否充足。
结果为空或超时：延长轮询时间，复杂内容通常生成耗时更长。
参考视频报错：检查 video 是否为 URL 数组且只包含 1 段视频，并确认当前模型支持参考视频；同时检查视频格式、大小、时长、编码、画面尺寸和 URL 可访问性。
参考视频扣点怎么算？：上述支持参考视频的 Seedance 系列和 WAN3，在传入有效 video 时按基础扣点的 2 倍计算；基础扣点由模型配置中的分辨率和时长决定。
参考素材模式冲突：video 可以与 imageUrl 或 imageList 一起使用，但不要同时传 lastFrameImageUrl；参考素材模式与首尾帧模式互斥。
模板模式和 prompt 能同时传吗？：不能，templateKey 和 prompt 互斥。传入 templateKey 后服务端会自动生成最终 prompt，手动传的 prompt 会被忽略；普通模式不传 templateKey 时必须传 prompt；高级模式的 prompt 可不传，且不能同时使用 templateKey。
productInfo 怎么填？：模板模式下可按 [维度]：内容 逐行填写商品特征；高级模式下填写已确认的商品资料，传入非空内容即可跳过商品分析，不传则自动分析商品图。两种情况均会继续生成分镜，分镜流程费用相同。
模板模式支持哪些模型？：模板生成的 prompt 为通用文本，所有 videoType 均可配合模板模式使用，推荐 doubao-seedance-2-0 / kling-v3-omni / happyhorse-v2 出视频效果更佳。当前模板包括 product-showcase、ugc-seeding、pain-solution 和 furniture-scene。

扣费标准

正在读取当前模型扣点...

按模型、分辨率和视频时长扣点；传入参考视频时的倍率规则见下方参考视频。

高级模式计费

高级模式在视频生成费用之外，另计一次分镜流程费用，与页面同步。分镜流程当前限时免费（0 算力点），后续标准为 50 算力点/次，具体生效以正式发布公告为准。

创建上限

配置项	上限
创建中 / 生成中任务上限	100 个

图转视频V3

请求体

高级模式

Seedance 素材加白

各模型参数支持情况

Seedance 2.5 比例限制

参考视频

OpenAPI V3 参数边界

参考视频限制

参考视频计费规则

素材组合规则

参考视频请求示例

参考音频

OpenAPI V3 参数边界

参考音频限制

音频地址与校验

素材组合与计费

参考音频请求示例

请求示例

提交后返回什么

查询生成结果

常见问题

扣费标准

高级模式计费

创建上限