转码模板组接口

更新时间：2024-08-30

用户可以通过转码模板接口，自定义分辨率、码率、容器等多种转码参数，满足不同业务场景下的点播需求。

创建转码模板组

用户向服务请求创建转码模板组。

请求语法

POST /v{version}/presetgroup HTTP/1.1
accept-encoding: gzip, deflate
connection: keep-alive
accept: */*
host: vod.bj.baidubce.com
x-bce-date: {utc-date-string}
x-bce-request-id: {bce-request-id}
content-type: application/json
authorization: {bce-authorization-string}

请求头域

无特殊请求头域。

请求参数

字段名称	字段类型	是否必须	描述	可选值	默认值
name	String	是	模板组名称，用户命名空间唯一	允许小写字母、数字以及下划线且必须以字母开头，长度小于40个字符	-
description	String	否	模板组描述	长度小于等于1024个字符	-
preference	String	是	默认模板	必须是合法的子模板	-
transcodingPresets	Array	是	转码模板的集合	每个模板组必须包含1-10个（1,10包含）转码模板	-
+ name	String	是	模板名称，模板组命名空间唯一	允许小写字母、数字以及下划线且必须以字母开头，长度小于40个字符	-
+ container	String	否	音视频文件的容器	mp4, hls, a-hls, flv	mp4
+ video	Object	否	可选的转码参数	-	-
++ codecOptions	Object	否	视频编码的配置选项	-	-
+++ profile	String	否	baseline, main, high	baseline, main, high	baseline
++ maxWidthInPixel	Number	否	目标视频的最大宽度	128~4096, 且必须为2的倍数	不填写，表示与原始视频保持一致
++ maxHeightInPixel	Number	否	目标视频的最大高度	96~3072, 且必须为2的倍数	不填写，表示与原始视频保持一致
++ bitRateInBps	Number	否	视频目标码率	至少为32000且必须为1000的整数倍	不填写，默认使用32000

请求示例

POST /v1/presetgroup HTTP/1.1
accept-encoding: gzip, deflate
connection: keep-alive
accept: */*
host: vod.bj.baidubce.com
x-bce-date: 2015-03-24T13:37:10Z
x-bce-request-id: 3807ce30-5264-45f2-9b52-26b78e24a750
content-type: application/json
authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2015-03-24T13:37:10Z/1800/host;x-date/3e1bf9f50ae1fca2d704d61567810dde946fff3ca2e455676455a6f5c8cce596

{
    "name": "presetgroup_name",
    "description": "presetgroup_description",
    "preference" : "preset_1",
    "transcodingPresets": [
    {
        "name": "preset_1",
        "container": "mp4",
        "video":{
            "codecOptions": {
                "profile": "baseline"
            },
            "maxWidthInPixel": 1920,
            "maxHeightInPixel": 1080,
            "bitRateInBps": 3660000,
        }
    },
    {
        "name": "preset_2",
        "container": "hls",
        "video":{
            "codecOptions": {
                "profile": "main"
            },
            "maxWidthInPixel": 1024,
            "maxHeightInPixel": 768,
            "bitRateInBps": 256000,
        }
    }
    ]
}

响应头域

无特殊响应头域。

响应参数

无。

响应示例

HTTP/1.1 200 OK
Transfer-Encoding: chunked
x-bce-request-id: 3807ce30-5264-45f2-9b52-26b78e24a750
Cache-Control: no-cache
Server: BWS
Date: Tue, 24 Mar 2015 13:37:10 GMT
Content-Type: application/json;charset=UTF-8

查询指定转码模板组

指定转码模板组名称，查询这个转码模板组的详细信息。

请求语法

GET /v{version}/presetgroup/{presetGroupName} HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: {utc-date-string}
connection: keep-alive
accept: */*
host: vod.bj.baidubce.com
x-bce-request-id: {bce-request-id}
content-type: application/json
authorization: {bce-authorization-string}

请求头域

无特殊请求头域。

请求参数

无。

请求示例

GET /v1/presetgroup/presetgroup_name HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: 2015-03-24T13:08:44Z
connection: keep-alive
accept: */*
host: vod.bj.baidubce.com
x-bce-request-id: d97c57d0-ca44-4d1c-bfeb-941a92440968
content-type: application/json
authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2015-03-24T13:08:44Z/1800/host;x-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9

响应头域

无特殊响应头域。

响应参数

