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
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.
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"
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"
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.