Help Center/ Video On Demand/ API Reference/ Transcoding template management/ Queries transcoding templates

Updated on 2024-12-04 GMT+08:00

Online Debugging

CLI Examples

View PDF

Queries transcoding templates

Function

URI

GET /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.

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
group_id	No	String	Template ID
is_default	No	Boolean	Whether a default template is used
offset	No	Integer	Offset. The default value is 0. This parameter is invalid when group_id is specified.
limit	No	Integer	Number of records on each page. The value defaults to 10 and ranges from 1 to 100. This parameter is invalid when group_id is specified.
query_string	No	String	Fuzzy search by template name and description. This parameter is invalid when group_id is specified.

Request Parameters

**Table 3** 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.

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
template_group_list	Array of TransTemplateRsp objects	Template group information.
total	Integer	Total number of records.

**Table 5** TransTemplateRsp
Parameter	Type	Description
group_id	String	Template group ID.
name	String	Template group name.
is_default	Boolean	Whether to use the default transcoding template.
type	String	Template group type.
is_auto_encrypt	Boolean	Whether to encrypt the output audio/video. The default value is false (not encrypted). Only HLS audio/video streams can be encrypted before being output. Original audio/video streams are not encrypted. This field is unavailable for non-HLS transcoded audio/video. Before enabling this function, obtain the key URL by referring to section "HLS Encryption Settings" in VOD User Guide.
quality_info_list	Array of QualityInfoList objects	Image quality configuration list.
watermark_template_ids	Array of strings	ID array of the bound watermark template group.
description	String	Template description.
common	CommonInfo object	Low-bitrate HD transcoding switch, low-bitrate HD transcoding version, and multi-stream common parameters.

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

**Table 7** VideoInfo
Parameter	Type	Description
quality	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	Integer	Video width.
height	Integer	Video height.
bitrate	Integer	Bitrate, in kbit/s.
frame_rate	Integer	Frame rate, expressed in frames per second (FPS). The value is 0 or an integer ranging from 5 to 60. The default value is 0 (adaptive).

**Table 8** AudioInfo
Parameter	Type	Description
sample_rate	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	Integer	Audio bitrate, in kbit/s.
channels	String	Number of audio channels. Possible options: AUDIO_CHANNELS_1: mono AUDIO_CHANNELS_2: stereo AUDIO_CHANNELS_5_1: 5.1 audio

**Table 9** CommonInfo
Parameter	Type	Description
pvc	Boolean	Low-bitrate HD transcoding switch.
video_codec	String	Video encoding format H264 H265
audio_codec	String	Audio encoding format. AAC: AAC (default) HEAAC1: HEAAC1 HEAAC2: HEAAC2 MP3: MP3
is_black_cut	Boolean	Black bar cropping type. The default value is false, indicating that black bar cropping is disabled.
format	String	Transcoded file format MP4 HLS DASH DASH_HLS MP3 ADTS UNKNOW
hls_interval	Integer	Segment file duration. The value ranges from 2 to 10 (in seconds) and defaults to 5.
upsample	Boolean	Whether to enable upsampling. After this function is enabled, video resolution can be improved and the number of sampling points can be increased. The default value is false, indicating that upsampling is disabled.
adaptation	String	Resolution adaptation mode of the transcoded media file. Options: SHORT: adaptive short side The width and height of the transcoding template are specified. The long side of the source media file is scaled based on the ratio between the short side of the transcoding template and the short side of the source media file. LONG: adaptive long side The width and height of the transcoding template are specified. The short side of the source media file is scaled based on the ratio between the long side of the transcoding template and the long side of the source media file. NONE (default): adaptive to the specified aspect ratio The output resolution is based on the width and height set in the transcoding template. NOTE: This parameter cannot be set for the V1 API (discarded). The default value is SHORT. The default value is NONE for the V2 API. The default value of the V1 API is different from that of the V2 API. Pay attention to the value of this parameter when calling the API. The default value of the transcoding template created using the V2 API on the console is SHORT, which is the same as that of the transcoding template created using the V1 API.
preset	Integer	Encoding quality level. Options: 0: default mode; 1: transcoding efficiency first; 2: transcoding quality first.
max_iframes_interval	Integer	Maximum I-frame interval. Value range: [2, 10]. The default value is 5, in second.
hls_audio_separate	Boolean	Whether to store the transcoded audio separately.
hls_segment_type	String	Packaging format of HLS segments. Currently, TS (default) and fMP4 are supported.

Status code: 403

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

Example Requests

Queries transcoding templates.

GET https://{endpoint}/v2/{project_id}/asset/template/transcodings?group_id={group_id}

Example Responses

Status code: 200

The information is returned when the request succeeded.

{
  "template_group_list" : [ {
    "group_id" : "9751249d25f14587b212544d6fd8dcf8",
    "name" : "non_transcoding_template_group",
    "is_default" : false,
    "type" : "non_transcoding_template_group",
    "is_auto_encrypt" : false,
    "quality_info_list" : [ {
      "video" : {
        "quality" : "UNKNOW",
        "width" : 0,
        "height" : 0,
        "bitrate" : 0,
        "frame_rate" : 0
      },
      "audio" : null
    } ],
    "watermark_template_ids" : null,
    "description" : null,
    "common" : {
      "pvc" : false,
      "is_black_cut" : false,
      "format" : "UNKNOW",
      "upsample" : false,
      "adaptation" : "NONE",
      "video_codec" : null,
      "audio_codec" : "AAC",
      "hls_interval" : 0
    }
  } ],
  "total" : 0
}

Status code: 403

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.
403	The information is returned when the request failed.

Error Codes

See Error Codes.

Parent topic: Transcoding template management

Previous topic: Customizes a transcoding template

Next topic: Modifies a transcoding 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