所有文档

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