示例1：新建转码模板

场景描述

若您需要使用自定义的转码模板进行音视频转码，可以先在提交转码任务前，按实际需求创建转码模板。

前提条件

• 已获取需要创建转码模板区域的项目ID，具体获取方法请参见获取项目ID。
• 已明确需要创建转码模板所在的区域信息，并获取该区域的Endpoint，您可以从地区和终端节点获取。

总体流程

• 获取用户Token
• 创建转码模板

涉及API

当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。

操作步骤

1. 获取用户Token，用于MPC接口调用时的认证鉴权。
   在“我的凭证”页面获取username、password、domainname、projectname，调用如下接口获取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. 选择POST请求方法并输入URI。

    https://{endpoint}/v1/{project_id}/template/transcodings

   “mpc.cn-north-4.myhuaweicloud.com”为媒体处理服务的终端节点，您可以在区域和终端节点中获取。

   

   调用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。"
   }