tencent cloud

APIs

문서APIsVideo on DemandParameter Template APIsModifyAdaptiveDynamicStreamingTemplate

ModifyAdaptiveDynamicStreamingTemplate

Download
포커스 모드
폰트 크기
마지막 업데이트 시간: 2026-05-19 15:00:45

1. API Description

Domain name for API request: vod.intl.tencentcloudapi.com.

This API is used to modify an adaptive bitrate streaming template.

A maximum of 20 requests can be initiated per second for this API.

We recommend you to use API Explorer
Try it
API Explorer provides a range of capabilities, including online call, signature authentication, SDK code generation, and API quick search. It enables you to view the request, response, and auto-generated examples.

2. Input Parameters

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 Unique identifier of the adaptive transcoding template.
SubAppId No Integer On-demand application ID. Customers who activate on-demand services from December 25, 2023 must fill this field with the app ID when accessing resources in on-demand applications (whether default or newly created).
Name No String Template name. The length cannot exceed 64 characters.
Format No String Adaptive Transcoding Format, with a value range of
  • HLS;
  • MPEG-DASH.
  • DisableHigherVideoBitrate No Integer Whether to prohibit video low bitrate to high bitrate conversion, value ranges from...to...
  • 0: no,
  • 1: Yes.
  • DisableHigherVideoResolution No Integer Whether to prohibit video resolution to high resolution conversion. Value ranges from...to...
  • 0: no,
  • 1: Yes.
  • StreamInfos.N No Array of AdaptiveStreamTemplate Adaptive Transcoding Input Stream Parameter Information, up to 10 entries.
    Note: The frame rate of each stream must remain consistent. If inconsistent, use the frame rate of the first stream as the output frame rate.
    Comment No String Template description, with a length limit of 256 characters.
    SegmentType No String Segment type, valid when Format is HLS. Value range:
  • ts: ts slicing;
  • fmp4: fmp4 segment.
  • 3. Output Parameters

    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.

    4. Example

    Example1 Modifying an Adaptive Bitrate Streaming Template

    Input Example

    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"
    }
    

    Output Example

    {
        "Response": {
            "RequestId": "12ae8d8e-dce3-4151-9d4b-5594145287e1"
        }
    }
    

    5. Developer Resources

    SDK

    TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.

    Command Line Interface

    6. Error Code

    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 codec.
    InvalidParameterValue.Comment Invalid parameter: template description.
    InvalidParameterValue.Definition Invalid parameter: Definition.
    InvalidParameterValue.DisableHigherVideoBitrate Invalid value of the switch for prohibiting transcoding from low bitrate to high bitrate.
    InvalidParameterValue.DisableHigherVideoResolution Invalid value of the switch for prohibiting transcoding from low resolution to high resolution.
    InvalidParameterValue.DrmType Invalid DRM type.
    InvalidParameterValue.FillType Invalid parameter: incorrect fill type.
    InvalidParameterValue.Format Incorrect parameter value: Format.
    InvalidParameterValue.Fps Invalid parameter: video frame rate.
    InvalidParameterValue.Height Invalid parameter: height.
    InvalidParameterValue.Name Incorrect parameter value: Name exceeds the length limit.
    InvalidParameterValue.RemoveAudio Incorrect parameter value: RemoveAudio.
    InvalidParameterValue.SampleRate Invalid audio sample rate.
    InvalidParameterValue.SoundSystem Incorrect parameter: audio channel system.
    InvalidParameterValue.Width Invalid parameter: width.
    ResourceNotFound.TemplateNotExist The resource does not exist: the template does not exist.

    도움말 및 지원

    문제 해결에 도움이 되었나요?

    피드백