Voice cloning

Create a cloned voice from an uploaded audio sample and optionally generate preview audio.

Use the file_id returned by the upload endpoint to create a custom voice. If you provide preview text and a model, the API also returns preview audio.

POST/v1/minimax/voice_clone

Create a custom voice with the file_id returned by the upload API. When you provide text, you must also provide model, and the API generates preview audio with the cloned voice.

Cloning the voice incurs the fixed cloning charge. When preview audio is also generated, its synthesis charge is calculated from extra_info.usage_characters.

Authorization

bearerAuth

AuthorizationBearer <token>

Use Bearer your-api-key in the Authorization header.

In: header

Request Body

application/json

MiniMax voice-cloning request.

TypeScript Definitions

Use the request body type in TypeScript.

file_id*integer

File ID of the audio sample to clone, returned by the upload API.

Formatint64

voice_id*string

Custom voice identifier. It must begin with a letter, may contain only letters, digits, hyphens, and underscores, and must not end with a hyphen or underscore.

Match^[A-Za-z][A-Za-z0-9_-]{6,254}[A-Za-z0-9]$

Length8 <= length <= 256

clone_prompt?

text?string

Optional preview text. When provided, the cloned voice is used to generate preview audio.

Lengthlength <= 1000

model?string

Model ID used to synthesize the preview. Required when text is provided. Use a model visible to the current account, such as speech-2.8-hd, speech-2.8-turbo, speech-2.6-hd, or speech-02-hd.

Length1 <= length

language_boost?string|null

Language recognition enhancement, such as auto, Chinese, or English.

Defaultnull

need_noise_reduction?boolean

Whether to enable audio noise reduction.

Defaultfalse

need_volume_normalization?boolean

Whether to enable volume normalization.

Defaultfalse

aigc_watermark?boolean

Whether to add an AIGC authenticity watermark at the end of the synthesized audio.

Defaultfalse

parameters?

Additional parameters passed through to MiniMax.

metadata?

Metadata parameters passed through to MiniMax.

Response Body

`application/json`

curl -X POST "https://example.com/v1/minimax/voice_clone" \  -H "Content-Type: application/json" \  -d '{    "file_id": 2305843009214732,    "voice_id": "MyUniqueVoice001"  }'

{
  "input_sensitive": {
    "type": 0
  },
  "demo_audio": "https://example.com/trial-audio.mp3",
  "extra_info": {
    "audio_length": 4200,
    "audio_sample_rate": 32000,
    "audio_size": 67200,
    "bitrate": 128000,
    "word_count": 24,
    "usage_characters": 24
  },
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`