Skip to main content
POST
Create Speech Generation Task

Overview

Generate high-definition speech from text using the MiniMax Speech 2.8 HD model. Speech 2.8 HD delivers:
  • High-definition audio quality — superior clarity and naturalness
  • Pause tags — insert precise pauses with <#x#> syntax (x = 0.01-99.99 seconds)
  • Interjection tags — add natural expressions like (laughs), (sighs), (coughs), (clears throat), (gasps), (sniffs), (groans), (yawns)
  • Voice settings — control speed, volume, pitch, and emotion
  • 40+ languages — extensive language support with language boost
  • Audio customization — configurable format (MP3/PCM/FLAC), sample rate, channel, and bitrate
  • Voice modification — fine-tune pitch, intensity, and timbre
  • Pronunciation dictionary — custom pronunciation replacements
  • Loudness normalization — professional audio level control

Supported Voice IDs

Authorizations

Authorization
string
header
required

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

Body

application/json
prompt
string
required

Text to convert to speech. Use <#x#> for pauses (x = 0.01-99.99 seconds). Supports interjection tags: (laughs), (sighs), (coughs), (clears throat), (gasps), (sniffs), (groans), (yawns).

Required string length: 1 - 10000
voice_setting
object

Voice configuration settings (optional, defaults to Wise_Woman).

audio_setting
object | null

Audio configuration settings.

language_boost
enum<string> | null

Enhance recognition of specified languages and dialects.

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,
Slovak,
Swedish,
Croatian,
Hungarian,
Norwegian,
Slovenian,
Catalan,
Nynorsk,
Afrikaans,
auto
output_format
enum<string>
default:hex

Format of the output content (non-streaming only). Default: hex.

Available options:
url,
hex
pronunciation_dict
object | null

Custom pronunciation dictionary for text replacement.

normalization_setting
object | null

Loudness normalization settings for the audio.

voice_modify
object | null

Voice modification settings to adjust pitch, intensity, and timbre.

Response

202 - application/json

Accepted - Task created successfully

task_info
object