视频混剪接口文档

更新时间：2026-06-04

产品定价

商品类别	商品名称	积分	价格 (元)	积分单价
API	数字员工平台公有云-视频组件-视频混剪-服务-包年包月-800积分	800	¥80.00	0.1
API	数字员工平台公有云-视频组件-视频混剪-服务-包年包月-10000积分	10,000	¥900.00	0.09
API	数字员工平台公有云-视频组件-视频混剪-服务-包年包月-200000积分	200,000	¥16,000.00	0.08

功能	参数配置	积分定价消耗
素材分析（图片）	/	1 积分/张
素材分析（视频）	/	12 积分/分钟
AI视频剪辑（不含数字人）	720p、1080p	12 积分/分钟
AI视频剪辑（不含数字人）	2K	18 积分/分钟
AI视频剪辑（含数字人）	720p、1080p	24 积分/分钟
AI视频剪辑（含数字人）	2K	30 积分/分钟

接口说明

视频混剪接口调用域名：https://open.xiling.baidu.com 接口鉴权和通用字段说明请查阅：接口通用说明

视频混剪接口采用异步任务模式。提交任务后返回任务 ID，可通过查询接口轮询任务结果。

接口列表

提交视频混剪任务

POST /api/digitalhuman/open/v1/video-remix

Content-Type: application/json;charset=utf-8

请求参数

参数	类型	必填	说明	备注
mode	string	是	视频生成模式	可选值：`script`、`product`
voice_script	string	否	播报的旁白文案	`script` 模式下建议传入
script_adaptive	boolean	否	旁白文案自适应	默认为 `true`，可对旁白扩写、压缩或润色
product_name	string	否	商品名称	`product` 模式下建议传入
product_description	string	否	商品描述	`product` 模式下可传
logo	string	否	商品 Logo 图片 URL	`product` 模式下可传
brand	string	否	品牌名称	最多 50 字符
selling_point	string	否	商品核心卖点描述	最多 500 字符
target_audience	string	否	目标用户群体描述	最多 500 字符
promotion_details	string	否	促销描述
medias	Media[]	是	混剪素材列表，最多20个素材，每个素材不超过300M
figure	string	否	形象 ID
timbre	Timbre	否	音色信息
aspect_ratio	string	是	视频比例	可选值：`9:16`、`16:9`
target_language	string	否	视频配音 / 字幕语言	可选值：中文、英语、日语、韩语、法语、德语、俄语、泰语；默认中文
duration	int	否	时长，单位秒	可选值：`15`、`30`、`45`；不填表示任意时长
generate_count	int	否	单次请求的视频成片数量	最多支持 4 条，默认 1
resolution	string	否	输出分辨率	可选值：`720p`、`1080p`、`2K`；默认 `1080p`
bgm	Bgm	否	视频背景音乐信息
captions	Caption	否	字幕配置
ext_config	ExtConfig	否	转场配置
remix_strategy	string	是	混剪策略	可选值：智能选择、产品种草、到店探店
voiceover	boolean	否	是否包含口播，默认为true

medias内部字段说明：

参数	类型	必填	说明
media_type	string	是	素材类型，可选值：`image`、`video`
media_url	string	是	素材 URL

timbre 内部字段说明：

参数	类型	必填	说明
per	string	否	音色ID，不填则根据内容自动匹配音色
pit	int	否	音高，取值范围1～15
spd	int	否	语速，取值范围1～15
vol	int	否	音量，取值范围1～15

bgm 内部字段说明：

参数	类型	必填	说明
bgm_url	string	否	自定义的背景音乐链接
bgm_id	int	否	指定的背景音乐id，视频混剪bgm试听文档
bgm_volume	int	否	背景音乐的音量，取值范围0～100，不填默认10

caption 内部字段说明：

参数	类型	必填	说明
open	boolean	否	是否开启字幕，默认开
template_id	string	否	字幕模板ID
font_family	string	否	字体名称，默认 FZHei-B01
font_size	int	否	字号，范围12-100，默认50
primary_color	string	否	字体颜色和透明度，格式RGBA8888，默认值white：#FFFFFFFF
outline_color	string	否	背景颜色和透明度，格式RGBA8888, 默认无背景
margin_vertical	int	否	字幕距底部边距（像素）

