# 示例1：新建转码模板
#### 场景描述
若您需要使用自定义的转码模板进行音视频转码，可以先在提交转码任务前，按实际需求创建转码模板。
#### 前提条件
- 已获取需要创建转码模板区域的项目ID，具体获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-mpc/mpc_04_0064.html)。
- 已明确需要创建转码模板所在的区域信息，并获取该区域的Endpoint，您可以从[地区和终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint/MPC)获取。
 
#### 总体流程
- [获取用户Token]
- [创建转码模板]
 
#### 涉及API
当您使用Token认证方式完成认证鉴权时，需要[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)并在调用接口时增加"X-Auth-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. 选择**POST** 请求方法并输入URI。
   
   ```
   https://{endpoint}/v1/{project_id}/template/transcodings
   ```
   "mpc.cn-north-4.myhuaweicloud.com"为媒体处理服务的终端节点，您可以在[区域和终端节点](https://support.huaweicloud.com/api-mpc/mpc_04_0001.html#mpc_04_0001__section1843162314719)中获取。
   ![](https://support.huaweicloud.com/api-mpc/public_sys-resources/note_3.0-zh-cn.png)
   调用IAM接口的区域需与调用媒体处理接口的区域一致，如调用"cn-north-4"区域的IAM接口获取用户Token，则该Token仅能用于调用"cn-north-4"区域媒体处理接口的鉴权。
   
   
3. 在请求消息头中增加"X-Auth-Token"，值设置为步骤[1]中获取的用户Token。
4. 在请求消息体中传入如下所示的参数。 
   ```
   {
   "template_name":"MP4_H.264_1920x1080_6000_HEAAC",
   "video":{
   "codec":1,
   "bitrate":6000,
   "profile":3,
   "level":15,
   "preset":3,
   "ref_frames_count":4,
   "max_iframes_interval":5,
   "bframes_count":4,
   "frame_rate":1,
   "width":1920,
   "height":1080,
   "aspect_ratio":0
   },
   "audio":{
   "codec":1,
   "sample_rate":4,
   "bitrate":128,
   "channels":2
   },
   "common":{
   "PVC":0,
   "hls_interval":5,
   "dash_interval":5,
   "pack_type":1
   }
   }
   ```
   请求响应成功后，返回转码模板ID，状态码为201 Created。
   ```
   {
     "template_id":1001
   }
   ```
   若请求失败，返回如下所示的错误码及错误描述。
   ```
   {
     "error_code": "MPC.100101",
     "error_msg": "template error, it's name MP4_H.264_1920x1080_6000_HEAAC is same with template 274764。"
   }
   ```