# 示例4：视频处理
#### 场景描述
音视频上传时，可以设置媒资处理参数，上传完成后，自动根据设置的参数进行音视频处理。若您需要对已上传的视频进行处理，您也可以调用VOD API实现。
本章节指导用户如何使用API调用的方式处理已上传的视频文件，包括视频转码、截图、加密等，支持同时启动多种处理操作，也可以只启动一种处理操作。
#### 前提条件
- 已明确需要处理的视频文件所在区域信息，详见[使用前必读](https://support.huaweicloud.com/api-vod/vod_04_0042.html)。
- 已获取需要处理的视频文件所在区域的项目ID，具体获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-vod/vod_04_0211.html)。
 
#### 总体流程
1. [获取用户Token]
2. [（可选）创建转码模板]
3. [（可选）设置搭建的密钥管理服务的URL]
4. [创建视频处理任务]
5. [查询视频处理执行情况]
 
#### 操作步骤
1. [获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)，用于调用点播接口时进行认证鉴权。
   
   详细信息请参见[构造请求](https://support.huaweicloud.com/api-vod/vod_04_0108.html)。以"华北-北京四"为示例，若您需要调用其它区域的点播接口，请替换成对应区域的[IAM终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint/VOD)。
   ```
   POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens
   Content-Type: application/json
   {
     "auth": {
       "identity": {
         "methods": [
           "password"
         ],
         "password": {
           "user": {
             "name": "username", 
             "password": "password", 
             "domain": {
               "name": "domainname"   
             }
           }
         }
       },
       "scope": {
         "project": {
            "name": "projectname"
         }
       }
     }
   }
   ```
   如[图1]所示，红框中的信息为获取用户Token。
   图1获取用户Token   
   ![](https://support.huaweicloud.com/api-vod/zh-cn_image_0174719076.png)
   
   
2. 在视频点播控制台创建自定义转码模板，具体操作请参见[转码设置](https://support.huaweicloud.com/usermanual-vod/vod_01_0072.html)。
   
   您也可以使用点播服务提供的系统转码模板。创建转码模板后，您可以在视频点播控制台获取需要使用的转码模板的模板名称。
   图2获取转码模板名称   
   ![](https://support.huaweicloud.com/api-vod/zh-cn_image_0259722482.png)
   
   
3. 在视频点播控制台配置搭建的密钥管理服务的URL，具体操作请参见[HLS加密设置](https://support.huaweicloud.com/usermanual-vod/vod_01_0073.html)。
   
   仅能对转码输出格式为HLS的视频进行加密。若不需要进行加密操作，可以跳过该步骤。
   图3加密设置   
   ![](https://support.huaweicloud.com/api-vod/zh-cn_image_0259722684.png)
   
   
4. 创建视频处理任务。
   
   1. 选择**POST** 请求方法并输入URI。
      ```
      https://{endpoint}/v1.0/{project_id}/asset/process
      ```
      
   
   2. 请求消息头中增加"X-Auth-Token"，值设置为[步骤1]中获取的用户Token。
   
   3. Request Body中传入参数如下：
      ```
      {
      "asset_id": "b4f39691d66cc0ef75d62ee567146e11",
      "template_group_name": "test",
      "auto_encrypt":0,
      "thumbnail":{
      "type":"time",
      "time":12
      
      },
      "subtitle_id":[1]
      }
      ```
      ![](https://support.huaweicloud.com/api-vod/public_sys-resources/note_3.0-zh-cn.png)
      仅在[示例1：媒资上传（20M以下）](https://support.huaweicloud.com/api-vod/vod_04_0195.html)时，请求参数设置了"subtitles"时，才可以在视频处理时，更换字幕文件，设置的"subtitle_id"才有效。
      
   
   4. 请求响应成功后，返回处理媒资ID。
      ```
      {
        "asset_id": "b4f39691d66cc0ef75d62ee567146e11"
      }
      ```
      
   
   
   
   
5. 调用查询详细信息接口查询视频处理执行情况，具体调用方法请参见[示例3：获取媒资详情](https://support.huaweicloud.com/api-vod/vod_04_0214.html)。
   
   视频处理任务执行的时间与视频文件的大小、设置的处理操作个数等有关，建议视频任务提交5-10分钟后再查询执行情况。