字段名称	字段类型	是否必须	描述	可选值	默认值
name	String	是	模板组名称，用户命名空间唯一	允许小写字母、数字以及下划线且必须以字母开头，长度小于40个字符	-
description	String	否	模板组描述	长度小于等于1024个字符	-
preference	String	是	默认模板	必须是合法的子模板	-
createdTime	String	否	转码模板创建的UTC格式的时间	-	-
transcodingPresets	Array	是	转码模板的集合	每个模板组必须包含1-10个（1,10包含）转码模板	-
+ name	String	是	模板名称，模板组命名空间唯一	允许小写字母、数字以及下划线且必须以字母开头，长度小于40个字符	-
+ container	String	否	音视频文件的容器	mp4, hls, a-hls, flv	mp4
+ video	Object	否	可选的转码参数	-	-
++ codecOptions	Object	否	视频编码的配置选项	-	-
+++ profile	String	否	baseline, main, high	baseline, main, high	baseline
++ maxWidthInPixel	Number	否	目标视频的最大宽度	128~4096, 且必须为2的倍数	不填写，表示与原始视频保持一致
++ maxHeightInPixel	Number	否	目标视频的最大高度	96~3072, 且必须为2的倍数	不填写，表示与原始视频保持一致
++ bitRateInBps	Number	否	视频目标码率	至少为32000且必须为1000的整数倍	不填写，默认使用32000

响应示例

HTTP/1.1 200 OK
Transfer-Encoding: chunked
x-bce-request-id: d97c57d0-ca44-4d1c-bfeb-941a92440968
Cache-Control: no-cache
Server: BWS
Date: Tue, 24 Mar 2015 13:34:07 GMT
Content-Type: application/json;charset=UTF-8

{
    "name": "presetgroup_name",
    "createTime": "2016-07-05T12:01:08Z",
    "description": "presetgroup_description",
    "transcodingPresets": [
    {
        "name": "preset_1",
        "container": "mp4",
        "video":{
            "codecOptions": {
                "profile": "baseline"
            },
            "maxWidthInPixel": 1920,
            "maxHeightInPixel": 1080,
            "bitRateInBps": 3660000,
        }
    },
    {
        "name": "preset_2",
        "container": "hls",
        "video":{
            "codecOptions": {
                "profile": "main"
            },
            "maxWidthInPixel": 1024,
            "maxHeightInPixel": 768,
            "bitRateInBps": 256000,
        }
    }
    ]
}

查询用户所有转码模板组

查询已创建的全部转码模板组详细信息，包括系统默认和用户自定义创建的转码模板组。

请求语法

GET /v{version}/presetgroup HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: {utc-date-string}
connection: keep-alive
accept: */*
host: vod.bj.baidubce.com
x-bce-request-id: {bce-request-id}
content-type: application/json
authorization: {bce-authorization-string}

请求头域

无特殊请求头域。

请求参数

无。

请求示例

GET /v1/presetgroup HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: 2015-03-24T13:08:44Z
host: vod.bj.baidubce.com
accept: */*
connection: keep-alive
x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
content-type: application/json
authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2015-03-24T13:08:44Z/1800/host;x-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9

响应头域

无特殊响应头域。

响应参数

字段名称	字段类型	是否必须	描述	可选值	默认值
name	String	是	模板组名称，用户命名空间唯一	允许小写字母、数字以及下划线且必须以字母开头，长度小于40个字符	-
description	String	否	模板组描述	长度小于等于1024个字符	-
preference	String	是	默认模板	必须是合法的子模板	-
createdTime	String	否	转码模板创建的UTC格式的时间	-	-
transcodingPresets	Array	是	转码模板的集合	每个模板组必须包含1-10个（1,10包含）转码模板	-
+ name	String	是	模板名称，模板组命名空间唯一	允许小写字母、数字以及下划线且必须以字母开头，长度小于40个字符	-
+ container	String	否	音视频文件的容器	mp4, hls, a-hls, flv	mp4
+ video	Object	否	可选的转码参数	-	-
++ codecOptions	Object	否	视频编码的配置选项	-	-
+++ profile	String	否	baseline, main, high	baseline, main, high	baseline
++ maxWidthInPixel	Number	否	目标视频的最大宽度	128~4096, 且必须为2的倍数	不填写，表示与原始视频保持一致
++ maxHeightInPixel	Number	否	目标视频的最大高度	96~3072, 且必须为2的倍数	不填写，表示与原始视频保持一致
++ bitRateInBps	Number	否	视频目标码率	至少为32000且必须为1000的整数倍	不填写，默认使用32000

响应示例

HTTP/1.1 200 OK
Transfer-Encoding: chunked
x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
Cache-Control: no-cache
Server: BWS
Date: Tue, 24 Mar 2015 13:08:44 GMT
Content-Type: application/json;charset=UTF-8

{
    "presetGroups": [
    {
        "name": "presetgroup_name",
        "createTime": "2016-07-05T12:01:08Z",
        "description": "presetgroup_description",
        "transcodingPresets": [
        {
            "name": "preset_1",
            "container": "mp4",
            "video":{
                "codecOptions": {
                    "profile": "baseline"
                },
                "maxWidthInPixel": 1920,
                "maxHeightInPixel": 1080,
                "bitRateInBps": 3660000,
            }
        },
        {
            "name": "preset_2",
            "container": "hls",
            "video":{
                "codecOptions": {
                    "profile": "main"
                },
                "maxWidthInPixel": 1024,
                "maxHeightInPixel": 768,
                "bitRateInBps": 256000,
            }
        }
        ]
    },
    {
        "name": "bce.vod.a-hls",
        "createTime": "2016-07-01T12:01:08Z",
        "description": "vod adaptive hls presetgroup",
        "transcodingPresets": [
        {
            "name": "a-hls",
            "container": "a-hls",
            "video":{
                "codecOptions": {
                    "profile": "baseline"
                },
                "maxWidthInPixel": 1920,
                "maxHeightInPixel": 1080,
                "bitRateInBps": 3660000,
            }
        }
        ]
    }
    ]
}

