接口功能介绍
支持直播转码、直播录制、直播截图和直播审核等媒体处理模板参数查询。
接口详情
请求方式：POST
请求路径：/live/media-template/query-media-template-list
请求JSON参数
| 参数名 | 类型 | 名称 | 是否必填 | 说明 |
|---|---|---|---|---|
| TemplateType | string | 模板类型 | 是 | live-tran: 直播转码 live-record: 直播录制 live-snapshot: 直播截图 live-identify：直播审核 |
响应JSON参数
| 参数名 | 类型 | 名称 |
|---|---|---|
| code | int | 状态码 |
| message | string | 描述信息 |
| Result | list | 模板详情信息 |
| Result:TemplateList | string | |
| TemplateID | string | 模板ID |
| TemplateName | string | 模板名 |
| TemplateType | string | 模板类型 |
| Description | string | 模板描述 |
| Params | string | 模板参数 |
转码模板参数Params
| 参数名 | 类型 | 名称 |
|---|---|---|
| Output | list | 参数集 |
| Video | dict | 视频参数集 |
Output结构
| 参数名 | 类型 | 名称 |
|---|---|---|
| Format | dict | 参数格式 |
Format结构
| 参数名 | 类型 | 名称 |
|---|---|---|
| Vcodec | string | 编码方式 |
| OutputFormat | string | 推荐模板 |
| Vbr | string | 视频码率 |
| Width | string | 视频分辨率宽度 |
| Height | string | 视频分辨率高度 |
| Fr | string | 视频帧率 |
| Abr | string | 音频码率 |
| Asr | int | 音频采样率 |
| Acodec | string | 音频编码 |
| Gop | int | Gop |
| SeiType | int | SEI类型 取值范围：5、-1，默认-1（即不新增sei） |
| SeiPattern | string | SEI模式 |
| SeiContent | string | SEI内容 |
Video结构
| 参数名 | 类型 | 名称 |
|---|---|---|
| Logo | list | Logo |
Logo结构
| 参数名 | 类型 | 名称 |
|---|---|---|
| Pic | string | 水印图片地址 |
| OptimalW | int | 水印宽度 |
| OptimalH | int | 水印高度 |
| OffsetX | int | OffsetX |
| OffsetY | int | OffsetY |
录制模板参数Params
| 参数名 | 类型 | 名称 |
|---|---|---|
| Output | list | 参数集 |
| Output[].Format | string | 输出文件的封装格式 |
| Output[]. SegmentTime | string | 录制文件分段时长 1.当format为hls时，该字段代表ts文件的切片时长 2.当format为hls时，默认切片时长为10秒，为其它格式时默认分段为6小时 |
| Output[].OssFilePath | string | 文件存储路径 |
| Output[]. OssFileName | string | 文件命名规则 |
| OssRegion | string | OSS的Region名称 |
| OssBucket | string | OSS的Bucket名称 |
| OssEndpoint | string | OSS的服务地址 |
| OssExpiration | int | OSS的生命周期 |
截图模板参数Params
| 参数名 | 类型 | 名称 |
|---|---|---|
| Output | list | 参数集 |
| Output.Format | string | 图片格式 |
| Output.Interval | string | 截图间隔时长 |
| Output. SamplingSnapshot | int | 是否截关键帧 |
| Output.OssFilePath | string | 截图存储路径 |
| Output.OssFileName | string | 截图文件命名规则 |
| OssRegion | string | OSS存储的Region名称 |
| OssBucket | string | OSS存储的Bucket名称 |
| OssEndpoint | string | OSS存储的Endpoint名称 |
| OssExpiration | int | 存储时长 |
审核模板参数Params
| 参数名 | 类型 | 名称 |
|---|---|---|
| IdentifyType | int | 审核类型 |
| Output | object array | 直播审核参数 |
| Output.Format | string | 截图格式 |
| Output.Interval | string | 截图间隔 |
| OssBucket | string | OSS存储的Bucket名称 |
| OssRegion | string | OSS存储的Region名称 |
| OssEndpoint | string | OSS存储的Endpoint名称 |
示例
请求路径：https://cdnapi-global.ctapi.ctyun.cn/live/media-template/query-media-template-list
请求JSON示例
{
"TemplateType":"live-tran"
}
正常返回JSON示例
{
"code": 100000,
"message": "success",
"Result": [
{
"TemplateID": "65shhklue975easaa457",
"TemplateName": "lt01",
"TemplateType": "live-tran",
"Description": "转码01",
"Params": {
"Video": {
"Logo": [
{
"Pic": "/abc",
"OptimalW": 100,
"OptimalH": 100,
"OffsetX": 1,
"OffsetY": 1
}
]
},
"Output": [
{
"Format": {
"Vcodec": "libx264",
"OutputFormat": 118,
"Vbr": "100k",
"Width": "100",
"Height": "100",
"Fr": "5",
"Abr": "10k",
"Asr": 1,
"Acodec": "libfdk_aac",
"Gop": 1
}
}
]
}
},
{
"TemplateID": "65shhklue975easaa457s",
"TemplateName": "lt02",
"TemplateType": "live-tran",
"Description": "转码02",
"Params": {
"Output": [
{
"Format": {
"Vcodec": "libx264",
"OutputFormat": 108,
"Vbr": "3000k",
"Width": "2560",
"Height": "1440",
"Fr": "30",
"Abr": "128k",
"Asr": 44100,
"Acodec": null,
"Gop": 1
}
}
]
}
}
}
