Modifies a transcoding template

Function

URI

PUT /v2/{project_id}/asset/template/transcodings

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details about how to obtain the project ID, see Obtaining a Project ID.

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	No	String	User token. This parameter is mandatory when token authentication is used. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is a token.
Authorization	No	String	Authentication information. This parameter is mandatory for AK/SK authentication.
X-Sdk-Date	No	String	Time when the request is sent. This parameter is mandatory for AK/SK authentication.

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
group_id	Yes	String	Template group ID.
name	No	String	Template group name.
is_default	No	Boolean	Indicates whether the template is the default transcoding template. The default value is false. If the value is not specified, the default value is used.
is_auto_encrypt	No	Boolean	Indicates whether to encrypt data. The default value is false, indicating that data is not encrypted.
quality_info_list	Yes	Array of QualityInfoList objects	Image quality configuration list. If this parameter is not carried or is left empty, the data of this part in the template will not be updated.
watermark_template_ids	No	Array of strings	ID array of the bound watermark template group.
description	No	String	Template description.
common	Yes	CommonInfo object	Low-bitrate HD transcoding switch, encoding format, and multi-stream common parameters.

**Table 4** QualityInfoList
Parameter	Mandatory	Type	Description
video	Yes	VideoInfo object	Video template information. Configure at least one of the video and audio parameters.
audio	No	AudioInfo object	Audio template information

**Table 5** VideoInfo
Parameter	Mandatory	Type	Description
quality	Yes	String	Video quality. The default 4K resolution is 3840 x 2160 and the bitrate is 8000 kbit/s. The default 2K resolution is 2560 x 1440 and the bitrate is 7000 kbit/s. The default FULL_HD resolution is 1920 x 1080 and the bitrate is 3000 kbit/s. The default HD resolution is 1280 x 720 and the bitrate is 1000 kbit/s. The default SD resolution is 854 x 480 and the bitrate is 600 kbit/s. The default FLUENT resolution is 480 x 270 and the bitrate is 300 kbit/s.
width	No	Integer	Video width.
height	No	Integer	Video height.
bitrate	Yes	Integer	Bitrate, in kbit/s.
frame_rate	Yes	Integer	Frame rate (in FPS), which defaults to 0 indicating adaptive frame rate.

**Table 6** AudioInfo
Parameter	Mandatory	Type	Description
sample_rate	Yes	String	Audio sampling rate. Possible options: AUDIO_SAMPLE_AUTO (default) AUDIO_SAMPLE_22050: 22050 Hz AUDIO_SAMPLE_32000: 32000 Hz AUDIO_SAMPLE_44100: 44100 Hz AUDIO_SAMPLE_48000: 48000 Hz AUDIO_SAMPLE_96000: 96000 Hz
bitrate	No	Integer	Audio bitrate, in kbit/s.
channels	Yes	String	Number of audio channels. Possible options: AUDIO_CHANNELS_1: mono AUDIO_CHANNELS_2: stereo AUDIO_CHANNELS_5_1: 5.1 audio

**Table 7** CommonInfo
Parameter	Mandatory	Type	Description
pvc	Yes	Boolean	Low-bitrate HD transcoding switch.
video_codec	Yes	String	Video encoding format.
audio_codec	No	String	Audio encoding format. AAC: AAC (default) HEAAC1: HEAAC1 HEAAC2: HEAAC2 MP3: MP3
is_black_cut	No	Boolean	Black bar cropping type. The default value is false, indicating that black bar cropping is disabled.
format	Yes	String	Format.
hls_interval	Yes	Integer	Segment file duration. The value ranges from 2 to 10 (in seconds) and defaults to 5.
upsample	No	Boolean	Upsampling.
adaptation	No	String	SHORT: Adaptive width LONG: Adaptive height NONE: Adaptive width and height

Response Parameters

Status code: 400

**Table 8** Response body parameters
Parameter	Type	Description
error_code	String	Error code
error_msg	String	Error description

Example Requests

Modifies a transcoding template.

PUT https://{endpoint}/v2/{project_id}/asset/template/transcodings

{
  "group_id" : "f9b045e0811c482f9de0d436a5927bb6",
  "name" : "trans_template_test",
  "is_default" : true,
  "quality_info_list" : [ {
    "video" : {
      "width" : 1280,
      "height" : 720,
      "bitrate" : 1000,
      "quality" : "HD",
      "frame_rate" : 0
    },
    "audio" : {
      "sample_rate" : "AUDIO_SAMPLE_AUTO",
      "channels" : "AUDIO_CHANNELS_1",
      "bitrate" : 0
    }
  } ],
  "watermark_template_ids" : [ ],
  "common" : {
    "pvc" : false,
    "video_codec" : "H264",
    "audio_codec" : "AAC",
    "format" : "HLS",
    "hls_interval" : 5
  }
}

Example Responses

Status code: 400

The information is returned when the request failed.

{
  "error_code" : "VOD.10053",
  "error_msg" : "The request parameter is illegal, illegal field: {xx}."
}

Status Codes

Status Code	Description
200	The information is returned when the request succeeded.
400	The information is returned when the request failed.

Error Codes

See Error Codes.

Parent topic: Transcoding template management

Previous topic: Queries transcoding templates

Next topic: Deletes a custom template

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel

For any further questions, feel free to contact us through the chatbot.

Chatbot