curl --request POST \
--url https://api.modellix.ai/api/v1/minimax/speech-2.8-turbo \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"text": "Hello, this is MiniMax speech synthesis.",
"voice_id": "English_radiant_girl"
}
'{
"code": 0,
"message": "success",
"data": {
"status": "pending",
"task_id": "task-speech-28-turbo-001",
"model_id": "minimax/speech-2.8-turbo",
"get_result": {
"method": "GET",
"url": "https://api.modellix.ai/api/v1/tasks/task-speech-28-turbo-001"
}
}
}{
"code": 400,
"message": "Invalid parameters: voice_id or timbre_weights is required"
}{
"code": 400,
"message": "Invalid parameters: voice_id or timbre_weights is required"
}{
"code": 400,
"message": "Invalid parameters: voice_id or timbre_weights is required"
}{
"code": 400,
"message": "Invalid parameters: voice_id or timbre_weights is required"
}Speech 2.8 Turbo
[Core Function] MiniMax Speech 2.8 Turbo is a lower-latency text-to-speech model with the same control surface as Speech 2.8 HD, including paralinguistic tags such as (laughs). [Strengths] Faster and more cost-efficient synthesis while retaining prosody, timbre mix, pronunciation, subtitle, and audio-format controls. [Best For] Highly recommended for: interactive assistants, high-volume TTS batches, cost-sensitive voiceovers, quick narration drafts, and latency-sensitive product prompts. [Limitations] Do NOT use this for streaming or real-time partial audio. Do NOT request hex output or emotion whisper. Do NOT send both voice_id and timbre_weights. Prefer speech-2.8-hd if maximum audio quality is required. Audio URLs expire in about 24 hours. [Routing] Choose speech-2.8-turbo when the user emphasizes speed, cost, or throughput. Choose speech-2.8-hd for premium quality or highly expressive delivery.
curl --request POST \
--url https://api.modellix.ai/api/v1/minimax/speech-2.8-turbo \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"text": "Hello, this is MiniMax speech synthesis.",
"voice_id": "English_radiant_girl"
}
'{
"code": 0,
"message": "success",
"data": {
"status": "pending",
"task_id": "task-speech-28-turbo-001",
"model_id": "minimax/speech-2.8-turbo",
"get_result": {
"method": "GET",
"url": "https://api.modellix.ai/api/v1/tasks/task-speech-28-turbo-001"
}
}
}{
"code": 400,
"message": "Invalid parameters: voice_id or timbre_weights is required"
}{
"code": 400,
"message": "Invalid parameters: voice_id or timbre_weights is required"
}{
"code": 400,
"message": "Invalid parameters: voice_id or timbre_weights is required"
}{
"code": 400,
"message": "Invalid parameters: voice_id or timbre_weights is required"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
- single_voice
- timbre_mix
text is always required. Exactly one of voice_id or timbre_weights is required (mutually exclusive). stream, stream_options, and output_format are not accepted.
Text to synthesize (fewer than 10000 characters). Supports pause markers such as <#0.5#>, inline pronunciation in parentheses, and paralinguistic tags such as (laughs) or (sighs).
1 - 9999"Hello, this is MiniMax speech synthesis."
Required when not using timbre_weights (exactly one of voice_id or timbre_weights). Accepts a system, cloned, or AI-generated voice ID. Mutually exclusive with timbre_weights. Full official system voice catalog: https://platform.minimax.io/docs/faq/system-voice-id . Sample system voices (not exhaustive): English_expressive_narrator, English_radiant_girl, English_magnetic_voiced_man, Chinese (Mandarin)_News_Anchor, Chinese (Mandarin)_Lyrical_Voice, Chinese (Mandarin)_Reliable_Executive.
1 - 256"English_expressive_narrator"
Required when not using voice_id (exactly one of voice_id or timbre_weights). Mix up to 4 voices by weight. Mutually exclusive with top-level voice_id.
1 - 4 elementsShow child attributes
Show child attributes
Speech rate multiplier. Higher is faster.
0.5 <= x <= 21
Speech volume. Range (0, 10].
x <= 101
Pitch adjustment in semitones. Distinct from modify_pitch (voice effect slider).
-12 <= x <= 120
Optional emotion control. Leave unset to let the model choose naturally. whisper is not supported on speech-2.8-hd or speech-2.8-turbo.
happy, sad, angry, fearful, disgusted, surprised, calm, fluent "calm"
Enable Chinese/English text normalization for better number reading; may add slight latency.
false
Enable LaTeX formula reading (Chinese). When enabled, language_boost may be forced to Chinese. Wrap formulas with $$.
false
Output sample rate in Hz.
8000, 16000, 22050, 24000, 32000, 44100 32000
Audio bitrate. Applies to mp3 only.
32000, 64000, 128000, 256000 128000
Output audio format. pcmu_raw and pcmu_wav are G.711 mu-law (8 kHz).
mp3, pcm, flac, wav, pcmu_raw, pcmu_wav, opus "mp3"
Number of channels. 1 is mono, 2 is stereo.
1, 2 1
Force constant bitrate encoding. Optional; typically unused for standard async synthesis.
false
Custom pronunciation rules in original/replacement form, for example omg/oh my god or Chinese pinyin with tone numbers.
["omg/oh my god"]
Boost recognition for a language or dialect. Use auto when the language is unknown.
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 "English"
Voice effect: deepen (negative) to brighten (positive). Distinct from pitch (semitone).
-100 <= x <= 1000
Voice effect: stronger (negative) to softer (positive).
-100 <= x <= 1000
Voice effect: fuller (negative) to crisper (positive).
-100 <= x <= 1000
Optional single sound effect applied to the output.
spacious_echo, auditorium_echo, lofi_telephone, robotic "spacious_echo"
Whether to generate a subtitle file download link.
false
Subtitle granularity. word_streaming is not supported.
sentence, word "sentence"
Response
Task submitted successfully. Poll GET /api/v1/tasks/{task_id} until the task completes; synthesized audio is returned on the task result.
Response object for asynchronous task submission.