# 示例3：提交视频截图任务
#### 场景描述
媒体处理可以在提交视频转码任务时配置截图参数，实现截图。若需要单独仅对某个视频文件进行截图而不转码，则可以调用视频截图接口来处理。
本章节指导用户如何使用API调用的方式提交视频截图任务。
#### 接口约束
不支持处理跨区域的媒资文件，如使用"华北-北京一"的MPC服务不能处理存储在"华北-北京四"OBS桶中的视频文件。
#### 前提条件
- 已获取需要创建截图任务区域的项目ID，具体获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-mpc/mpc_04_0064.html)。
- 已明确需要创建截图任务所在的区域信息，并获取该区域的Endpoint，您可以从[地区和终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint/MPC)获取。
- 待截图处理的视频文件已经存储在OBS桶中，您可以调用[OBS上传对象API](https://support.huaweicloud.com/api-obs/obs_04_0017.html)上传。
- 已创建用于存储截图文件的OBS桶，您可以调用[OBS创建桶API](https://support.huaweicloud.com/api-obs/obs_04_0015.html)进行创建。
 
#### 总体流程
- [获取用户Token]
- [创建截图任务]
- [查询视频截图执行情况]
 
#### 操作步骤
1. [获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)，用于MPC接口调用时的认证鉴权。
   
   在"我的凭证"页面获取***username*** 、***password*** 、***domainname*** 、***projectname*** ，调用如下接口获取Token。详细信息请参见[构造请求](https://support.huaweicloud.com/api-mpc/mpc_04_0048.html)。
   ```
   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   
   ![](https://support.huaweicloud.com/api-mpc/zh-cn_image_0000001835899629.png "点击放大")
   
   
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. 请求响应成功后，返回视频截图的详情信息。