curl --request POST \
  --url https://api.modellix.ai/api/v1/minimax/speech-2.8-hd \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "text": "Hello, this is MiniMax speech synthesis.",
  "voice_id": "English_expressive_narrator"
}
'

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-speech-28-hd-001",
    "model_id": "minimax/speech-2.8-hd",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-speech-28-hd-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"
}

MiniMax Speech 2.8 HD

[Core Function] MiniMax Speech 2.8 HD is a high-quality text-to-speech model that converts text into natural spoken audio, including expressive paralinguistic cues such as (laughs) and (sighs). [Strengths] Strong narration quality, stable prosody controls (speed, volume, pitch, emotion), optional timbre mixing, pronunciation overrides, subtitles, and flexible audio formats. [Best For] Highly recommended for: brand voiceovers, audiobook or long-form narration, marketing clips, multilingual delivery with language_boost, and expressive character speech. [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. Audio URLs expire in about 24 hours. [Routing] Choose speech-2.8-hd when quality or expressive delivery matters most. Choose speech-2.8-turbo when the user prioritizes lower latency or cost.

POST

minimax

speech-2.8-hd

curl --request POST \
  --url https://api.modellix.ai/api/v1/minimax/speech-2.8-hd \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "text": "Hello, this is MiniMax speech synthesis.",
  "voice_id": "English_expressive_narrator"
}
'

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-speech-28-hd-001",
    "model_id": "minimax/speech-2.8-hd",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-speech-28-hd-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

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

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

string

required

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

Required string length: 1 - 9999

Example:

"Hello, this is MiniMax speech synthesis."

voice_id

string

required

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.

Required string length: 1 - 256

Example:

"English_expressive_narrator"

timbre_weights

object[]

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.

Required array length: 1 - 4 elements

Show child attributes

speed

number

default:1

Speech rate multiplier. Higher is faster.

Required range: 0.5 <= x <= 2

Example:

1

vol

number

default:1

Speech volume. Range (0, 10].

Required range: x <= 10

Example:

1

pitch

integer

default:0

Pitch adjustment in semitones. Distinct from modify_pitch (voice effect slider).

Required range: -12 <= x <= 12

Example:

0

emotion

enum<string>

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.

Available options:

happy,

sad,

angry,

fearful,

disgusted,

surprised,

calm,

fluent

Example:

"calm"

text_normalization

boolean

default:false

Enable Chinese/English text normalization for better number reading; may add slight latency.

Example:

false

latex_read

boolean

default:false

Enable LaTeX formula reading (Chinese). When enabled, language_boost may be forced to Chinese. Wrap formulas with $$.

Example:

false

sample_rate

enum<integer>

default:32000

Output sample rate in Hz.

Available options:

8000,

16000,

22050,

24000,

32000,

44100

Example:

32000

bitrate

enum<integer>

default:128000

Audio bitrate. Applies to mp3 only.

Available options:

32000,

64000,

128000,

256000

Example:

128000

format

enum<string>

default:mp3

Output audio format. pcmu_raw and pcmu_wav are G.711 mu-law (8 kHz).

Available options:

mp3,

pcm,

flac,

wav,

pcmu_raw,

pcmu_wav,

opus

Example:

"mp3"

channel

enum<integer>

default:1

Number of channels. 1 is mono, 2 is stereo.

Available options:

1,

2

Example:

1

force_cbr

boolean

default:false

Force constant bitrate encoding. Optional; typically unused for standard async synthesis.

Example:

false

pronunciation_tone

string[]

Custom pronunciation rules in original/replacement form, for example omg/oh my god or Chinese pinyin with tone numbers.

Example:

["omg/oh my god"]

language_boost

enum<string>

Boost recognition for a language or dialect. Use auto when the language is unknown.

Available options:

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

Example:

"English"

modify_pitch

integer

Voice effect: deepen (negative) to brighten (positive). Distinct from pitch (semitone).

Required range: -100 <= x <= 100

Example:

0

modify_intensity

integer

Voice effect: stronger (negative) to softer (positive).

Required range: -100 <= x <= 100

Example:

0

modify_timbre

integer

Voice effect: fuller (negative) to crisper (positive).

Required range: -100 <= x <= 100

Example:

0

sound_effects

enum<string>

Optional single sound effect applied to the output.

Available options:

spacious_echo,

auditorium_echo,

lofi_telephone,

robotic

Example:

"spacious_echo"

subtitle_enable

boolean

default:false

Whether to generate a subtitle file download link.

Example:

false

subtitle_type

enum<string>

default:sentence

Subtitle granularity. word_streaming is not supported.

Available options:

sentence,

word

Example:

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

code

integer

required

Response code, 0 indicates success

Example:

0

message

string

required

Response message

Example:

"success"

data

object

required

Task submission details. Poll GET /api/v1/tasks/{task_id} until status is success; audio appears in result.resources.

Show child attributes

Minimax voice clone Speech 2 8 turbo

Model API

Common API

File API

MiniMax Speech 2.8 HD

Authorizations

Body

Response