视频转码任务接口

创建视频转码任务

接口描述

用户通过该接口创建转码任务，支持多视频合并。

请求（Request）

• 请求语法：

  Http 复制

  1POST /v{version}/job/transcoding HTTP/1.1
  2accept-encoding: gzip, deflate
  3x-bce-date: {utc-date-string}
  4connection: keep-alive
  5accept: */*
  6host: media.bj.baidubce.com
  7x-bce-request-id: {bce-request-id}
  8content-type: application/json
  9authorization: {bce-authorization-string}

• 请求头域：无特殊Header参数
• 请求参数：

• 请求示例：

  Http 复制

  1POST /v3/job/transcoding HTTP/1.1
  2accept-encoding: gzip, deflate
  3x-bce-date: 2015-03-24T13:06:02Z
  4connection: keep-alive
  5accept: */*
  6host: media.bj.baidubce.com
  7x-bce-request-id: 6d0b0a36-2ffe-49d4-9d81-333a9ab9417e
  8content-type: application/json
  9authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2015-03-24T13:06:02Z/1800/host;x-bce-date/02f64774999996903cffa5ae4d6eef436127a96f581a4e8467497e239d824be8
  10{
  11    "pipelineName": "high_priority_pipe",
  12    "source": {
  13        "clips": [
  14            {
  15                "sourceKey": "input_media1.mp4",
  16                "startTimeInSecond": 0,
  17                "durationInSecond": 300
  18            },
  19            {
  20                "sourceKey": "input_media2.mp4"
  21            },
  22            {
  23                "sourceKey": "input_media3.mp4"
  24            }
  25        ]
  26    },
  27    "target": {
  28        "targetKey": "SampleOutput.mp4",
  29        "presetName": "bce.video_mp4_1280x720_1728kbps",
  30        "delogoArea": {
  31            "x": 10,
  32            "y": 20,
  33            "width": 200,
  34            "height": 150
  35        },
  36        "inserts": [
  37            {
  38                "bucket" : "samplebucket",
  39                "key" : "samplefolderpath/samplepicture.png",
  40                "type": "image",
  41                "layout": {
  42                    "verticalAlignment" : "bottom",
  43                    "horizontalAlignment" : "left",
  44                    "verticalOffsetInPixel" : 0,
  45                    "horizontalOffsetInPixel" : 0,
  46                },
  47                "timeline" : {
  48                    "startTimeInMillisecond" : 5000,
  49                    "durationInMillisecond" : 65500
  50                }
  51             }
  52         ]
  53    }
  54}

响应（Response）

• 响应头域：无特殊Header参数
• 响应参数：

• 响应示例：

  Http 复制

  1HTTP/1.1 200 OK
  2Transfer-Encoding: chunked
  3x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
  4Cache-Control: no-cache
  5Server: BWS
  6Date: Tue, 24 Mar 2015 13:34:07 GMT
  7Content-Type: application/json;charset=UTF-8
  8
  9{
  10    "jobId":"job-fczspxdutvmnbamq"
  11}

查询指定队列的视频转码任务信息

接口描述

查询指定队列下满足一定条件的所有转码任务。

请求（Request）

• 请求语法：

  Http 复制

  1GET /v{version}/job/transcoding?pipelineName={pipelineName}&jobStatus={jobStatus}&begin={begin}&end={end}}&marker={marker}&maxSize={maxSize} HTTP/1.1
  2accept-encoding: gzip, deflate
  3x-bce-date: {utc-date-string}
  4host: media.bj.baidubce.com
  5accept: */*
  6connection: keep-alive
  7x-bce-request-id: {bce-request-id}
  8content-type: application/json
  9authorization: {bce-authorization-string}

• 请求头域：无特殊Header参数
• 请求参数：

• 请求示例：

  Http 复制

  1GET /v3/job/transcoding?pipelineName=high_priority_pipe&jobStatus=SUCCESS&begin=2015-06-15T08%3A53%3A42Z&end=2015-06-18T08%3A53%3A42Z&marker=job-feumm9etdd5c9gqv&maxSize=2 HTTP/1.1
  2accept-encoding: gzip, deflate
  3x-bce-date: 2015-03-24T13:37:10Z
  4host: media.bj.baidubce.com
  5accept: */*
  6connection: keep-alive
  7x-bce-request-id: 3807ce30-5264-45f2-9b52-26b78e24a750
  8content-type: application/json
  9authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2015-03-24T13:37:10Z/1800/host;x-bce-date/3e1bf9f50ae1fca2d704d61567810dde946fff3ca2e455676455a6f5c8cce596

