MiniMax Voice Clone · API reference
Clone a voice from an authorized audio sample, preview it, and use the returned reference in speech synthesis.
Submit JSON to POST /v1/wand/minimax-tts/sync_clone with an APIMaster API key in the Authorization: Bearer header. Use a sample you have permission to clone.
| Field | Type | Description |
|---|---|---|
model |
string | Required. Use minimax-voice-clone. |
audio_url, audio_data |
string | Supply at least one. Use a public MP3, M4A, or WAV URL or a Base64-encoded sample. The suggested sample length is 10 seconds to 5 minutes, with a maximum size of 20 MB. |
voice_id |
string | Optional custom ID, 8–256 characters. Start with a letter. Use letters, digits, hyphens, or underscores, and finish with a letter or digit. When omitted, an ID is generated. |
text |
string | Optional preview text up to 1,000 characters. Set tts_model when requesting a preview. |
tts_model |
string | Preview model such as minimax-speech-2.8-hd. |
text_validation |
string | Expected transcript, up to 200 characters. Insufficient transcript similarity causes rejection. |
accuracy |
number | Transcript similarity threshold between 0 and 1. Defaults to 0.7. |
output_format |
string | hex (default) or url. Preview URLs last 24 hours. |
curl -X POST "https://apimaster.ai/v1/wand/minimax-tts/sync_clone" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"minimax-voice-clone","audio_url":"https://example.com/voice.wav"}'
The API accepts audio URL or data input. The file_id field is unsupported. Check for base_resp.status_code=0. The response includes voice_id, input_sensitive, and usage. demo_audio and preview details in extra_info appear when a preview was requested. Usage may be reported in usage.total_token or usage.total_tokens.
Pass the returned voice_id unchanged as voice_setting.voice_id in MiniMax Speech using the same account. Preview text is billed as synthesis. The voice fee is settled when the new voice is first used for a full synthesis. An unused temporary voice expires after seven days. See the Voice Clone model card for the current APIMaster price.
