文档首页> 媒体处理 MPC> API参考> 应用示例> 示例3:提交视频截图任务
更新时间:2024-03-14 GMT+08:00

示例3:提交视频截图任务

场景描述

媒体处理可以在提交视频转码任务时配置截图参数,实现截图。若需要单独仅对某个视频文件进行截图而不转码,则可以调用视频截图接口来处理。

本章节指导用户如何使用API调用的方式提交视频截图任务。

接口约束

不支持处理跨区域的媒资文件,如使用华北-北京一的MPC服务不能处理存储在华北-北京四OBS桶中的视频文件。

前提条件

  • 已获取需要创建截图任务区域的项目ID,具体获取方法请参见获取项目ID
  • 已明确需要创建截图任务所在的区域信息,并获取该区域的Endpoint,您可以从地区和终端节点获取。
  • 待截图处理的视频文件已经存储在OBS桶中,您可以调用OBS上传对象API上传。
  • 已创建用于存储截图文件的OBS桶,您可以调用OBS创建桶API进行创建。

操作步骤

  1. 获取用户Token,用于MPC接口调用时的认证鉴权。

    “我的凭证”页面获取usernamepassworddomainnameprojectname,调用如下接口获取Token。详细信息请参见构造请求
    POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens
    Content-Type: application/json
    {
      "auth": {
        "identity": {
          "methods": [
            "password"
          ],
          "password": {
            "user": {
              "name": "********", //用户名。
              "password": "********", //用户登录密码。
              "domain": {
                "name": "domainname" //用户所属的帐号名称。  
              }
            }
          }
        },
        "scope": {
          "project": {
             "name": "*******"  //项目名称。
          }
        }
      }
    }

    图1所示,红框中的信息为获取用户Token。

    图1 获取用户Token

  2. 创建截图任务。

    1. 选择POST请求方法并输入URI。
      https://{endpoint}/v1/{project_id}/thumbnails
    2. 请求消息头中增加“X-Auth-Token”,值设置为步骤1中获取的用户Token。
    3. Request Body中传入参数如下:
      {
      "input": {
                 "bucket": "example-bucket",
                 "location": "region01",
                 "object": "/mpc/input/sample.MP4"
      },
      "output": {
                 "bucket": "example-bucket",
                 "location": "region01",
                 "object": "/mpc/output/ "},
      
      "tar": 1,
      "thumbnail_para": {   
      		"type":"DOTS",
      		"dots":[2,4,6,8,10],      
      		"format":0,    
      		"aspect_ratio":1,     
      		"max_length":480  
      		} 
      } 
    4. 请求响应成功后,返回截图任务ID。
      {
          "task_id": "2081"
      }

  3. 查询视频截图执行情况。

    1. 选择GET请求方法并输入URI。
      https://{endpoint}/v1/{project_id}/thumbnails?task_id=2081
    2. 请求消息头中增加“X-Auth-Token”,值设置为步骤1中获取的用户Token。
    3. 请求响应成功后,返回视频截图的详情信息。