tencent cloud

APIs

DocumentaçãoAPIsVideo on DemandOther APIsCreateMPSTemplate

CreateMPSTemplate

Download
Modo Foco
Tamanho da Fonte
Última atualização: 2026-05-19 15:01:36

1. API Description

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

This API is used to create a custom template for partial features of the ProcessMediaByMPS API.
When creating a template, you need to fill in MPS-related parameters in JSON format into the MPSCreateTemplateParams parameter. For specific task parameter configuration methods, refer to the MPS task template related documentation.
Currently supported MPS features: create custom template.

  1. Audio and video enhancement.
  2. Media AI

Task Template created by this method
Template management is still done on the VOD platform.

  1. The feature is currently in closed beta testing. If needed, you can contact us for support.

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: CreateMPSTemplate.
Version Yes String Common Params. The value used for this API: 2018-07-17.
Region No String Common Params. This parameter is not required.
SubAppId Yes Integer

Video-on-demand (VOD) application ID.
TemplateType Yes String

Type of the MPS template to create. Value:

  • AIAnalysis: Create an intelligent analysis template.
  • SmartSubtitle: Create an intelligent subtitle template.
  • SmartErase: Create an intelligent erasure template.
    		•
    MPSCreateTemplateParams No String

    MPS template creation parameters. This parameter is used for transparent transmission to the media processing service (MPS) to create user-defined MPS task templates from the VOD side.
    Currently only supports creating templates of the following task types through this method:

    1. AI analysis: only supports filling in the content of Name, Comment, ClassificationConfigure, TagConfigure, CoverConfigure, and FrameTagConfigure parameters in the "create content analysis template" API. Currently only supports configuring the above parameters in the template. Other parameters are not required. If other parameters are included, the system will automatically ignore them.
    2. Smart subtitling: only supports filling in the content of Name, Comment, TranslateSwitch, VideoSrcLanguage, SubtitleFormat, SubtitleType, AsrHotWordsConfigure, TranslateDstLanguage, and ProcessType parameters in the "create intelligent caption template" API. Currently only supports configuring the above parameters in the template. Other parameters are not required. If other parameters are included, the system will automatically ignore them.
    3. Intelligent erasure: only supports filling in the content of Name, Comment, EraseType, EraseSubtitleConfig, EraseWatermarkConfig, and ErasePrivacyConfig parameters in the "create intelligent erasure template" API. Currently only supports configuring the above parameters in the template. Other parameters are not required. If other parameters are included, the system will automatically ignore them.

    Currently, only the above parameters can be configured in the template. Other parameters are not required. If other parameters are included, the system will automatically ignore them. The above pass-through parameters are represented in JSON format.
    AIAnalysisTemplate No MPSAIAnalysisTemplate

    Intelligent analysis template parameter. Valid when MPSCreateTemplateParams is empty.
    SmartSubtitleTemplate No MPSSmartSubtitleTemplate

    Parameter of the intelligent subtitle template. Valid when MPSCreateTemplateParams is empty.
    SmartEraseTemplate No MPSSmartEraseTemplate

    Intelligent erasure template parameter. Valid when MPSCreateTemplateParams is empty.

    3. Output Parameters

    Parameter Name Type Description
    Definition Integer

    Unique identifier of the MPS task Template. This template is independent of those created directly in Media Processing Service (MPS).
    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 Creating an MPS Intelligent Analysis Template

    Input Example

    POST / HTTP/1.1
Host: vod.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateMPSTemplate
<Common request parameters>

{
    "SubAppId": 260085028,
    "TemplateType": "AIAnalysis",
    "AIAnalysisTemplate": {
"Name": "Intelligent Analysis"
"Comment": "Intelligent Analysis Template",
        "ClassificationConfigure": {
            "Switch": "ON"
        },
        "TagConfigure": {
            "Switch": "ON"
        },
        "CoverConfigure": {
            "Switch": "ON"
        },
        "FrameTagConfigure": {
            "Switch": "ON"
        },
        "SplitConfigure": {
            "Switch": "ON"
        },
        "HighlightConfigure": {
            "Switch": "ON"
        },
        "OpeningAndEndingConfigure": {
            "Switch": "ON"
        }
    }
}

    Output Example

    {
    "Response": {
        "Definition": 30186,
        "RequestId": "c6d3e3f5-1082-4053-89e0-4172b456c2e1"
    }
}

    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
    InternalError Internal error.
    InvalidParameterValue Parameter value error.
    LimitExceeded.TooMuchTemplate Limit exceeded: The number of templates exceeds the upper limit of 100. If you need more, pleaseSubmit a ticket.
    Anterior: DeleteMPSTemplatePróximo: ProcessMediaByProcedure

    Ajuda e Suporte

    Esta página foi útil?

    comentários