产品文档



媒体处理服务



帮助中心 > 媒体处理服务 > 创建转码模板

搜本产品



createTranscodeTemplate

描述

创建转码模板

请求方式

POST

请求地址

https://mps.jdcloud-api.com/v1/transcodeTemplates

请求参数

名称	类型	是否必需	描述
title	String	True	模板标题。长度不超过 128 个字符，最少 2 个字符。UTF-8 编码。
video	VideoStreamSettings	True	视频参数配置
audio	AudioStreamSettings	True	音频参数配置
container	ContainerSettings	True	容器封装配置
encryption	EncryptionSettings	False	加密配置
definition	String	True	清晰度规格标记。取值范围： SD - 标清 HD - 高清 FHD - 超清 2K 4K
transcodeType	String	False	转码方式。取值范围： normal - 普通转码 jdchd - 京享超清 jdchs - 极速转码默认值为 normal

EncryptionSettings

名称	类型	是否必需	描述
hlsKey	String	False	HLS加密公钥，按指定编码方式编码必须为 16 字节值，按照 hlsKeyEncodeType 所指定的编码方式进行编码后的字符串
hlsKeyUrl	String	False	HLS加密公钥地址，仅支持HTTP(s)地址若 hlsKey 已设置，则表示开启 HLS 加密，此时为必须参数
hlsKeyEncodeType	String	False	HLS加密公钥编码方式。取值范围：base16, base32, base64 若 hlsKey 已设置，则表示开启 HLS 加密，此时为必须参数

ContainerSettings

名称	类型	是否必需	默认值	描述
format	String	True		输出的音视频文件封装格式。取值范围：mp4、hls、flv

AudioStreamSettings

名称	类型	是否必需	描述
codec	String	True	音频编码。取值范围：aac 。目前仅支持 acc
bitrate	Integer	True	音频目标码率。取值范围：[8, 1000]，单位为 Kbps
sampleRate	Integer	False	音频采样率。若容器封装格式为 flv ，该字段为必须参数，其取值范围：22050、44100 若容器封装格式不为 flv ，则此字段为非必须参数，未设置时，与源文件音频采样率保持一致，若设置值，其取值范围：22050、24000、32000、44100、48000、64000、88200、96000
channels	Integer	False	音频声道数。取值范围：1、2 。默认值为 2
comfortable	Boolean	False	是否开启舒适音频。取值范围：true、false，默认值为 true

VideoStreamSettings

名称	类型	是否必需	描述
codec	String	True	视频编码。取值范围：h264、h265
rcmode	String	False	码率控制模式。取值范围： crf - 恒定码率系数模式。设置此模式时，rateFactor 生效，bitrate 会被忽略 abr - 平均码率模式。设置此模式时，bitrate 生效，rateFactor 会被忽略默认值为 abr
rateFactor	String	False	码率控制因子。取值范围：[0, 51]，支持2位小数的浮点数当 codec 为 h264 时，默认值为 23；当 codec 为 h265 时，默认值为 28
bitrate	Integer	False	视频码率。取值范围：[128, 10000]，单位为 Kbps
frameRate	Integer	False	视频帧率。取值范围：[1, 60]，单位为 fps 未设置时，与源文件视频帧率保持一致
width	Integer	False	视频输出宽度。取值范围：[128, 4096] 整数。单位为 px 未设置时，若 height 也未设置值，则 width 和 height 与原视频保持一致；若 height 设置值，则 width 按照原视频的分辨率等比缩放
height	Integer	False	视频输出高度。取值范围：[128, 4096] 整数。单位为 px 未设置时，若 width 也未设置值，则 width 和 height 与原视频保持一致；若 width 设置值，则 height 按照原视频的分辨率等比缩放

返回参数

名称	类型	描述
result	Result	创建转码模板结果
requestId	String	请求ID

Result

名称	类型	描述
templateId	String	模板ID
title	String	模板标题。长度不超过 128 个字符，最少 2 个字符。UTF-8 编码。
video	VideoStreamSettings	视频参数配置
audio	AudioStreamSettings	音频参数配置
container	ContainerSettings	容器设置
encryption	EncryptionSettings	加密配置
definition	String	清晰度规格标记。取值范围： SD - 标清 HD - 高清 FHD - 超清 2K 4K
transcodeType	String	转码方式。取值范围： normal - 普通转码 jdchd - 京享超清 jdchs - 极速转码
createTime	String	创建时间
updateTime	String	修改时间

EncryptionSettings

