创建视频批量合成任务
更新时间：2023-09-18
创建视频批量合成任务
接口描述
用户通过该接口创建批量视频合成任务。
请求
- 请求语法
GET /v1/adapter/{adpId} HTTP/1.1
x-bce-date: 2022-05-02T17:31:29Z
host: xxxx.com
content-type: application/json
authorization: {bce-authorization-string}- 请求头域：API需要在请求的HTTP头域中包含以下信息：
| 公共头部 | 描述 |
|---|---|
| host | 请求host：bvw.bj.baidubce.com |
| x-bce-date | 表示日期的字符串，符合API规范，具体请参考日期与时间规范 |
| authorization | 包含Access Key与请求签名，具体请参考鉴权认证 |
| content-type | application/json; charset=utf-8 |
- 请求参数：
| 字段名称 | 字段类型 | 必要性 | 字段描述 | 长度限制 | 备注 | 默认值 |
|---|---|---|---|---|---|---|
| [+] bucket | string | 是 | ppt图片、srt文件、待合成视频在bos的bucket | 64 | | |
| [+] materialInfo | object | 是 | | | | |
| [+][+] bgImageList | list | 是 | 背景图片信息 | | | |
| [+][+][+] data | object | 是 | | | | |
| [+][+][+][+] key | string | 是 | 背景图片key | 1024 | | |
| [+][+][+][+] xpos | double | 是 | x轴边位置 | | 取值范围[0~1]，需根据图片大小自行计算，如果为标准16:9比例（横版），则为0 | |
| [+][+][+][+] ypos | double | 是 | y轴边位置 | | 取值范围[0~1]，需根据图片大小自行计算，如果为标准16:9比例（横版），则为0 | |
| [+][+][+][+] width | double | 是 | 图片、视频宽度 | | 如1920*1080分辨率视频（图片），这里width就是1920 | |
| [+][+][+][+] height | double | 是 | 图片、视频高度 | | 如1920*1080分辨率视频（图片），这里height就是1080 | |
| [+][+][+][+] widthScal | double | 是 | 长度缩放比例 | | 如果是背景,最好填充整个画面，取值范围[0~1]，需根据图片大小自行计算，如果为标准16:9比例（横版），则为1（填充整个画面） | |
| [+][+][+][+] heightScal | double | 是 | 宽度缩放比例 | | 如果是背景,最好填充整个画面，取值范围[0~1]，需根据图片大小自行计算，如果为标准16:9比例（横版），则为1（填充整个画面） | |
| [+][+][+][+] showStartTime | string | 是 | 背景图片在画面中开始时间 | | 必须从0开始 | |
| [+][+][+][+] showEndTime | string | 是 | 背景图片在画面中结束时间 | | 若该时间小于视频结束时间，会将该时间自动调整为视频结束时间 | |
| [+][+] mainImageList | list | 是 | ppt图片信息 | | | |
| [+][+][+] data | object | 是 | | | | |
| [+][+][+][+] key | string | 是 | ppt图片key | 1024 | | |
| [+][+][+][+] xpos | double | 是 | x轴上位置 | | 取值范围[0~1] | 0 |
| [+][+][+][+] ypos | double | 是 | y轴上位置 | | 取值范围[0~1] | 0 |
| [+][+][+][+] width | double | 是 | 图片、视频宽度 | | 如果图片/视频是1280*720大小，这里则为1280 | |
| [+][+][+][+] height | double | 是 | 图片、视频高度 | | 如果图片/视频是1280*720大小，这里则为720 | |
| [+][+][+][+] widthScal | double | 是 | 长度缩放比例 | | 如果是背景,最好填充整个画面，取值范围[0~1]，需根据图片大小自行计算，如果为标准16:9比例（横版），则为1（填充整个画面） | |
| [+][+][+][+] heightScal | double | 是 | 宽度缩放比例 | | 如果是背景,最好填充整个画面，取值范围[0~1]，需根据图片大小自行计算，如果为标准16:9比例（横版），则为1（填充整个画面） | |
| [+][+][+][+] showStartTime | string | 是 | ppt图片在画面中开始时间 | | | |
| [+][+][+][+] showEndTime | string | 是 | ppt图片在画面中结束时间 | | | |
| [+][+] sourceVideoList | list | 是 | 待合成视频信息 | | | |
| [+][+][+] data | object | 是 | | | | |
| [+][+][+][+] key | string | 是 | 待合成视频key | 1024 | | |
| [+][+][+][+] xpos | double | 是 | x轴上边位置 | | 取值范围[0~1] | 0 |
| [+][+][+][+] ypos | double | 是 | y轴上边位置 | | 取值范围[0~1] | 0 |
| [+][+][+][+] width | double | 是 | 长度缩放比例 | | 如果图片/视频是1280*720大小，这里则为1280 | |
| [+][+][+][+] height | double | 是 | 宽度缩放比例 | | 如果图片/视频是1280*720大小，这里则为720 | |
| [+][+][+][+] widthScal | double | 是 | 长度缩放比例 | | 如果是背景,最好填充整个画面，取值范围[0~1]，需根据图片大小自行计算，如果为标准16:9比例（横版），则为1（填充整个画面） | |
| [+][+][+][+] heightScal | double | 是 | 宽度缩放比例 | | 如果是背景,最好填充整个画面，取值范围[0~1]，需根据图片大小自行计算，如果为标准16:9比例（横版），则为1（填充整个画面） | |
| [+][+][+][+] startTime | string | 非必须 | 视频开始时间(用于截取视频) | | 不配置默认视频都放完 | |
| [+][+][+][+] endTime | string | 非必须 | 视频结束时间(用于截取视频) | | | |
| [+][+][+][+] showStartTime | double | 是 | 视频在画面中出现的时间 | | 不设置默认0s开始 | |
| [+][+][+][+] showEndTime | double | 是 | 视频在画面中结束的时间 | | 不设置默认到视频时长 | |
| [+][+][+][+] greenScreenCutout | boolean | 非必须 | 是否需要绿幕扣图 | | true需要，false不需要 | false |
| [+][+][+][+] color | string | 非必须 | 背景颜色 | | 不给默认会出一个默认值 | |
| [+][+][+][+] crop | object | 非必须 | | | | |
| [+][+][+][+][+] xpos | double | 是 | 截取视频画面大小时x坐标位置 | | xpos取值范围为[0,1] | |
| [+][+][+][+][+] ypos | double | 是 | 截取视频画面大小时x坐标位置 | | ypos取值范围为[0,1] | |
| [+][+][+][+][+] width | double | 是 | 图片、视频截取比例 | | [0,1] | |
| [+][+][+][+][+] height | double | 是 | 图片、视频截取比例 | | [0,1] | |
| [+] srtKey | string | 非必须 | srt文件key | | 不传字幕文件的时候不会进行字幕合成 | |
| [+] extInfo | | | | | | |
| [+][+] aspect | string | 非必须 | 横版视频还是竖版视频 | | 可选vert9x16（竖版视频），hori16x9 | hori16x9（横版视频） |
| [+][+] resolutionRatio | string | 非必须 | 分辨率 | | 可选v540p，v720p，v1080p | v720p |
- 请求示例：
POST /v1/adatper HTTP/1.1
POST /v1/adapter HTTP/1.1
x-bce-date: 2023-07-26T09:27:33Z
host: bvw.bj.baidubce.com
content-type: application/json
authorization: bce-auth-v1/c0188830c0c342928f199bbbdac4c227/2023-07-26T09:27:33Z/1800/host/f19dfaf46b9e6b619e9be203650701a2bec9db18a980686ddb3a3a58132558e1
{
"bucket": "videoBucket",
"materialInfo": {
"bgImageList": [
{
"key": "这是背景图片.png",
"xpos": 0,
"ypos": 0,
"width": 1,
"height": 1,
"index": 0,
"startTime": "00:00:00,298 ",
"endTime": "00:00:25,541"
}
],
"mainImageList": [
{
"key": "这是第一张ppt图片.png",
"xpos": 0,
"ypos": 0,
"width": 1,
"height": 1,
"index": 0,
"startTime": "00:00:00,298 ",
"endTime": "00:00:25,541"
},
{
"key": "最后一张ppt图片.png",
"xpos": 0,
"ypos": 0,
"width": 1,
"height": 1,
"index": 0,
"startTime": "00:00:25,541 ",
"endTime": "10:00:25,541"
}
],
"sourceVideoList": [
{
"key": "这是视频.mp4",
"xpos": 0,
"ypos": 0,
"width": 1,
"height": 1,
"index": 0,
"startTime": "00:00:00,298 ",
"endTime": "00:00:25,541"
}
]
},
"srtKey": "srt"
}响应（Response）
- 响应头域：无特殊Header参数
- 响应参数：
| 字段名称 | 字段类型 | 字段描述 |
|---|---|---|
| adpId | string | 自动剪辑任务id |
- 响应示例：
HTTP/1.1 200 OK
Transfer-Encoding: chunked
x-bce-request-id: ca8620b4-0527-4153-b6ed-3a6c0a4da937
Cache-Control: no-cache
Server: BWS
Date: Fri, 31 May 2019 09:27:33 GMT
Content-Type: application/json;charset=UTF-8
{
"adpId": "adp-sdfesfj345tym"
}