tencent cloud

APIs

DocumentationAPIsVideo on DemandAI Generation APIsCloneVoiceSync

CloneVoiceSync

Download
Focus Mode
Font Size
Last updated: 2026-09-18 16:51:15

1. API Description

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

This API is used to initiate a voice cloning task. It clones an exclusive voice based on reference audio. The generated voice can be used for subsequent text to speech.

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: CloneVoiceSync.
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 No String

VOD application ID. For customers who activate on-demand services after December 25, 2023, this field must be set to the app ID when accessing resources in on-demand applications, whether in the default application or a newly created application.
AudioData No String

Base64-encoded audio for cloning.
AudioUrl No String

Cloning audio URL. Valid when AudioData is empty.
AudioFileId No String

Clone file FileID. Valid when AudioData and AudioUrl are empty
LanguageBoost No String

Language enhancement, such as "zh" "en" "auto", default "auto"
ExtParam No String

Extended parameters for synchronous timbre clone. Supported fields of ExtParam:

  • text (string): Text for audition synthesis, up to 1000 characters. If not empty, tts_model must be passed simultaneously. Upon successful clone, the audition audio DemoAudio is returned.
  • model (string): Clone model. Default: minimax-voice-clone.
  • tts_model (string): Model used to synthesize the audition audio. Options: minimax-speech-2.8-hd, minimax-speech-2.8-turbo, minimax-speech-2.6-hd, minimax-speech-2.6-turbo, minimax-speech-02-hd, minimax-speech-02-turbo. Required if text is not empty.
  • text_lang (string): Language of the audition text.
  • voice_profile (object): Timbre profile. Optional fields:
    • name (string): Timbre name.
    • description (string): Timbre description.
    • gender (string): Gender. Options: male / female / unknown.
    • age (string): Age segment. Options: child / teenager / youth / middle_aged / senior / unknown.
    • languages (string[]): Supported languages, for example ["zh", "en"].
    • labels (string[]): Timbre tags, for example ["magnetic"].
    • scenes (string[]): Application scenarios, for example ["commentary"].

3. Output Parameters

Parameter Name Type Description
VoiceId String

Cloned timbre
DemoAudio String

Audition audio.
ExtInfo String

Extended information.
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 Synchronize Timbre Clone

Synchronize timbre clone

Input Example

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

{
    "AudioFileId": "966263******778501",
    "LanguageBoost": "zh",
    "ExtParam": "{\"text\": \"The seed stays silent in the soil, preparing for the thunder when it breaks through the ground.\", \"tts_model\":\"minimax-speech-2.8-hd\"}",
    "SubAppId": "221***",
    "AudioUrl": "https://laurie-tmp-1300828900.cos.accelerate*******************************************Async-773ca8f1756ed5fd016988dccb91eaa9t.wav"
}

Output Example

{
    "Response": {
        "DemoAudio": "https://laurie-tmp-1300828900.cos.acce**************************************c3-41db-aa7a-29931e416b5b-preview.mp3",
        "ExtInfo": "{\"audio_length\":0,\"word_count\":34}",
        "VoiceId": "minimax_9*********d39-40d7",
        "RequestId": "60f2d5dc-2dc3-41db-aa7a-29931e416b5b"
    }
}

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

There is no error code related to the API business logic. For other error codes, please see Common Error Codes.

Previous Topic: CloneVoiceAsyncNext Topic: ProcessMediaByProcedure

Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback

Search
    Enter keywords to search documentation