
# 示例1：创建转码模板
本节通过调用一系列直播的API来创建转码模板。
#### 涉及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)，用于调用直播接口时进行认证鉴权。
   
   详细信息请参见[构造请求](https://support.huaweicloud.com/api-live/topic_live_04_overview_100003.html)。以"华北-北京四"为示例，若您需要调用其它区域的直播接口，请替换成对应区域的[IAM终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint/Live)。
   ```
   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-live/zh-cn_image_0172507471.png)
   
   
2. 选择**POST** 请求方法，并输入请求URI。
   
   ```
   POST https://live.cn-north-4.myhuaweicloud.com/v1/{project_id}/template/transcodings
   ```
   "live.cn-north-4.myhuaweicloud.com"为直播服务的终端节点，您可以在[使用前必读](https://support.huaweicloud.com/api-live/live_03_0052.html)中获取。
   ![](https://support.huaweicloud.com/api-live/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. 在请求消息体中传入如下所示的参数，具体参数说明可参考[创建直播转码模板](https://support.huaweicloud.com/api-live/live_03_0007.html)接口。
   
   ```
   {
     "domain": "play.example.com",
     "app_name": "live",
     "quality_info":
     [
       {
         "templateName": "",
         "quality": "lsd",
         "hdlb": "off",
         "PVC": "off",
         "codec": "H264",
         "width": 854,
         "height": 480,
         "bitrate": 600,
         "video_frame_rate": 0,
         "protocol": "HLS",
         "iFrameInterval": 0
       }
     ]
   }
   ```
   请求响应成功后，无返回参数，状态码为201 Created。
   若请求失败，返回如下所示的错误码及错误描述，状态码为400 Bad Request。
   ```
   "error_code": "LIVE.100011001",
   "error_msg": "模板配置校验失败"
   ```
   
   
 