名称	类型	描述
hlsKey	String	HLS加密公钥，按指定编码方式编码必须为 16 字节值，按照 hlsKeyEncodeType 所指定的编码方式进行编码后的字符串
hlsKeyUrl	String	HLS加密公钥地址，仅支持HTTP(s)地址若 hlsKey 已设置，则表示开启 HLS 加密，此时为必须参数
hlsKeyEncodeType	String	HLS加密公钥编码方式。取值范围：base16, base32, base64 若 hlsKey 已设置，则表示开启 HLS 加密，此时为必须参数

ContainerSettings

名称	类型	描述
format	String	输出的音视频文件封装格式。取值范围：mp4、hls、flv

AudioStreamSettings

名称	类型	描述
codec	String	音频编码。取值范围：aac 。目前仅支持 acc
bitrate	Integer	音频目标码率。取值范围：[8, 1000]，单位为 Kbps
sampleRate	Integer	音频采样率。若容器封装格式为 flv ，该字段为必须参数，其取值范围：22050、44100 若容器封装格式不为 flv ，则此字段为非必须参数，未设置时，与源文件音频采样率保持一致，若设置值，其取值范围：22050、24000、32000、44100、48000、64000、88200、96000
channels	Integer	音频声道数。取值范围：1、2 。默认值为 2
comfortable	Boolean	是否开启舒适音频。取值范围：true、false，默认值为 true

VideoStreamSettings

名称	类型	描述
codec	String	视频编码。取值范围：h264、h265
rcmode	String	码率控制模式。取值范围： crf - 恒定码率系数模式。设置此模式时，rateFactor 生效，bitrate 会被忽略 abr - 平均码率模式。设置此模式时，bitrate 生效，rateFactor 会被忽略默认值为 abr
rateFactor	String	码率控制因子。取值范围：[0, 51]，支持2位小数的浮点数当 codec 为 h264 时，默认值为 23；当 codec 为 h265 时，默认值为 28
bitrate	Integer	视频码率。取值范围：[128, 10000]，单位为 Kbps
frameRate	Integer	视频帧率。取值范围：[1, 60]，单位为 fps 未设置时，与源文件视频帧率保持一致
width	Integer	视频输出宽度。取值范围：[128, 4096] 整数。单位为 px 未设置时，若 height 也未设置值，则 width 和 height 与原视频保持一致；若 height 设置值，则 width 按照原视频的分辨率等比缩放
height	Integer	视频输出高度。取值范围：[128, 4096] 整数。单位为 px 未设置时，若 width 也未设置值，则 width 和 height 与原视频保持一致；若 width 设置值，则 height 按照原视频的分辨率等比缩放

返回码

返回码	描述
200	OK
400	Invalid parameter
401	Authentication failed
500	Internal server error
503	Service unavailable

请求示例

POST

https://mps.jdcloud-api.com/v1/transcodeTemplates

{
    "audio": {
        "bitrate": 256, 
        "channels": 2, 
        "codec": "aac", 
        "comfortable": true, 
        "sampleRate": 44100
    }, 
    "container": {
        "format": "mp4"
    }, 
    "definition": "HD", 
    "encryption": {
        "hlsKey": "5ZSv5pyJ5YyX6bG877yM5Q==", 
        "hlsKeyEncodeType": "base64", 
        "hlsKeyUrl": "https://example.com/hlsenc.key"
    }, 
    "title": "我的转码模板", 
    "transcodeType": "jdchd", 
    "video": {
        "bitrate": 1024, 
        "codec": "h264", 
        "frameRate": "25", 
        "height": 240, 
        "rateFactor": "23", 
        "width": 320
    }
}

返回示例

{
    "requestId": "bgvmivir54gddpgi764se9f4kfr7ge41", 
    "result": {
        "audio": {
            "bitrate": 256, 
            "channels": 2, 
            "codec": "aac", 
            "comfortable": true, 
            "sampleRate": 44100
        }, 
        "container": {
            "format": "mp4"
        }, 
        "createTime": "2019-04-16T15:51:32Z", 
        "definition": "HD", 
        "encryption": {
            "hlsKey": "5ZSv5pyJ5YyX6bG877yM5Q==", 
            "hlsKeyEncodeType": "base64", 
            "hlsKeyUrl": "https://example.com/hlsenc.key"
        }, 
        "templateId": 10001, 
        "title": "我的转码模板", 
        "transcodeType": "jdchd", 
        "updateTime": "2019-04-16T15:51:32Z", 
        "video": {
            "bitrate": 1024, 
            "codec": "h264", 
            "frameRate": "25", 
            "height": 240, 
            "rateFactor": "23", 
            "width": 320
        }
    }
}