Skip to content

MiniMax Speech 2.8 HD

Integrate

Model id minimax/speech-2.8-hd
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/minimax/speech-2.8-hd?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Welcome aboard. Tonight we cruise along the northern coast, where the lighthouse has guided sailors home for two hundred years. Find a warm seat on the upper deck and enjoy the view."
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

This request: $0.019 19 API credits Run it on this page

Get API key
MiniMax Text to Speech #voiceover#multilingual#hd

MiniMax's high-definition text to speech in 30+ languages with pauses, emotion and pronunciation control.

Examples

Output · ~10 s

PromptWelcome aboard. Tonight we cruise along the northern coast, where the lighthouse has guided sailors home for two hundred years. Find a warm seat on the upper deck and enjoy the view.

$0.019 · 19 API credits

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

•required 182 / 10000

Text for speech synthesis, with pauses specified by `<#x#>` where x ranges from 0.01 to 99.99 seconds. Available interjection tags are `(laughs)`, `(sighs)`, `(coughs)`, `(clears throat)`, `(gasps)`, `(sniffs)`, `(groans)`, and `(yawns)`.

Advanced output_format · language_boost · voice_setting · audio_setting · pronunciation_dict · normalization_setting · voice_modify
output_format default hex

Output content format; applies only to non-streaming responses.

Improves recognition for the selected languages and dialects.

default {"english_normalizati...

Settings for configuring the voice.

Settings for configuring audio.

Custom dictionary of pronunciations used to replace text.

Settings that control audio loudness normalization.

Settings for modifying voice pitch, intensity, and timbre.

POST /run/minimax/speech-2.8-hd?wait=20 quote → $0.019
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/minimax/speech-2.8-hd?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Welcome aboard. Tonight we cruise along the northern coast, where the lighthouse has guided sailors home for two hundred years. Find a warm seat on the upper deck and enjoy the view."
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About MiniMax Speech 2.8 HD

MiniMax Speech 2.8 HD voices text in more than 30 languages with fine control: inline pause markers, voice speed, pitch and volume, custom pronunciation dictionaries and voice effects. Choose from the built-in voices and the output sample rate and format.

Parameters

NameType DefaultAllowed Description
promptrequired
Typestring
≤ 10,000 characters
Text for speech synthesis, with pauses specified by `<#x#>` where x ranges from 0.01 to 99.99 seconds. Available interjection tags are `(laughs)`, `(sighs)`, `(coughs)`, `(clears throat)`, `(gasps)`, `(sniffs)`, `(groans)`, and `(yawns)`.
voice_settingoptional
Typeobject
Default{"english_normalization":false,"pitch":0,"speed":1,"voice_id":"Wise_Woman","vol":1}
Settings for configuring the voice.
voice_setting.voice_idoptional
Typestring
DefaultWise_Woman
≥ 1 characters
Predefined voice identifier used for speech synthesis.
voice_setting.speedoptional
Typenumber
Default1
0.5 – 2
Speaking rate, ranging from 0.5 to 2.0.
voice_setting.voloptional
Typenumber
Default1
0.01 – 10
Output volume, ranging from 0 to 10.
voice_setting.pitchoptional
Typeinteger
Default0
-12 – 12
Pitch of the voice, ranging from -12 to 12.
voice_setting.emotionoptional
Typeenum
happysadangryfearfuldisgustedsurprisedneutral
Emotional tone of the synthesized speech.
voice_setting.english_normalizationoptional
Typeboolean
Defaultfalse
English text-normalization option that trades a small amount of additional latency for better reading of numbers.
audio_settingoptional
Typeobject
Settings for configuring audio.
audio_setting.sample_rateoptional
Typeenum
Default32000
80001600022050240003200044100
Sampling rate for the generated audio.
audio_setting.bitrateoptional
Typeenum
Default128000
3200064000128000256000
Bitrate for the generated audio.
audio_setting.formatoptional
Typeenum
Defaultmp3
mp3pcmflac
Format for the audio.
audio_setting.channeloptional
Typeenum
Default1
12
Audio channel count: 1 for mono or 2 for stereo.
language_boostoptional
Typeenum
ChineseChinese,YueEnglishArabicRussianSpanishFrenchPortugueseGermanTurkishDutchUkrainianVietnameseIndonesianJapaneseItalian
+22 moreKoreanThaiPolishRomanianGreekCzechFinnishHindiBulgarianDanishHebrewMalaySlovakSwedishCroatianHungarianNorwegianSlovenianCatalanNynorskAfrikaansauto
Improves recognition for the selected languages and dialects.
output_formatoptional
Typeenum
Defaulthex
urlhex
Output content format; applies only to non-streaming responses.
pronunciation_dictoptional
Typeobject
Custom dictionary of pronunciations used to replace text.
pronunciation_dict.tone_listoptional
Typestring[]
Pronunciation replacement list using the syntax ['text/(pronunciation)', ...], for example ['燕少飞/(yan4)(shao3)(fei1)']. Chinese tone numbers range from 1 to 5.
normalization_settingoptional
Typeobject
Settings that control audio loudness normalization.
normalization_setting.enabledoptional
Typeboolean
Defaulttrue
Enables normalization of audio loudness.
normalization_setting.target_loudnessoptional
Typenumber
Default-18
-70 – -10
Desired loudness, measured in LUFS; defaults to -18.0.
normalization_setting.target_rangeoptional
Typenumber
Default8
0 – 20
Desired loudness range, measured in LU; defaults to 8.0.
normalization_setting.target_peakoptional
Typenumber
Default-0.5
-3 – 0
Desired peak level, measured in dBTP; defaults to -0.5.
voice_modifyoptional
Typeobject
Settings for modifying voice pitch, intensity, and timbre.
voice_modify.pitchoptional
Typeinteger
Default0
-100 – 100
Pitch control measured in semitones: use a negative value to lower the voice or a positive value to raise it. Allowed values run from -100 to 100.
voice_modify.intensityoptional
Typeinteger
Default0
-100 – 100
Voice-energy control that makes speech more energetic as the setting increases. Its allowed range is -100 to 100.
voice_modify.timbreoptional
Typeinteger
Default0
-100 – 100
Voice timbre adjustment from -100 to 100, controlling its tonal character.
required

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "minimax/speech-2.8-hd",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 19,
    "usd": "0.019",
    "charged": 19,
    "refunded": 0
  },
  "input": {
    "prompt": "Hello! Welcome to our new studio. <#0.5#> Let's make something wonderful today."
  },
  "output": {
    "audio": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp3",
      "content_type": "audio/mpeg",
      "file_name": "0-output.mp3",
      "file_size": 1843200
    },
    "duration_ms": 1
  },
  "outputs": [
    {
      "type": "audio",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp3",
      "content_type": "audio/mpeg",
      "file_size": 1843200,
      "duration": 12,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
audio
object {url, content_type, file_name, file_size}Audio file produced by generation.
duration_ms
integerAudio length, measured in milliseconds.

More models: Text to Speech

For AI agents: this page as Markdown is at https://doitong.com/developers/models/minimax/speech-2.8-hd.md. All models and guides: https://doitong.com/developers/llms.txt