POST
/
v3
/
minimax-voice-cloning
MiniMax Quick Voice Cloning
curl --request POST \
  --url https://api.novita.ai/v3/minimax-voice-cloning \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '{
  "audio_url": "<string>",
  "text_validation": "<string>",
  "text": "<string>",
  "model": "<string>",
  "accuracy": 123,
  "need_noise_reduction": true,
  "need_volume_normalization": true
}'
{
  "demo_audio_url": "<string>",
  "voice_id": "<string>"
}

This interface will allow users to efficiently clone a voice, as specified in the audio file. Potential use cases include: IP voice cloning, voice cloning, and other scenarios where quick voice cloning is required. The quick voice clone generated by this API is temporary. If you wish to permanently retain a cloned voice, you must use this voice in any T2A speech synthesis API within 168 hours (7 days) (excluding preview actions within this API). Otherwise, the cloned voice will be deleted.

Applicable scenarios for this API include: IP voice cloning, timbre cloning, and other use cases requiring rapid voice cloning.

Notes:

  • The uploaded audio file must be in mp3, m4a, or wav format.
  • The duration of the uploaded audio must be at least 10 seconds and no more than 5 minutes.
  • The uploaded audio file size must not exceed 20 MB.

​
Request Headers

​
Content-Type
string
required

Enum: application/json

​
Authorization
string
required

Bearer authentication format, for example: Bearer {{API Key}}.

​
Request Body

​
audio_url
string
required

The URL of the audio file to be cloned. Supported formats: mp3, m4a, wav.

​
clone_prompt

Voice cloning parameters. Providing this parameter can help improve the similarity and stability of the synthesized voice.

If this parameter is used, you must also upload a short sample audio (duration less than 8 seconds) and the corresponding transcript. Supported audio formats: mp3, m4a, wav.

​
text_validation
string

Voice cloning parameter. Maximum 200 characters. If this field is provided, the service will compare the audio and the text; if the difference is too large, error code 1043 will be returned.

​
text
string

Voice cloning preview parameter. The model will use the cloned voice to synthesize this text and return the result as an audio URL for preview. Maximum 2000 characters. Note: Preview will be charged according to the number of characters, at the same rate as T2A APIs.

​
model
string

Voice cloning preview parameter. Specifies the speech model to use for preview. Required if the “text” field is provided.
Options: speech-02-hd, speech-02-turbo

​
accuracy
float

Voice cloning parameter. Value range: [0, 1]. If provided, sets the text validation accuracy threshold. Default is 0.7 if not specified.

​
need_noise_reduction
bool

Voice cloning parameter. Whether to enable noise reduction. Defaults to false if not specified.

​
need_volume_normalization
bool

Voice cloning parameter. Whether to enable volume normalization. Defaults to false if not specified.

​
Response

​
demo_audio_url
string

If both the preview text (text) and preview model (model) are provided in the request body, this parameter returns the preview audio as a URL.

​
voice_id
string

The generated voice_id.

​
Example

Below is an example of how to use the Minimax Voice Cloning API to clone a voice.

Request:

curl \
-X POST https://api.novita.ai/v3/minimax-voice-cloning \
-H "Authorization: Bearer $your_api_key" \
-H "Content-Type: application/json" \
-d '{
  "audio_url": "https://example.com/voice.mp3",
  "text": "Audio generation technology is evolving rapidly, enabling the creation of speech, music, and sound effects from text or data inputs. It supports applications in media, accessibility, customer service, and content creation. With improved quality and customization, these tools are increasingly integrated into digital platforms across various industries.",
  "model": "speech-01-hd",
  "need_noise_reduction": true,
  "need_volume_normalization": true
}'

Response:

{
  "demo_audio_url": "https://demo.com/audio.mp3", // Audio sample
  "voice_id": "xxxxxxx" // Generated voice_id
}