视频点播

产品文档

视频点播

updateTranscodeTemplate

描述

修改转码模板

请求方式

PUT

请求地址

https://vod.jdcloud-api.com/v1/transcodeTemplates/{templateId}

请求参数

名称 类型 是否必需 默认值 描述
templateId Long True 模板ID
name String False 模板名称。长度不超过128个字符。UTF-8编码。
video Video False 视频参数配置
audio Audio False 音频参数配置
encapsulation Encapsulation False 封装配置
outFile OutFile False 输出文件配置
definition String False 清晰度规格标记。取值范围:
SD - 标清
HD - 高清
FHD - 超清
2K
4K
templateType String False 模板类型。取值范围:
jdchd - 京享超清
jdchs - 极速转码

OutFile

名称 类型 是否必需 默认值 描述
filePath String False 输出文件路径。
路径支持占位符 YEAR、MONTH、DAY、JOBID、TASKID、TEMPLATEID, VIDEOID,但对于转码输出路径,必须以 vod/product 为路径前缀。
最终生成的转码输出文件,将会是此路径和一个随机文件名共同构成。
若转码模板中该字段配置为:vod/product/{YEAR}{MONTH}{DAY}/{JOBID}/{TEMPLATEID}/{TASKID}
则最终生成的输出文件可能为:vod/product/20200921/8238/2243310/2378041/6b91f559d51b4b62ac60b98c318e9ae9.mp4

Encapsulation

名称 类型 是否必需 默认值 描述
format String False 封装格式

Audio

名称 类型 是否必需 默认值 描述
codec String False 音频编码。取值范围:aac
bitrate Integer False 音频目标码率。取值范围:[8,1000],单位为 Kbps
sampleRate Integer False 音频采样率。取值范围:8000、11025、12000、16000、22050、24000、32000、44100、48000、64000、88200、96000
channels Integer False 音频声道数:1、2
comfortable Boolean False 是否开启舒适音频:true、false

Video

名称 类型 是否必需 默认值 描述
codec String False 视频编码。取值范围:h265、h264
bitrate Integer False 视频码率。取值范围 [128、10000],单位为 Kbps
fps Integer False 视频帧率。取值范围为 [1、60],单位为 fps
width Integer False 视频输出宽度。取值范围 [128,4096] 整数。
当值为空时,若 height 也为空,则 width 和 height 与原视频保持一致;若 height 不为空,则 width 按照原视频的分辨率等比缩放。
height Integer False 视频输出高度。取值范围 [128,4096] 整数。
当值为空时,若 width 也为空,则 width 和 height 与原视频保持一致;若 width 不为空,则 height 按照原视频的分辨率等比缩放。

返回参数

名称 类型 描述
result Result 修改转码模板信息结果
requestId String 请求ID

Result

名称 类型 描述
id Long 模板ID
name String 模板名称。长度不超过128个字符。UTF-8编码。
video Video 视频参数配置
audio Audio 音频参数配置
encapsulation Encapsulation 封装配置
outFile OutFile 输出文件配置
definition String 清晰度规格标记。取值范围:
SD - 标清
HD - 高清
FHD - 超清
2K
4K
source String 模板来源。取值范围:
system - 系统预置
custom - 用户自建
templateType String 模板类型。取值范围:
jdchd - 京享超清
jdchs - 极速转码
createTime String 创建时间
updateTime String 修改时间

OutFile

名称 类型 描述
filePath String 输出文件路径。
路径支持占位符 YEAR、MONTH、DAY、JOBID、TASKID、TEMPLATEID, VIDEOID,但对于转码输出路径,必须以 vod/product 为路径前缀。
最终生成的转码输出文件,将会是此路径和一个随机文件名共同构成。
若转码模板中该字段配置为:vod/product/{YEAR}{MONTH}{DAY}/{JOBID}/{TEMPLATEID}/{TASKID}
则最终生成的输出文件可能为:vod/product/20200921/8238/2243310/2378041/6b91f559d51b4b62ac60b98c318e9ae9.mp4

Encapsulation

名称 类型 描述
format String 封装格式

Audio

名称 类型 描述
codec String 音频编码。取值范围:aac
bitrate Integer 音频目标码率。取值范围:[8,1000],单位为 Kbps
sampleRate Integer 音频采样率。取值范围:8000、11025、12000、16000、22050、24000、32000、44100、48000、64000、88200、96000
channels Integer 音频声道数:1、2
comfortable Boolean 是否开启舒适音频:true、false

Video

名称 类型 描述
codec String 视频编码。取值范围:h265、h264
bitrate Integer 视频码率。取值范围 [128、10000],单位为 Kbps
fps Integer 视频帧率。取值范围为 [1、60],单位为 fps
width Integer 视频输出宽度。取值范围 [128,4096] 整数。
当值为空时,若 height 也为空,则 width 和 height 与原视频保持一致;若 height 不为空,则 width 按照原视频的分辨率等比缩放。
height Integer 视频输出高度。取值范围 [128,4096] 整数。
当值为空时,若 width 也为空,则 width 和 height 与原视频保持一致;若 width 不为空,则 height 按照原视频的分辨率等比缩放。

返回码

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

请求示例

PUT

https://vod.jdcloud-api.com/v1/transcodeTemplates/10001

{
    "audio": {
        "bitrate": 200, 
        "channels": 2, 
        "codec": "ACC", 
        "comfortable": true, 
        "sampleRate": 44100
    }, 
    "definition": "HD", 
    "encapsulation": {
        "format": "FLV"
    }, 
    "name": "我的转码模板", 
    "outFile": {
        "filePath": "/vod/product/{YEAR}{MONTH}{DAY}/{TASKID}"
    }, 
    "templateType": "jdchd", 
    "video": {
        "bitrate": 1080, 
        "codec": "h264", 
        "fps": 20, 
        "height": 240, 
        "width": 320
    }
}

返回示例

{
    "requestId": "bgvmivir54gddpgi764se9f4kfr7ge41", 
    "result": {
        "audio": {
            "bitrate": 200, 
            "channels": 2, 
            "codec": "ACC", 
            "comfortable": true, 
            "sampleRate": 44100
        }, 
        "createTime": "2019-04-16T15:51:32Z", 
        "definition": "HD", 
        "encapsulation": {
            "format": "FLV"
        }, 
        "id": 10001, 
        "name": "我的转码模板", 
        "outFile": {
            "filePath": "/vod/product/{YEAR}{MONTH}{DAY}/{TASKID}"
        }, 
        "source": "custom", 
        "templateType": "jdchd", 
        "updateTime": "2019-04-16T15:51:32Z", 
        "video": {
            "bitrate": 1080, 
            "codec": "h264", 
            "fps": 20, 
            "height": 240, 
            "width": 320
        }
    }
}
更新时间:2020-11-23 17:16:00
文档反馈 docs feedback