Domain name for API request: vod.intl.tencentcloudapi.com.
Modifying an Adaptive Bitrate Streaming Template
A maximum of 20 requests can be initiated per second for this API.
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
| Parameter Name | Required | Type | Description |
|---|---|---|---|
| Action | Yes | String | Common Params. The value used for this API: ModifyAdaptiveDynamicStreamingTemplate. |
| Version | Yes | String | Common Params. The value used for this API: 2018-07-17. |
| Region | No | String | Common Params. This parameter is not required. |
| Definition | Yes | Integer | Adaptive Transcoding Template Unique Identifier. |
| SubAppId | No | Integer | Video-on-demand (VOD) application ID. For customers who activate VOD services on or after December 25, 2023, this field must be set to the application ID when accessing resources in VOD applications, whether it is the default application or a newly created application. |
| Name | No | String | Template name. Length limit: 64 characters. |
| Format | No | String | Adaptive Transcoding Format. Value range: |
| DisableHigherVideoBitrate | No | Integer | Whether to prohibit video low bitrate to high bitrate conversion. Value range: |
| DisableHigherVideoResolution | No | Integer | Whether to prohibit video resolution to high resolution conversion. Value range: |
| StreamInfos.N | No | Array of AdaptiveStreamTemplate | Adaptive Transcoding Input Stream Parameter Information, up to 10 streams. |
| Comment | No | String | Transcoding template description. Length limit: 256 characters. |
| SegmentType | No | String | Segment type. Available values: mp4: HLS/DASH, internally mapped to mp4-mp4-segment for HLS and mp4-mp4-byterange for DASH ts-segment: HLS+TS segment ts-byterange: HLS+TS byte range mp4-segment: HLS+MP4 segment mp4-byterange: HLS+MP4 byte range ts-packed-audio: HLS+TS+Packed Audio segment mp4-packed-audio: HLS+MP4+Packed Audio segment ts-ts-segment: HLS+TS+TS segment ts-ts-byterange: HLS+TS+TS byte range mp4-mp4-segment: HLS+MP4+MP4 segment mp4-mp4-byterange: HLS/DASH+MP4+MP4 byte range ts-packed-audio-byterange: HLS+TS+Packed Audio byte range mp4-packed-audio-byterange: HLS+MP4+Packed Audio byte range FairPlay: can only be used for HLS, and the segment format can only be mp4 or mp4-mp4-segment. Widevine: can be used for HLS and DASH. For HLS, the segment format can only be mp4 or mp4-mp4-segment. For DASH, the segment format can only be mp4 or mp4-mp4-byterange. Widevine+FairPlay: can only be used for HLS, and the segment format can only be mp4 or mp4-mp4-segment |
| SegmentDuration | No | Integer | Average segmentation duration. Value range: [1, 10] Unit: second |
| Parameter Name | Type | Description |
|---|---|---|
| RequestId | String | The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem. |
POST / HTTP/1.1
Host: vod.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ModifyAdaptiveDynamicStreamingTemplate
<Common request parameters>
{
"Definition": 10038,
"StreamInfos": [
{
"Audio": {
"SampleRate": 44100,
"Codec": "flac",
"Bitrate": 1000
},
"Video": {
"Codec": "libx264",
"Bitrate": 2000,
"Fps": 25
}
}
],
"Name": "Adaptive Bitrate Streaming Template 2",
"Format": "HLS"
}{
"Response": {
"RequestId": "12ae8d8e-dce3-4151-9d4b-5594145287e1"
}
}TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.
| Error Code | Description |
|---|---|
| FailedOperation | Operation failed. |
| InvalidParameter | Parameter error. |
| InvalidParameterValue | Parameter value error. |
| InvalidParameterValue.Bitrate | Invalid audio/video bitrate. |
| InvalidParameterValue.Codec | Invalid audio/video encoding format. |
| InvalidParameterValue.Comment | Parameter error: description of this template. |
| InvalidParameterValue.Definition | Parameter error: Definition. |
| InvalidParameterValue.DisableHigherVideoBitrate | Invalid forbidden bitrate low-to-high switch value. |
| InvalidParameterValue.DisableHigherVideoResolution | Invalid switch value for forbidding resolution upscaling. |
| InvalidParameterValue.DrmType | Invalid DRM type. |
| InvalidParameterValue.FillType | Parameter error: Incorrect filling method. |
| InvalidParameterValue.Format | Parameter value error: Format. |
| InvalidParameterValue.Fps | Parameter error: video frame rate. |
| InvalidParameterValue.Height | Parameter error: height. |
| InvalidParameterValue.Name | Parameter value error: Name exceeds the length limit. |
| InvalidParameterValue.RemoveAudio | Parameter value error: RemoveAudio. |
| InvalidParameterValue.SampleRate | Invalid audio sample rate. |
| InvalidParameterValue.SoundSystem | Parameter error: audio channel mode. |
| InvalidParameterValue.Width | Parameter error: width. |
| ResourceNotFound.TemplateNotExist | Resource does not exist: template not found. |
Was this page helpful?
You can also Contact sales or Submit a Ticket for help.
Help us improve! Rate your documentation experience in 5 mins.
Feedback