字体参数说明：

字体	字体名称
方正黑体	FZHei-B01
方正楷体	FZKai-Z03
方正书宋	FZShuSong-Z01
站酷酷黑体	ZCOOL_KuHei
仓耳渔阳体W02	TsangerYuYangT
创客贴金刚体	CKTKingkong

ExtConfig 内部字段说明：

参数	类型	必填	说明
trans_enable	bool	否	是否开启转场, 默认 false
trans_style	string	否	转场样式，默认auto
trans_duration	number	否	转场时间，单位毫秒，范围[400, 1500], 默认800

trans_style 样式说明

参数	说明
dissolve	叠化
blur	虚化
dissolve-blur	模糊
03_linear_rl	左擦除
auto	智能转场，从上述4种转场自动匹配

返回参数

参数	类型	说明
task_id	string	任务 ID

请求示例

Plain

1{
2    "mode": "script",
3    "voice_script": "这是一款轻便好用的随行咖啡杯，保温持久，适合通勤和旅行场景。",
4    "script_adaptive": true,
5    "medias": [
6        {
7            "media_type": "image",
8            "media_url": "https://example.com/media-1.jpg"
9        },
10        {
11            "media_type": "video",
12            "media_url": "https://example.com/media-2.mp4"
13        }
14    ],
15    "aspect_ratio": "9:16",
16    "target_language": "中文",
17    "duration": 30,
18    "generate_count": 2,
19    "resolution": "1080p",
20    "bgm":{
21         "bgm_url": ""https://example.com/audio-1.mp3",
22         "bgm_id": "m-xxxx",
23         "bgm_volume": 10 
24    },
25    "captions": {
26        "open": true,
27        "template_id": "6c5dfd72-10ad-4d0d-97fd-aef98a066c65",
28        "font_family": "FZHei-B01",
29        "font_size": 40,
30        "primary_color": "#00ff00ff",
31        "outline_color": "#ff00ffff",
32        "margin_vertical": 200
33    },
34    "ext_config": {
35        "trans_enable": true,
36        "trans_style": "blur",
37        "trans_duration": 800,
38    },
39    "remix_strategy": "智能选择"
40}

返回示例

                JSON
                
            

                {
    "code": 0,
    "message": {
        "global": "success"
    },
    "result": {
        "task_id": "vr-d6b6472bcf724d0399e06d1390cb964e"
    }
}
            

查询视频混剪任务结果

GET /api/digitalhuman/open/v1/video-remix

请求参数

参数	类型	必填	说明
task_id	string	是	任务 ID

返回参数

参数	类型	必填	说明
status	string	是	任务状态
error_message	string	是	任务失败原因
sub_task_result	object[]	否	子任务结果列表
sub_task_id	string	否	子任务 ID
video_url	string	否	视频地址
error_message	string	否	子任务失败原因

请求示例

Plain

1GET /api/digitalhuman/open/v1/video-remix?task_id=vrm-xxx

返回示例

                JSON
                
            

                {
    "code": 0,
    "message": {
        "global": "success"
    },
    "result": {
        "status": "SUCCEEDED",
        "error_message": null,
        "sub_task_result": [
            {
                "sub_task_id": "vr-sub-001",
                "video_url": "https://xiling-dh.bj.bcebos.com/example/sample_0.mp4",
                "error_message": ""
            },
            {
                "sub_task_id": "vr-sub-002",
                "video_url": "https://xiling-dh.bj.bcebos.com/example/sample_1.mp4",
                "error_message": ""
            }
        ]
    }
}```
            

评价此篇文章

有帮助没帮助

图片创作接口文档

交互组件接入手册

百度智能云

数字员工-开放平台

数字员工-开放平台

视频混剪接口文档

产品定价

接口说明

接口列表

提交视频混剪任务

请求参数

返回参数

请求示例

返回示例

查询视频混剪任务结果

请求参数

返回参数

请求示例

返回示例