创建缩略图任务

接口描述

用户通过Bucket，BOS Key以及其他配置信息为指定媒体生成缩略图。

请求（Request）

• 请求语法：

  Http 复制

  1POST /v{version}/job/thumbnail 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参数
• 请求参数（均为requestbody参数）：

• 请求示例：

  Http 复制

  1POST /v3/job/thumbnail HTTP/1.1
  2accept-encoding: gzip, deflate
  3x-bce-date: 2025-08-04T13:08:44Z
  4host: media.bj.baidubce.com
  5accept: */*
  6connection: keep-alive
  7x-bce-request-id: d97c57d0-ca44-4d1c-bfeb-941a92440968
  8content-type: application/json
  9authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2025-08-04T13:08:44Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9
  10
  11{
  12    "pipelineName": "high_priority_pipe",
  13    "source": {
  14        "key": "samplefolderpath/samplevideo.mp4"
  15    },
  16    "target": {
  17        "keyPrefix": "sampleoutputfolderpath/samplethumbnail-",
  18        "format": "jpg",
  19        "sizingPolicy": "keep",
  20        "widthInPixel": "600",
  21        "heightInPixel": "450"
  22    },
  23    "capture": {
  24        "mode": "manual",
  25        "startTimeInSecond": "20",
  26        "endTimeInSecond": "50",
  27        "intervalInSecond": "10"
  28    },
  29    "delogoArea": {
  30        "x": 10,
  31        "y": 20,
  32        "width": 200,
  33        "height": 150
  34    }
  35}

响应（Reponse）

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

• 响应示例：

  Http 复制

  1HTTP/1.1 200 OK
  2Transfer-Encoding: chunked
  3x-bce-request-id: d97c57d0-ca44-4d1c-bfeb-941a92440968
  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-lsdspxdastsmnbam"
  11}

查询指定缩略图任务

请求（Request）

• 请求语法：

  Http 复制

  1GET /v{version}/job/thumbnail/{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/thumbnail/job-lsdspxdastsmnbam HTTP/1.1
  2accept-encoding: gzip, deflate
  3x-bce-date: 2025-08-04T13:08:44Z
  4host: media.bj.baidubce.com
  5accept: */*
  6connection: keep-alive
  7x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
  8content-type: application/json
  9authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2025-08-04T13:08:44Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9

响应（Reponse）

• 响应头域：无特殊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-lsdspxdastsmnbwx",
  11    "jobStatus": "success",
  12    "pipelineName": "high_priority_pipe",
  13    "source": {
  14        "key": "samplefolderpath/samplevideo.mp4"
  15    },
  16    "target": {
  17        "keyPrefix": "sampleoutputfolderpath/samplethumbnail-",
  18        "keys": [
  19            "sampleoutputfolderpath/samplethumbnail-00020000.jpg",
  20            "sampleoutputfolderpath/samplethumbnail-00030000.jpg",
  21            "sampleoutputfolderpath/samplethumbnail-00040000.jpg",
  22            "sampleoutputfolderpath/samplethumbnail-00050000.jpg"
  23        ],
  24        "format": "jpg",
  25        "sizingPolicy": "keep",
  26        "widthInPixel": "600",
  27        "heightInPixel": "450"
  28    },
  29    "capture": {
  30        "mode": "manual",
  31        "startTimeInSecond": "20",
  32        "endTimeInSecond": "50",
  33        "intervalInSecond": "10"
  34    },
  35    "delogoArea": {
  36        "x": 10,
  37        "y": 20,
  38        "width": 200,
  39        "height": 150
  40    }
  41}

查询指定队列的缩略图任务信息

请求（Request）

• 请求语法：

  Http 复制

  1GET /v{version}/job/thumbnail?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参数
• 请求参数（均为query参数）：