响应（Response）

• 响应头域：无特殊Header参数
• 响应参数：与[创建视频转码任务/请求/请求参数]保持一致，不返回inserts、crop信息，增加以下字段

• 响应示例：

  Plain Text 复制

  1  HTTP/1.1 200 OK
  2  Transfer-Encoding: chunked
  3  x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
  4  Cache-Control: no-cache
  5  Server: BWS
  6  Date: Tue, 24 Mar 2015 13:34:07 GMT
  7  Content-Type: application/json;charset=UTF-8
  8
  9  {
  10    "jobs" : [
  11    {
  12      "jobId" : "job-feumm9etdd5c9gqv",
  13      "pipelineName" : "createjob_20383",
  14      "source" : {
  15        "sourceKey" : "jobtest.mp3"
  16      },
  17      "target" : {
  18        "targetKey" : "jobtest_result.mp3",
  19        "presetName" : "bce.audio_mp3_320kbps"
  20      },
  21      "jobStatus" : "SUCCESS",
  22      "createTime" : "2015-05-19T11:15:58Z",
  23      "startTime" : "2015-05-19T11:16:02Z",
  24      "endTime" : "2015-05-19T11:16:04Z"
  25    },
  26    {
  27      "jobId" : "job-feumnkz275ve7eqn",
  28      "pipelineName" : "createjob_319293",
  29      "source" : {
  30        "clips": [
  31          {
  32            "sourceKey": "input_media1.mp4",
  33            "startTimeInSecond": 0,
  34            "durationInSecond": 300
  35          },
  36          {
  37            "sourceKey": "input_media2.mp4"
  38          },
  39          {
  40            "sourceKey": "input_media3.mp4"
  41          }
  42        ]
  43      },
  44      "target" : {
  45        "targetKey" : "jobtest_result.mp4",
  46        "presetName" : "bce.video_mp4_1280x720_1728kbps",
  47        "delogoArea": {
  48          "x": 10,
  49          "y": 20,
  50          "width": 200,
  51          "height": 150
  52        },
  53        "watermarkIds":["wmk-hkit7ufxyx733ctw"]
  54      },
  55      "jobStatus" : "FAILED",
  56      "createTime" : "2015-05-19T11:40:39Z",
  57      "startTime" : "2015-05-19T11:40:43Z",
  58      "endTime" : "2015-05-19T11:40:45Z",
  59      "error" : {
  60        "code" : "ParameterError",
  61        "message" : "Parameter error"
  62      }
  63    }
  64    ],
  65    "marker": "job-feumm9etdd5c9gqv",
  66    "isTruncated": true,
  67    "nextMarker": "job-gfpj59idrpygsjtw"
  68  }

查询指定视频转码任务

接口描述

通过指定jobId查询该任务的信息。

请求（Request）