更新指定转码模板

指定转码模板组名称，更新指定转码模板组的内容。

请求语法

PUT /v{version}/presetgroup/{presetGroupName} HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: {utc-date-string}
connection: keep-alive
accept: */*
host: vod.bj.baidubce.com
x-bce-request-id: {bce-request-id}
content-type: application/json
authorization: {bce-authorization-string}

请求头域

无特殊请求头域。

请求参数

字段名称	字段类型	是否必须	描述	可选值	默认值
name	String	是	模板组名称，用户命名空间唯一	允许小写字母、数字以及下划线且必须以字母开头，长度小于40个字符	-
description	String	否	模板组描述	长度小于等于1024个字符	-
preference	String	是	默认模板	必须是合法的子模板	-	-
transcodingPresets	Array	是	转码模板的集合	每个模板组必须包含1-10个（1,10包含）转码模板	-
+ name	String	否	模板名称，模板组命名空间唯一	允许小写字母、数字以及下划线且必须以字母开头，长度小于40个字符	-
+ container	String	否	音视频文件的容器	mp4, hls, a-hls, flv	mp4
+ video	Object	否	可选的转码参数	-	-
++ codecOptions	Object	否	视频编码的配置选项	-	-
+++ profile	String	否	baseline, main, high	baseline, main, high	baseline
++ maxWidthInPixel	Number	否	目标视频的最大宽度	128~4096, 且必须为2的倍数	不填写，表示与原始视频保持一致
++ maxHeightInPixel	Number	否	目标视频的最大高度	96~3072, 且必须为2的倍数	不填写，表示与原始视频保持一致
++ bitRateInBps	Number	否	视频目标码率	至少为32000且必须为1000的整数倍	不填写，默认使用32000

请求示例

PUT /v1/presetgroup/presetgroup_name HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: 2015-07-03T09:28:13Z
host: vod.bj.baidubce.com
accept: */*
connection: keep-alive
x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
content-type: application/json
authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715

{
    "name": "presetgroup_name",
    "description": "presetgroup_description",
    "preference" : "preset_3",
    "transcodingPresets": [
    {
        "name": "preset_1",
        "container": "mp4",
        "video":{
            "codecOptions": {
                "profile": "baseline"
            },
            "maxWidthInPixel": 1920,
            "maxHeightInPixel": 1080,
            "bitRateInBps": 3660000,
        }
    },
    {
        "name": "preset_2",
        "container": "hls",
        "video":{
            "codecOptions": {
                "profile": "main"
            },
            "maxWidthInPixel": 1024,
            "maxHeightInPixel": 768,
            "bitRateInBps": 256000,
        }
    },
    {
        "name": "preset_3",
        "container": "hls",
        "video":{
            "codecOptions": {
                "profile": "hight"
            },
            "maxWidthInPixel": 720,
            "maxHeightInPixel": 576,
            "bitRateInBps": 512000,
        }
    }
    ]
}

响应头域

无特殊响应头域。

响应参数 无

响应示例

HTTP/1.1 200 OK
x-bce-request-id: 6d0b0a36-2ffe-49d4-9d81-333a9ab9417e
Date: Tue, 24 Mar 2015 13:06:02 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Cache-Control: no-cache

删除转码模板组

指定转码模板组名称，删除指定转码模板组。

请求语法

DELETE /v{version}/presetgroup/{presetGroupName} HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: {utc-date-string}
connection: keep-alive
accept: */*
host: vod.bj.baidubce.com
x-bce-request-id: {bce-request-id}
content-type: application/json
authorization: {bce-authorization-string}

请求头域

无特殊请求头域。

请求参数 无

请求实例

DELETE /v1/presetgroup/presetgroup_name HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: 2015-07-07T09:28:13Z
host: vod.bj.baidubce.com
accept: */*
connection: keep-alive
x-bce-request-id: 012b9747-f13a-4a2c-a488-02b221844dca
content-type: application/json
authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-07T09:28:13Z/1800/content-type;host;x-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715

响应头域

无特殊响应头域。

响应参数 无

响应示例

HTTP/1.1 200 OK
Transfer-Encoding: chunked
x-bce-request-id: 012b9747-f13a-4a2c-a488-02b221844dca
Cache-Control: no-cache
Server: BWS
Date: Tue, 24 Mar 2015 13:34:07 GMT
Content-Type: application/json;charset=UTF-8

百度智能云

智能点播平台 VOD

智能点播平台 VOD

转码模板组接口

创建转码模板组

查询指定转码模板组

查询用户所有转码模板组

更新指定转码模板

删除转码模板组