• 请求示例：

  Http 复制

  1GET /v3/job/thumbnail?pipelineName=high_priority_pipe&jobStatus=SUCCESS&begin=2025-08-04T08%3A53%3A42Z&end=2025-08-04T08%3A53%3A42Z&marker=job-feumm9etdd5c9gqv HTTP/1.1
  2accept-encoding: gzip, deflate
  3x-bce-date: 2025-08-04T13:08:44Z
  4host: media.bj.baidubce.com
  5accept: */*
  6connection: keep-alive
  7x-bce-request-id: d97c57d0-ca44-4d1c-bfeb-941a92440968
  8content-type: application/json
  9authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2025-08-04T13:08:44Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9

响应（Reponse）

• 响应头域：无特殊Header参数
• 响应参数：与[创建缩略图任务/请求/请求参数]保持一致，增加以下字段

• 响应示例：

  Plain Text 复制

  1  HTTP/1.1 200 OK
  2  Transfer-Encoding: chunked
  3  x-bce-request-id: d97c57d0-ca44-4d1c-bfeb-941a92440968
  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    "thumbnails": [
  11    {
  12      "createTime" : "2025-08-04T11:15:58Z",
  13      "endTime" : "2025-08-04T11:16:04Z",
  14      "jobId": "job-fgcivp49gvnggqq8",
  15      "jobStatus": "success",
  16      "pipelineName": "high_priority_pipe",
  17      "source": {
  18        "key": "samplefolderpath/samplevideo.mp4"
  19      },
  20      "target": {
  21        "keyPrefix": "sampleoutputfolderpath/samplethumbnail-",
  22        "keys": [
  23          "sampleoutputfolderpath/samplethumbnail-00045000.jpg"
  24        ],
  25        "format": "jpg",
  26        "sizingPolicy": "keep",
  27        "widthInPixel": "600",
  28        "heightInPixel": "450"
  29      },
  30      "capture": {
  31        "mode": "manual",
  32        "startTimeInSecond": "45",
  33        "endTimeInSecond": "50",
  34        "intervalInSecond": "10"
  35      }
  36    },
  37    {
  38      "createTime" : "2025-08-04T109:15:58Z",
  39      "endTime" : "2025-08-04T09:35:04Z",
  40      "jobId": "job-lsdspxdastsmnbwx",
  41      "jobStatus": "success",
  42      "pipelineName": "high_priority_pipe",
  43      "source": {
  44        "key": "samplefolderpath/samplevideo.mp4"
  45      },
  46      "target": {
  47        "keyPrefix": "sampleoutputfolderpath/samplethumbnail",
  48        "keys": [
  49          "sampleoutputfolderpath/samplethumbnail.jpg"
  50        ],
  51        "format": "jpg",
  52        "sizingPolicy": "shrinkToFit",
  53        "widthInPixel": "800",
  54        "heightInPixel": "600"
  55      },
  56      "capture": {
  57          "mode": "auto"
  58      }
  59    },
  60    {
  61      "createTime" : "2025-08-04T109:14:58Z",
  62      "endTime" : "2025-08-04T09:35:04Z",
  63      "jobId": "job-lsdspxiwpxsmnber",
  64      "jobStatus": "running",
  65      "pipelineName": "high_priority_pipe",
  66      "source": {
  67        "key": "samplefolderpath/samplevideo.mp4"
  68      },
  69      "target": {
  70        "keyPrefix": "samplefolderpath/samplevideo",
  71        "format": "jpg",
  72        "sizingPolicy": "keep",
  73        "widthInPixel": "1280",
  74        "heightInPixel": "450"
  75      },
  76      "capture": {
  77        "mode": "auto"
  78      }
  79    },
  80    {
  81      "createTime" : "2025-08-04T109:10:58Z",
  82      "endTime" : "2025-08-04T09:35:04Z",
  83      "jobId": "job-lsdspxiwpxsmnbeq",
  84      "jobStatus": "failed",
  85      "pipelineName": "high_priority_pipe",
  86      "source": {
  87        "key": "samplefolderpath/samplevideo.mp4"
  88      },
  89      "target": {
  90        "keyPrefix": "samplefolderpath/samplethumbnail-",
  91        "format": "jpg",
  92        "sizingPolicy": "keep",
  93        "widthInPixel": "1280",
  94        "heightInPixel": "450"
  95      },
  96      "capture": {
  97        "mode": "manual",
  98        "startTimeInSecond": "10"
  99      },
  100      "error": {
  101        "code": "InvalidInputData",
  102        "message": "The input data is invalid, please ..."
  103      }
  104    }
  105    ],
  106    "marker": "job-fgcivp49gvnggqq8",
  107    "isTruncated": false
  108  }