• 请求语法：

  Http 复制

  1GET /v{version}/job/transcoding/{jobId} HTTP/1.1
  2accept-encoding: gzip, deflate
  3x-bce-date: {utc-date-string}
  4host: media.bj.baidubce.com
  5accept: */*
  6connection: keep-alive
  7x-bce-request-id: {bce-request-id}
  8content-type: application/json
  9authorization: {bce-authorization-string}

• 请求头域：无特殊Header参数
• 请求参数：无

• 请求示例：

  Http 复制

  1GET /v3/job/transcoding/job-fczspxdutvmnbamq HTTP/1.1
  2accept-encoding: gzip, deflate
  3x-bce-date: 2015-03-24T13:06:02Z
  4host: media.bj.baidubce.com
  5accept: */*
  6connection: keep-alive
  7x-bce-request-id: 3807ce30-5264-45f2-9b52-26b78e24a750
  8content-type: application/json
  9authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2015-03-24T13:06:02Z/1800/host;x-bce-date/02f64774999996903cffa5ae4d6eef436127a96f581a4e8467497e239d824be8

响应（Response）

• 响应头域：无特殊Header参数
• 响应参数：与[创建视频转码任务/请求/请求参数]保持一致，不返回inserts、crop信息，增加以下字段

• 响应示例：

  Http 复制

  1HTTP/1.1 200 OK
  2Transfer-Encoding: chunked
  3x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
  4Cache-Control: no-cache
  5Server: BWS
  6Date: Tue, 24 Mar 2015 13:34:07 GMT
  7Content-Type: application/json;charset=UTF-8
  8
  9{
  10    "jobId" : "job-feuncr26j02713wc",
  11    "pipelineName" : "createjob_388070",
  12    "source" : {
  13        "sourceKey" : "media/info/jobtest.mp3"
  14    },
  15    "target" : {
  16        "targetKey" : "jobtest_result.mp3",
  17        "presetName" : "createjob_388070",
  18        "delogoArea": {
  19            "x": 10,
  20            "y": 20,
  21            "width": 200,
  22            "height": 150
  23        },
  24        "watermarkIds":["wmk-hkit7ufxyx733ctw"]
  25    },
  26    "jobStatus" : "FAILED",
  27    "createTime" : "2015-05-19T12:28:39Z",
  28    "startTime" : "2015-05-19T12:28:41Z",
  29    "endTime" : "2015-05-19T12:28:44Z",
  30    "error" : {
  31        "code" : "ParameterError",
  32        "message" : "Parameter error"
  33    }
  34}

合并多个视频

创建转码任务 API 中增加 clips 数组用于支持视频合并，该功能按照 clips 中的先后顺序合并成一个完整视频。

注意：

• clips和sourceKey不可共存，通过clips可指定1到200个输入片段。
• 对模板中三种不同尺寸伸缩策略（Keep，ShrinkToFit / ShrinkToFitBlur，Stretch）的处理和限制：

1. 如果Keep模式，即保持原始的宽高比例

• 输入：此时合并的多个视频必须具有同样的宽高比例，否则报错。
• 输出：比较所有输入源视频和模板的宽高，从中选择最小的一组宽高作为输出的宽高。

2. 如果是 ShrinkToFit / ShrinkToFitBlur 模式

• 输入：无限制
• 输出：Preset指定的宽高，并保持视频源的宽高比，填充黑边。当指定分片asMasterClip参数（该分片为主分片）时，输出分辨率保持主分片宽高比，其他分片参考输出分辨率填充黑边进行对齐。

3. 如果是Stretch模式

• 输入：无限制
• 输出：Preset指定的宽和高，视频拉伸或者收缩。

• 目前仅支持普通队列合并多个视频，加速队列暂不支持。

keep伸缩模式时的处理策略

当选择keep伸缩模式时，视频的宽高比保持不变，对视频进行相应的缩放。缩放分以下两种情况：

1. 输入视频宽高分别小于模板Preset设置的宽高。

   • 处理方式：目标视频保持原始宽高，不进行缩放。

2. 输入视频宽大于模板的宽或输入视频的高大于模板高。

   • 处理方式：选择缩放比例较小的边进行缩放，使得视频的宽或高等于模板的宽或高。

常见错误码和错误信息

转码任务常见的错误码及错误信息如下表所示：