Skip to main content
POST
/
vendors
/
minimax
/
v1
/
speech-2.8-hd
/
text-to-speech
/
generation
Create Speech Generation Task
curl --request POST \
  --url https://api.mulerouter.ai/vendors/minimax/v1/speech-2.8-hd/text-to-speech/generation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "prompt": "Hello world! Welcome to MiniMax's new text to speech model <#0.1#> Speech 2.8 HD (laughs) now available!",
  "voice_setting": {
    "voice_id": "Wise_Woman",
    "speed": 1,
    "vol": 1,
    "pitch": 0
  },
  "output_format": "url"
}
EOF
{
  "task_info": {
    "id": "8e1e315e-b50d-4334-a231-be7d19a372f4",
    "status": "pending",
    "created_at": "2026-03-03T00:00:00Z",
    "updated_at": "2026-03-03T00:00:00Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://mulerouter.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
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

No.LanguageVoice IDVoice Name
1Chinese (Mandarin)male-qn-qingseYouthful Male
2Chinese (Mandarin)male-qn-jingyingElite Young Male
3Chinese (Mandarin)male-qn-badaoDominant Young Male
4Chinese (Mandarin)male-qn-daxueshengCollege Student Male
5Chinese (Mandarin)female-shaonvYoung Girl
6Chinese (Mandarin)female-yujieMature Female
7Chinese (Mandarin)female-chengshuSophisticated Woman
8Chinese (Mandarin)female-tianmeiSweet Woman
9Chinese (Mandarin)male-qn-qingse-jingpinYouthful Male Beta
10Chinese (Mandarin)male-qn-jingying-jingpinElite Young Male Beta
11Chinese (Mandarin)male-qn-badao-jingpinDominant Young Male Beta
12Chinese (Mandarin)male-qn-daxuesheng-jingpinCollege Student Male Beta
13Chinese (Mandarin)female-shaonv-jingpinYoung Girl Beta
14Chinese (Mandarin)female-yujie-jingpinMature Female Beta
15Chinese (Mandarin)female-chengshu-jingpinSophisticated Woman Beta
16Chinese (Mandarin)female-tianmei-jingpinSweet Woman Beta
17Chinese (Mandarin)clever_boyClever Boy
18Chinese (Mandarin)cute_boyCute Boy
19Chinese (Mandarin)lovely_girlLovely Girl
20Chinese (Mandarin)cartoon_pigCartoon Pig
21Chinese (Mandarin)bingjiao_didiClingy Brother
22Chinese (Mandarin)junlang_nanyouHandsome Boyfriend
23Chinese (Mandarin)chunzhen_xuediInnocent Junior
24Chinese (Mandarin)lengdan_xiongzhangCool Senior
25Chinese (Mandarin)badao_shaoyeBossy Young Master
26Chinese (Mandarin)tianxin_xiaolingSweet Ling
27Chinese (Mandarin)qiaopi_mengmeiPlayful Cute Girl
28Chinese (Mandarin)wumei_yujieCharming Mature Woman
29Chinese (Mandarin)diadia_xuemeiCoquettish Junior Girl
30Chinese (Mandarin)danya_xuejieElegant Senior Girl
31Chinese (Mandarin)Chinese (Mandarin)_Reliable_ExecutiveReliable Executive
32Chinese (Mandarin)Chinese (Mandarin)_News_AnchorNews Anchor
33Chinese (Mandarin)Chinese (Mandarin)_Mature_WomanMature Woman
34Chinese (Mandarin)Chinese (Mandarin)_Unrestrained_Young_ManUnrestrained Young Man
35Chinese (Mandarin)Arrogant_MissArrogant Miss
36Chinese (Mandarin)Robot_ArmorRobot Armor
37Chinese (Mandarin)Chinese (Mandarin)_Kind-hearted_AntieKind-hearted Auntie
38Chinese (Mandarin)Chinese (Mandarin)_HK_Flight_AttendantHK Flight Attendant
39Chinese (Mandarin)Chinese (Mandarin)_Humorous_ElderHumorous Elder
40Chinese (Mandarin)Chinese (Mandarin)_GentlemanGentleman
41Chinese (Mandarin)Chinese (Mandarin)_Warm_BestieWarm Bestie
42Chinese (Mandarin)Chinese (Mandarin)_Male_AnnouncerMale Announcer
43Chinese (Mandarin)Chinese (Mandarin)_Sweet_LadySweet Lady
44Chinese (Mandarin)Chinese (Mandarin)_Southern_Young_ManSouthern Young Man
45Chinese (Mandarin)Chinese (Mandarin)_Wise_WomenWise Woman
46Chinese (Mandarin)Chinese (Mandarin)_Gentle_YouthGentle Youth
47Chinese (Mandarin)Chinese (Mandarin)_Warm_GirlWarm Girl
48Chinese (Mandarin)Chinese (Mandarin)_Kind-hearted_ElderKind-hearted Elder
49Chinese (Mandarin)Chinese (Mandarin)_Cute_SpiritCute Spirit
50Chinese (Mandarin)Chinese (Mandarin)_Radio_HostRadio Host
51Chinese (Mandarin)Chinese (Mandarin)_Lyrical_VoiceLyrical Voice
52Chinese (Mandarin)Chinese (Mandarin)_Straightforward_BoyStraightforward Boy
53Chinese (Mandarin)Chinese (Mandarin)_Sincere_AdultSincere Adult
54Chinese (Mandarin)Chinese (Mandarin)_Gentle_SeniorGentle Senior
55Chinese (Mandarin)Chinese (Mandarin)_Stubborn_FriendStubborn Friend
56Chinese (Mandarin)Chinese (Mandarin)_Crisp_GirlCrisp Girl
57Chinese (Mandarin)Chinese (Mandarin)_Pure-hearted_BoyPure-hearted Boy
58Chinese (Mandarin)Chinese (Mandarin)_Soft_GirlSoft Girl
59Chinese (Cantonese)Cantonese_ProfessionalHost（F)Professional Female Host
60Chinese (Cantonese)Cantonese_GentleLadyGentle Lady
61Chinese (Cantonese)Cantonese_ProfessionalHost（M)Professional Male Host
62Chinese (Cantonese)Cantonese_PlayfulManPlayful Man
63Chinese (Cantonese)Cantonese_CuteGirlCute Girl
64Chinese (Cantonese)Cantonese_KindWomanKind Woman
65EnglishSanta_ClausSanta Claus
66EnglishGrinchGrinch
67EnglishRudolphRudolph
68EnglishArnoldArnold
69EnglishCharming_SantaCharming Santa
70EnglishCharming_LadyCharming Lady
71EnglishSweet_GirlSweet Girl
72EnglishCute_ElfCute Elf
73EnglishAttractive_GirlAttractive Girl
74EnglishSerene_WomanSerene Woman
75EnglishEnglish_Trustworthy_ManTrustworthy Man
76EnglishEnglish_Graceful_LadyGraceful Lady
77EnglishEnglish_Aussie_BlokeAussie Bloke
78EnglishEnglish_Whispering_girlWhispering Girl
79EnglishEnglish_Diligent_ManDiligent Man
80EnglishEnglish_Gentle-voiced_manGentle-voiced Man
81JapaneseJapanese_IntellectualSeniorIntellectual Senior
82JapaneseJapanese_DecisivePrincessDecisive Princess
83JapaneseJapanese_LoyalKnightLoyal Knight
84JapaneseJapanese_DominantManDominant Man
85JapaneseJapanese_SeriousCommanderSerious Commander
86JapaneseJapanese_ColdQueenCold Queen
87JapaneseJapanese_DependableWomanDependable Woman
88JapaneseJapanese_GentleButlerGentle Butler
89JapaneseJapanese_KindLadyKind Lady
90JapaneseJapanese_CalmLadyCalm Lady
91JapaneseJapanese_OptimisticYouthOptimistic Youth
92JapaneseJapanese_GenerousIzakayaOwnerGenerous Izakaya Owner
93JapaneseJapanese_SportyStudentSporty Student
94JapaneseJapanese_InnocentBoyInnocent Boy
95JapaneseJapanese_GracefulMaidenGraceful Maiden
96KoreanKorean_SweetGirlSweet Girl
97KoreanKorean_CheerfulBoyfriendCheerful Boyfriend
98KoreanKorean_EnchantingSisterEnchanting Sister
99KoreanKorean_ShyGirlShy Girl
100KoreanKorean_ReliableSisterReliable Sister
101KoreanKorean_StrictBossStrict Boss
102KoreanKorean_SassyGirlSassy Girl
103KoreanKorean_ChildhoodFriendGirlChildhood Friend Girl
104KoreanKorean_PlayboyCharmerPlayboy Charmer
105KoreanKorean_ElegantPrincessElegant Princess
106KoreanKorean_BraveFemaleWarriorBrave Female Warrior
107KoreanKorean_BraveYouthBrave Youth
108KoreanKorean_CalmLadyCalm Lady
109KoreanKorean_EnthusiasticTeenEnthusiastic Teen
110KoreanKorean_SoothingLadySoothing Lady
111KoreanKorean_IntellectualSeniorIntellectual Senior
112KoreanKorean_LonelyWarriorLonely Warrior
113KoreanKorean_MatureLadyMature Lady
114KoreanKorean_InnocentBoyInnocent Boy
115KoreanKorean_CharmingSisterCharming Sister
116KoreanKorean_AthleticStudentAthletic Student
117KoreanKorean_BraveAdventurerBrave Adventurer
118KoreanKorean_CalmGentlemanCalm Gentleman
119KoreanKorean_WiseElfWise Elf
120KoreanKorean_CheerfulCoolJuniorCheerful Cool Junior
121KoreanKorean_DecisiveQueenDecisive Queen
122KoreanKorean_ColdYoungManCold Young Man
123KoreanKorean_MysteriousGirlMysterious Girl
124KoreanKorean_QuirkyGirlQuirky Girl
125KoreanKorean_ConsiderateSeniorConsiderate Senior
126KoreanKorean_CheerfulLittleSisterCheerful Little Sister
127KoreanKorean_DominantManDominant Man
128KoreanKorean_AirheadedGirlAirheaded Girl
129KoreanKorean_ReliableYouthReliable Youth
130KoreanKorean_FriendlyBigSisterFriendly Big Sister
131KoreanKorean_GentleBossGentle Boss
132KoreanKorean_ColdGirlCold Girl
133KoreanKorean_HaughtyLadyHaughty Lady
134KoreanKorean_CharmingElderSisterCharming Elder Sister
135KoreanKorean_IntellectualManIntellectual Man
136KoreanKorean_CaringWomanCaring Woman
137KoreanKorean_WiseTeacherWise Teacher
138KoreanKorean_ConfidentBossConfident Boss
139KoreanKorean_AthleticGirlAthletic Girl
140KoreanKorean_PossessiveManPossessive Man
141KoreanKorean_GentleWomanGentle Woman
142KoreanKorean_CockyGuyCocky Guy
143KoreanKorean_ThoughtfulWomanThoughtful Woman
144KoreanKorean_OptimisticYouthOptimistic Youth
145SpanishSpanish_SereneWomanSerene Woman
146SpanishSpanish_MaturePartnerMature Partner
147SpanishSpanish_CaptivatingStorytellerCaptivating Storyteller
148SpanishSpanish_NarratorNarrator
149SpanishSpanish_WiseScholarWise Scholar
150SpanishSpanish_Kind-heartedGirlKind-hearted Girl
151SpanishSpanish_DeterminedManagerDetermined Manager
152SpanishSpanish_BossyLeaderBossy Leader
153SpanishSpanish_ReservedYoungManReserved Young Man
154SpanishSpanish_ConfidentWomanConfident Woman
155PortuguesePortuguese_SentimentalLadySentimental Lady
156PortuguesePortuguese_BossyLeaderBossy Leader
157PortuguesePortuguese_WiseladyWise Lady
158PortuguesePortuguese_Strong-WilledBoyStrong-willed Boy
159PortuguesePortuguese_Deep-VoicedGentlemanDeep-voiced Gentleman
160PortuguesePortuguese_UpsetGirlUpset Girl
161FrenchFrench_Male_Speech_NewLevel-Headed Man
162FrenchFrench_Female_News AnchorPatient Female Presenter
163FrenchFrench_CasualManCasual Man
164FrenchFrench_MovieLeadFemaleMovie Lead Female
165FrenchFrench_FemaleAnchorFemale Anchor
166FrenchFrench_MaleNarratorMale Narrator
167IndonesianIndonesian_SweetGirlSweet Girl
168IndonesianIndonesian_ReservedYoungManReserved Young Man
169IndonesianIndonesian_CharmingGirlCharming Girl
170IndonesianIndonesian_CalmWomanCalm Woman
171IndonesianIndonesian_ConfidentWomanConfident Woman
172IndonesianIndonesian_CaringManCaring Man
173IndonesianIndonesian_BossyLeaderBossy Leader
174IndonesianIndonesian_DeterminedBoyDetermined Boy
175IndonesianIndonesian_GentleGirlGentle Girl
176GermanGerman_FriendlyManFriendly Man
177GermanGerman_SweetLadySweet Lady
178GermanGerman_PlayfulManPlayful Man
179RussianRussian_HandsomeChildhoodFriendHandsome Childhood Friend
180RussianRussian_BrightHeroineBright Queen
181RussianRussian_AmbitiousWomanAmbitious Woman
182RussianRussian_ReliableManReliable Man
183RussianRussian_CrazyQueenCrazy Girl
184RussianRussian_PessimisticGirlPessimistic Girl
185RussianRussian_AttractiveGuyAttractive Guy
186RussianRussian_Bad-temperedBoyBad-tempered Boy
187ItalianItalian_BraveHeroineBrave Heroine
188ItalianItalian_NarratorNarrator
189ItalianItalian_WanderingSorcererWandering Sorcerer
190ItalianItalian_DiligentLeaderDiligent Leader
191ArabicArabic_CalmWomanCalm Woman
192ArabicArabic_FriendlyGuyFriendly Guy
193TurkishTurkish_CalmWomanCalm Woman
194TurkishTurkish_TrustworthymanTrustworthy Man
195UkrainianUkrainian_CalmWomanCalm Woman
196UkrainianUkrainian_WiseScholarWise Scholar
197DutchDutch_kindhearted_girlKind-hearted Girl
198DutchDutch_bossy_leaderBossy Leader
199VietnameseVietnamese_kindhearted_girlKind-hearted Girl
200ThaiThai_male_1_sample8Serene Man
201ThaiThai_male_2_sample2Friendly Man
202ThaiThai_female_1_sample1Confident Woman
203ThaiThai_female_2_sample2Energetic Woman
204PolishPolish_male_1_sample4Male Narrator
205PolishPolish_male_2_sample3Male Anchor
206PolishPolish_female_1_sample1Calm Woman
207PolishPolish_female_2_sample3Casual Woman
208RomanianRomanian_male_1_sample2Reliable Man
209RomanianRomanian_male_2_sample1Energetic Youth
210RomanianRomanian_female_1_sample4Optimistic Youth
211RomanianRomanian_female_2_sample1Gentle Woman
212Greekgreek_male_1a_v1Thoughtful Mentor
213GreekGreek_female_1_sample1Gentle Lady
214GreekGreek_female_2_sample3Girl Next Door
215Czechczech_male_1_v1Assured Presenter
216Czechczech_female_5_v7Steadfast Narrator
217Czechczech_female_2_v2Elegant Lady
218Finnishfinnish_male_3_v1Upbeat Man
219Finnishfinnish_male_1_v2Friendly Boy
220Finnishfinnish_female_4_v1Assertive Woman
221Hindihindi_male_1_v2Trustworthy Advisor
222Hindihindi_female_2_v1Tranquil Woman
223Hindihindi_female_1_v2News Anchor

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

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

Custom pronunciation dictionary for text replacement.

​
normalization_setting
object

Loudness normalization settings for the audio.

​
voice_modify
object

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

Response

202 - application/json

Accepted - Task created successfully

​
task_info
object