接口功能介绍
支持直播转码、直播录制、直播截图和直播审核等媒体处理模板列表查询。
接口详情
请求方式：POST
请求路径：/live/media-template/query-media-template-pagination-list
请求JSON参数
| 参数名 | 类型 | 名称 | 是否必填 | 说明 |
|---|---|---|---|---|
| TemplateType | string | 模板类型 | 是 | live-tran: 直播转码 live-record: 直播录制 live-snapshot: 直播截图 live-identify：直播审核 |
| Page | int | 分页页码 | 否 | 取值范围≥1, 分页的页数,不传默认为1 |
| PageSize | int | 分页大小 | 否 | 每页模板数值，不传默认为100，[0,1000] |
响应JSON参数
| 参数名 | 类型 | 名称 |
|---|---|---|
| code | int | 状态码 |
| message | string | 描述信息 |
| TotalCount | int | 总记录数 |
| Result | list | 模板详情信息 |
Result
| 参数名 | 类型 | 名称 |
|---|---|---|
| TemplateID | string | 模板ID |
| TemplateName | string | 模板名 |
| TemplateType | string | 模板类型 |
| Description | string | 模板描述 |
| CreateTime | string | 创建时间 |
| UpdateTime | 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-pagination-list
请求JSON示例
{
"TemplateType": "live-tran",
"Page": 1,
"PageSize": 100
}
正常响应JSON示例
{
"TotalCount": 9,
"code": 100000,
"message": "success",
"Result": [{
"Description": "test0609",
"CreateTime": "2022-06-09 13:35:34",
"UpdateTime": "2022-06-09 14:08:35",
"TemplateName": "test0609",
"Params": {
"Output": [{
"Format": {
"Abr": "128k",
"Asr": 44100,
"Vcodec": "libx264",
"Vbr": "2000k",
"Acodec": "libfdk_aac",
"OutputFormat": 105,
"Gop": 10,
"Height": "1080",
"Fr": "30",
"Width": "1920"
}
}]
},
"TemplateType": "live-tran",
"TemplateID": "5523c1sss655"
}, {
"Description": "csacsacas",
"CreateTime": "2022-09-15 16:45:51",
"UpdateTime": "2022-09-15 17:30:19",
"TemplateName": "tet1321",
"Params": {
"Output": [{
"Format": {
"Abr": "100k",
"Asr": 10,
"Vcodec": "libx264",
"Vbr": "8000k",
"Acodec": "libfdk_aac",
"Gop": 10,
"Height": "1080",
"Fr": "25",
"Width": "1922"
}
}]
},
"TemplateType": "live-tran",
"TemplateID": "bf7sdass22f98"
}]
}
