API对接文档
带货口播V3
POST
/image/v3/make/salesVideoapplication/json请求体
videoTypestring必填模型类型，支持值见下方模型能力表
promptstring可选补充口播脚本/视频提示词，最多 2000 字符；不传时由系统生成。建议包含产品卖点、使用场景、人群和语气风格。
imageListarray必填参考图列表（商品图、场景图、品牌图等），至少 1 张可访问外网的图片 URL；数量上限按模型区分，见下方各模型参数支持情况
videoTimeinteger可选视频时长（秒）；支持值和默认值见下方各模型参数支持情况。
resolutionstring可选视频分辨率。详见各模型参数支持情况
aspectRatiostring可选视频比例，可选值见下方各模型参数支持情况；不传使用模型默认值。
isProboolean可选默认false是否开启高质量模式；适用于 doubao-seedance-2-0 / doubao-seedance-2-0-fast / doubao-seedance-2-0-mini / doubao-seedance-2-5，未传
resolution 时，true 使用 720puseAssetWhitelistboolean可选默认true是否使用素材库加白；省略或 null 同默认。true 使用素材库资产，false 直接提交素材 URL；预检规则及人脸审核风险见下方Seedance 素材加白。
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。该规格仅用于图片入库，素材数量、时长及组合等业务约束仍按模型校验。依据：私域虚拟人像素材资产库使用指南。
人脸审核风险：关闭加白时，包含人脸或真人肖像的素材可能被供应商审核拒绝；开启加白仍须通过素材库和模型审核，不能保证成功。尺寸等预检通过不代表内容审核通过。
如需关闭加白，在本页完整请求中加入 "useAssetWhitelist": false；省略或传 null 均按 true 处理。
各模型参数支持情况
声音随所选模型生成；本接口不提供独立声音开关或参考音频输入，请勿传入 voice 或 audio。
| 正在读取模型配置... |
参数使用建议
prompt建议明确：商品名称 + 核心卖点 + 目标人群 + 结尾行动指令（如"立即下单"）。imageList必填，传入商品主图/细节图通常能提升一致性和转化表达。videoType与videoTime建议组合测试：不同渠道（短视频/详情页）可选择不同时长。- 使用 doubao-seedance-2-0 / doubao-seedance-2-0-fast / doubao-seedance-2-0-mini / doubao-seedance-2-5 且未传
resolution时，可通过isPro=true使用 720p。 happyhorse-v2分辨率默认 720p，如需更高清可传resolution: "1080p"。
请求示例
示例1：doubao-seedance-2-0
{
"videoType": "doubao-seedance-2-0",
"prompt": "这款便携式榨汁杯，300W强劲电机，40秒快速出汁，Type-C充电，通勤健身都能用。现在下单享限时优惠。",
"imageList": [
"https://example.com/product-main.jpg",
"https://example.com/product-detail.jpg"
],
"videoTime": 10,
"resolution": "1080P",
"aspectRatio": "9:16",
"isPro": true
}示例2：happyhorse-v2
{
"videoType": "happyhorse-v2",
"prompt": "精选有机坚果礼盒，多种坚果搭配，健康美味送人有面子。",
"imageList": [
"https://example.com/gift-box.jpg",
"https://example.com/nuts-detail.jpg",
"https://example.com/packaging.jpg"
],
"videoTime": 15,
"resolution": "1080P",
"aspectRatio": "16:9"
}示例3：doubao-seedance-2-0-fast
{
"videoType": "doubao-seedance-2-0-fast",
"prompt": "新品上市，限时优惠，手慢无。",
"imageList": [
"https://example.com/product.jpg"
],
"videoTime": 5,
"resolution": "480P",
"aspectRatio": "9:16"
}示例4：doubao-seedance-2-5（豆包 Seedance 2.5）— 30 秒长视频
{
"videoType": "doubao-seedance-2-5",
"prompt": "这款智能手表，支持心率监测、睡眠追踪、运动记录，50米防水设计，续航长达7天。多种表盘可选，时尚百搭。现在购买赠送额外表带，立享优惠价。",
"imageList": [
"https://example.com/watch-main.jpg",
"https://example.com/watch-side.jpg",
"https://example.com/watch-screen.jpg",
"https://example.com/watch-strap.jpg"
],
"videoTime": 30,
"resolution": "720P",
"aspectRatio": "16:9"
}示例5：viduq4-preview（Vidu Q4 Preview）
{
"videoType": "viduq4-preview",
"prompt": "展示商品卖点和使用场景，生成自然的带货口播视频",
"imageList": [
"https://example.com/product-main.jpg",
"https://example.com/product-detail.jpg"
],
"videoTime": 5,
"resolution": "1080P",
"aspectRatio": "9:16"
}提交后返回什么
提交成功后返回任务编号 data.id，表示任务已创建，结果还需等待生成。请保存编号。查看返回示例。
查询生成结果
用任务编号 data.id 调用获取作图结果，每次查询至少间隔 10 秒。data.status=3 表示成功；若生成了图片或视频，从 data.resultList[].url 获取地址。data.status=4 表示失败。查看统一示例。
常见问题
- 报参数错误：优先检查
videoType是否为支持值（minimax-h3-lite / minimax-h3 / wan3 / doubao-seedance-2-5 / doubao-seedance-2-0 / doubao-seedance-2-0-fast / doubao-seedance-2-0-mini / happyhorse-v2），videoTime是否匹配该类型的可选时长。 - doubao-seedance-2-0-fast / doubao-seedance-2-0-mini 报分辨率错误：两者均不支持
1080p，请传480p或720p。 - 任务失败：检查提示词是否违规、图片地址是否可访问、套餐算力是否充足。
- 结果为空或超时：延长轮询时间，复杂内容通常生成耗时更长。
扣费标准
正在读取当前模型扣点...
按模型、分辨率和视频时长扣点。
创建上限
| 配置项 | 上限 |
|---|---|
| 创建中 / 生成中任务上限 | 100 个 |