音视频点播VOD

    转码模板组接口

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

    创建转码模板组

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

    请求语法

    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
    上一篇
    播放器服务接口
    下一篇
    策略组接口