| text |
Text to synthesize with the temporarily cloned voice. Required. Fewer than 10,000 Unicode characters. On speech-2.8-hd / speech-2.8-turbo, may include paralinguistic tags such as (laughs), (breath), or (sighs). |
string |
是 |
- |
| audio_url |
Primary reference audio URL for cloning. Must be publicly accessible without auth. Formats: mp3, m4a, wav. Duration 10 seconds–5 minutes. File size ≤20 MB. Distinct from prompt_audio. |
string |
是 |
- |
| model |
Supported MiniMax speech model for both voice clone and TTS in this request. |
string |
是 |
speech-2.8-hd, speech-2.8-turbo |
| prompt_text |
Optional transcript matching prompt_audio. Must align with the example audio content; end with punctuation. Not a substitute for text. |
string |
否 |
- |
| pronunciation_tone |
Custom pronunciation rules. Use / as separator. For Mandarin entries, tones are digits 1-5 (5=neutral), e.g. name/(yan4)(shao3)(fei1). Example: [“omg/oh my god”]. |
string[] |
否 |
- |
| aigc_watermark |
Whether to append an AIGC watermark to the returned audio. Default false. |
boolean |
否 |
true, false |
| bitrate |
Audio bitrate. Default 128000. Only effective when format is mp3; ignored for other formats. |
integer |
否 |
32000, 64000, 128000, 256000 |
| channel |
Output channel count. 1 is mono, 2 is stereo. Default 1. |
integer |
否 |
1, 2 |
| emotion |
Optional emotion control. Leave unset to let the model infer from text. |
string |
否 |
happy, sad, angry, fearful, disgusted, surprised, calm |
| force_cbr |
Force constant bitrate encoding. Optional; typically unused for standard async synthesis. Default false. |
boolean |
否 |
true, false |
| format |
Output audio encoding format. Default mp3. Result audio is returned as a URL on the completed task. |
string |
否 |
mp3, pcm, flac, wav |
| language_boost |
Optional language or dialect boost for both cloning and synthesis. Omit for default behavior. Use auto to let the model decide. |
string |
否 |
Chinese, Chinese,Yue, English, Arabic, Russian, Spanish, French, Portuguese, German, Turkish, Dutch, Ukrainian, Vietnamese, Indonesian, Japanese, Italian, Korean, Thai, Polish, Romanian, Greek, Czech, Finnish, Hindi, Bulgarian, Danish, Hebrew, Malay, Persian, Slovak, Swedish, Croatian, Filipino, Hungarian, Norwegian, Slovenian, Catalan, Nynorsk, Tamil, Afrikaans, auto |
| latex_read |
Enable reading LaTeX formulas aloud (Chinese only). When true, language_boost may be forced to Chinese. Wrap formulas with $$ and escape backslashes. Default false. |
boolean |
否 |
true, false |
| modify_intensity |
Voice effect intensity: lower is stronger, higher is softer. Range [-100, 100]. |
integer |
否 |
- |
| modify_pitch |
Voice effect pitch: lower is deeper, higher is brighter. Range [-100, 100]. Distinct from pitch (semitone). |
integer |
否 |
- |
| modify_timbre |
Voice effect timbre: lower is thicker, higher is brighter or crisper. Range [-100, 100]. |
integer |
否 |
- |
| need_noise_reduction |
Whether to enable noise reduction on the clone reference audio. Default false. |
boolean |
否 |
true, false |
| need_volume_normalization |
Whether to enable volume normalization for cloning. Default false. |
boolean |
否 |
true, false |
| pitch |
Pitch adjustment in semitones. Default 0. Range [-12, 12]. Distinct from modify_pitch (voice effect). |
integer |
否 |
- |
| prompt_audio |
Optional short example audio URL to improve clone similarity and stability. Not a substitute for audio_url. Formats: mp3, m4a, wav. Duration must be under 8 seconds. File size ≤20 MB. |
string |
否 |
- |
| sample_rate |
Output sample rate in Hz. Default 32000. |
integer |
否 |
8000, 16000, 22050, 24000, 32000, 44100 |
| sound_effects |
Optional sound effect applied to the output. Supported for mp3, wav, and flac. |
string |
否 |
spacious_echo, auditorium_echo, lofi_telephone, robotic |
| speed |
Speech rate multiplier for synthesis. Default 1.0. Range [0.5, 2.0]. |
number |
否 |
- |
| subtitle_enable |
Whether to generate a subtitle download link. Default false. |
boolean |
否 |
true, false |
| text_normalization |
Enable Chinese/English text normalization for better number reading; may add slight latency. Default false. |
boolean |
否 |
true, false |
| vol |
Speech volume for synthesis. Default 1.0. Range (0.0, 10.0]. |
number |
否 |
- |