创建自定义转码模版
post
https://api.sd-rtn.com/v1/projects/{appid}/fls/entry_points/{entry_point}/settings/transcode/custom
该方法为指定发布点创建自定义转码模版。
请求
API Key
融合 CDN 直播 RESTful API 使用 HTTP HMAC (Hash-based Message Authentication Code) 认证。
在发送 HTTP 请求时,你需要通过 HMAC-SHA256 算法生成一个签名,并在请求头部的 Authorization
字段传入签名及相关信息。详见认证方式。
路径参数
appidstringRequired
声网为每个开发者提供的 App ID。在声网控制台创建一个项目后即可得到一个 App ID。一个 App ID 是一个项目的唯一标识。
entry_pointstringRequired
发布点名称。
查询参数
idstringRequired
自定义转码模版的名字。不能与预置转码模版的 name
相同,否则会报错。
请求 Body
application/json
widthintegerRequired最小值:
0
最大值: 1920
视频的宽,取值范围 [0,1920],0 表示按原视频比例自适应。
heightintegerRequired最小值:
0
最大值: 1920
视频的高,取值范围 [0,1920],0 表示按原视频比例自适应。
videoCodecstringOptional
视频编码格式,目前只支持 H.264。如果 videoBitrate
和 profile
指定了值,该字段必填。
videoBitrateintegerOptional最小值:
200
最大值: 6000
视频码率(Kbps)。
profilestringOptional
编码级别,每个级别对应一组特定的编码参数。一般来说级别越高,画面质量越好,同时编解码消耗的资源也越高。取值包括:
base
:基础级别,适合移动设备。main
:标准级别,适合标准分辨率设备。high
:高等级别,适合高分辨率设备。
audioCodecstringOptional
音频编码格式,目前只支持 AAC。如果指定了 audioBitrate
和 audioSampleRate
,该字段必填。
audioBitrateintegerOptional最小值:
100
最大值: 500
音频码率(Kbps)。
audioSampleRateintegerOptional
音频采样率(Hz)。取值包括:96000、88200、64000、48000、44100、32000、16000。
响应
如果返回的 HTTP 状态码为 200,表示请求成功。
请求示例
cURL
Bash
curl --request post \
--url 'https://api.sd-rtn.com/v1/projects/:appid/fls/entry_points/:entry_point/settings/transcode/custom?id=' \
--header 'Authorization: Basic <credentials>' \
--data '
{
"width": 0,
"height": 360,
"videoCodec": "h264",
"videoBitrate": 1200,
"profile": "base",
"audioCodec": "aac",
"audioBitrate": 320,
"audioSampleRate": 44100
}
'
响应示例
如果返回的 HTTP 状态码为 200,表示请求成功。