录制视频裁剪
更新时间：2025-08-21
接口描述
裁剪录制视频接口，输入绝对开始时间和结束时间，可以获取视频回放。
- 本接口仅支持已经录制的m3u8视频， 裁剪后输出可以是m3u8或mp4格式。
- 只能剪裁已经录制完成的视频，不能干预直播中正在录制的或即将录制的视频。
请求语法
Http
1POST /v5/recording/clip HTTP/1.1
2accept-encoding: gzip, deflate
3x-bce-date: {utc-date-string}
4host: lss.bj.baidubce.com
5accept: */*
6connection: keep-alive
7x-bce-request-id: {bce-request-id}
8content-type: application/json
9authorization: {bce-authorization-string}请求头域
无特殊请求头域。
请求参数
| 参数 | 类型 | 是否必须 | 描述 | 可选值 | 默认值 |
|---|---|---|---|---|---|
| playDomain | String | 是 | 播放域名名称 | - | - |
| app | String | 是 | app名称 | - | - |
| stream | String | 是 | stream名称 | - | - |
| filename | String | 否 | 指定裁剪后的文件名称 | - | 格式为clip_<stream名称>_<startTime>_<endTime>，startTime与endTime如果未指定也用对应的默认值 |
| format | String | 否 | 裁剪后视频的格式 | m3u8,mp4 | m3u8 |
| startTime | Number | 否 | 指定录制视频开始时间（unix时间戳，单位秒） | - | 直播录制的最开始时间，不指定或0 表示从直播开始录制。 |
| endTime | Number | 否 | 指定录制视频结束时间（unix时间戳，单位秒） | - | 直播录制结束最后时间，不指定或0 表示录制到直播结束。 |
| sourceFile | String | 是 | 指定要裁剪的m3u8文件名，需要包括bucket下目录的路径 | - | - |
| pipeline | String | format=mp4时必选 | 指定MCT中的转码队列 | - | - |
| preset | String | format=mp4时必选 | 指定MCT中的mp4转码模板 | - | - |
| clipId | String | 可选 | 查询裁剪MP4结果的id | - | - |
请求示例
m3u8裁剪：
Http
1POST /v5/recording/clip HTTP/1.1
2content-length: 444
3accept-encoding: gzip, deflate
4x-bce-date: 2015-07-03T09:28:13Z
5connection: keep-alive
6accept: */*
7user-agent: python-requests/2.4.0 CPython/2.7.9 Darwin/14.3.0
8host: lss.bj.baidubce.com
9x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
10content-type: application/json
11authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715
12
13{
14 "playDomain": "play.test.com",
15 "app": "testapp",
16 "stream": "teststream",
17 "filename": "teststream_clip"
18 "format": "m3u8",
19 "startTime": 1510627184,
20 "endTime": 1510628184,
21 "sourceFile": “yourfile/teststream_clip.m3u8"
22}MP4裁剪：
Http
1POST /v5/recording/clip HTTP/1.1
2content-length: 444
3accept-encoding: gzip, deflate
4x-bce-date: 2015-07-03T09:28:13Z
5connection: keep-alive
6accept: */*
7user-agent: python-requests/2.4.0 CPython/2.7.9 Darwin/14.3.0
8host: lss.bj.baidubce.com
9x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
10content-type: application/json
11authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715
12
13{
14 "playDomain": "play.test.com",
15 "app": "testapp",
16 "stream": "teststream",
17 "filename": "teststream_clip_mp4"
18 "format": "mp4",
19 "startTime": 1510627184,
20 "endTime": 1510628184,
21 "pipeline": "test_pipeline",
22 "preset": "test_preset",
23 "sourceFile": “yourfile/teststream_clip.m3u8"
24}响应头域
无特殊响应头域。
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| fileUrl | String | m3u8剪裁：完成裁剪的视频的BOS地址 |
| clipId | String | MP4裁剪：用于查询裁剪的MP4结果的id，与最终返回的jobId对应 |
说明：
m3u8剪裁：
- 录制模板需要是m3u8格式，开启一直合并。
- 录制的bucket请设置为公共读，否则返回的链接不能直接访问。
- 如果正在推流时调用本接口，则只能裁剪本次推流之前的录制视频，所以注意指定对应的时间。
- 如果录制的视频时间过长，本接口会有延时。
MP4剪裁：
- preset尺寸伸缩策略需要设置为自适应伸缩（ShrinkToFit）。
- 通过jobId可以从 MCT 查询裁剪后MP4的地址。
- 转码队列的bucket要与LSS直播中存放录制视频的bucket一致。
- 获取clipId后，需要再次请求该接口并带上clipId参数，以获取 MCT 服务的jobId。
响应示例
m3u8裁剪：
Http
1{
2 "fileUrl" : "http://bos-recording-test.bos.gz.qasandbox.bcetest.baidu.com/teststream_clip.m3u8"
3}mp4裁剪：
Http
1{
2 "clipId" : "job-hkvsk1j9gnc19cit"
3}