CreateAigcAudioTask

Last updated: 2026-09-14 12:14:45Download PDF

1. API Description

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

This API is used to create AI audio generation tasks.

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: CreateAigcAudioTask.
Version	Yes	String	Common Params. The value used for this API: 2019-06-12.
Region	No	String	Common Params. This parameter is not required.
ModelName	No	String	Model name. Supported models for music generation: GL, MiniMaxMusic, EL, and Mureka.
ModelVersion	No	String	Specifies the model version. By default, the system uses the supported stable version of the model. Supported versions for GL: 3.0-clip and 3.0-pro. Supported versions for MiniMaxMusic: 2.0, 2.5, 2.6, and 3.0. Supported versions for EL: compose_v2 and sound_t2s_v2. Supported versions for Mureka: song_8, song_9, song_9.5, instrumental_8, instrumental_9, and instrumental_9.5.
SceneType	No	String
Prompt	No	String	Description of the generated music. (Note: supports up to 2,000 characters).
VideoInfos.N	No	Array of AigcAudioReferenceVideoInfo	Reference video information. Only partially supported by some models. Kling generates sound effects for videos. EL adds background music to videos.
AudioInfos.N	No	Array of AigcAudioReferenceAudioInfo	Specify the reference audio information. Use of the cover feature in MiniMaxMusic. For example, this is required for music generation.
StoreCosParam	No	AigcStoreCosParam
ExtraParameters	No	AigcAudioExtraParam
AdditionalParameters	No	String	Used to pass in some special scene parameters required by the model, serialized into strings in Json format. Example MinimaxMusic model When lyrics are passed in: {"lyric":{"ponies are running happily, flowers are blooming"}} MiniMaxMusic raw pure music parameters use example:" AdditionalParameters":" {"is_instrumental":true}". Supported transparent transmission parameters are: lyrics, is_instrumental, aigc_watermark, sample_rate, bitrate. EL Health Music supports transparent transmission parameters: PromptInfluence, WithTimestamps, CompositionPlan, ForceInstrumental and other parameters.
Operator	No	String

3. Output Parameters

Parameter Name	Type	Description
TaskId	String
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 Request Example

Input Example

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

{
    "ModelName": "Tme",
    "ModelVersion": "1.0",
    "SceneType": "music",
    "Prompt": "Generate a piece of music.",
    "VideoInfos": [
        {
            "VideoUrl": "https://l***-******-tts-131140***2.c***ap-*ua****ou.myqcloud.com/251006278_1513228070381297256.mp4"
        }
    ],
    "AudioInfos": [
        {
            "AudioUrl": "https://li**-q*******ts-1311402212*cos*ap-guangzh****yqcloud.com/25*******_1513228070381297256.wav"
        }
    ],
    "ExtraParameters": {
        "ResourceId": "438910555_1"
    },
    "AdditionalParameters": "{\"sequential_image_generation\":\"auto\"}",
    "Operator": "admin"
}

Output Example

{
    "Response": {
        "TaskId": "24*******AigcAudio-6a38**3a9f51468da5bfc25****9a462",
        "RequestId": "fcc72969-6464-45ba-8369-232f7a1e1c76"
    }
}

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

Tencent Cloud CLI 3.0

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
InvalidParameter.ViolationContent