跳转到主要内容
POST
/
v1
/
predictions
curl --request POST \
  --url https://api.shuyou.ai/v1/predictions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "speech-2.8-hd",
  "function": "audio",
  "input": {
    "prompt": "At the jet bridge, Leo took his first step onto the metal walkway. He could smell faint fumes from the runway. The plane loomed ahead like a quiet animal. As he approached the door, he paused, gave the flight attendant a small smile, and entered the long, low-lit cabin.Engines roared. Leo grasped the armrest as the plane gathered speed and lifted into the sky. The city below shrank into a dim grid of lights. At cruising altitude, the engines settled into a low hum. The atmosphere outside felt thin and silent.",
    "voice": "English_Graceful_Lady"
  },
  "webhook": "https://api.shuyou.ai/backend/api/callback"
}
'
{
  "data": {
    "task_id": "2c4d50261173430290971a2395a3b607",
    "task_status": "processing"
  }
}

音色参数(input.voice

input.voice 中传入音色 ID(对应 MiniMax voice_id)。下表共 327 个系统音色。
#语言voice音色名称
1中文 (普通话)male-qn-qingse青涩青年音色
2中文 (普通话)male-qn-jingying精英青年音色
3中文 (普通话)male-qn-badao霸道青年音色
4中文 (普通话)male-qn-daxuesheng青年大学生音色
5中文 (普通话)female-shaonv少女音色
6中文 (普通话)female-yujie御姐音色
7中文 (普通话)female-chengshu成熟女性音色
8中文 (普通话)female-tianmei甜美女性音色
9中文 (普通话)male-qn-qingse-jingpin青涩青年音色-beta
10中文 (普通话)male-qn-jingying-jingpin精英青年音色-beta
11中文 (普通话)male-qn-badao-jingpin霸道青年音色-beta
12中文 (普通话)male-qn-daxuesheng-jingpin青年大学生音色-beta
13中文 (普通话)female-shaonv-jingpin少女音色-beta
14中文 (普通话)female-yujie-jingpin御姐音色-beta
15中文 (普通话)female-chengshu-jingpin成熟女性音色-beta
16中文 (普通话)female-tianmei-jingpin甜美女性音色-beta
17中文 (普通话)clever_boy聪明男童
18中文 (普通话)cute_boy可爱男童
19中文 (普通话)lovely_girl萌萌女童
20中文 (普通话)cartoon_pig卡通猪小琪
21中文 (普通话)bingjiao_didi病娇弟弟
22中文 (普通话)junlang_nanyou俊朗男友
23中文 (普通话)chunzhen_xuedi纯真学弟
24中文 (普通话)lengdan_xiongzhang冷淡学长
25中文 (普通话)badao_shaoye霸道少爷
26中文 (普通话)tianxin_xiaoling甜心小玲
27中文 (普通话)qiaopi_mengmei俏皮萌妹
28中文 (普通话)wumei_yujie妩媚御姐
29中文 (普通话)diadia_xuemei嗲嗲学妹
30中文 (普通话)danya_xuejie淡雅学姐
31中文 (普通话)Chinese (Mandarin)_Reliable_Executive沉稳高管
32中文 (普通话)Chinese (Mandarin)_News_Anchor新闻女声
33中文 (普通话)Chinese (Mandarin)_Mature_Woman傲娇御姐
34中文 (普通话)Chinese (Mandarin)_Unrestrained_Young_Man不羁青年
35中文 (普通话)Arrogant_Miss嚣张小姐
36中文 (普通话)Robot_Armor机械战甲
37中文 (普通话)Chinese (Mandarin)_Kind-hearted_Antie热心大婶
38中文 (普通话)Chinese (Mandarin)_HK_Flight_Attendant港普空姐
39中文 (普通话)Chinese (Mandarin)_Humorous_Elder搞笑大爷
40中文 (普通话)Chinese (Mandarin)_Gentleman温润男声
41中文 (普通话)Chinese (Mandarin)_Warm_Bestie温暖闺蜜
42中文 (普通话)Chinese (Mandarin)_Male_Announcer播报男声
43中文 (普通话)Chinese (Mandarin)_Sweet_Lady甜美女声
44中文 (普通话)Chinese (Mandarin)_Southern_Young_Man南方小哥
45中文 (普通话)Chinese (Mandarin)_Wise_Women阅历姐姐
46中文 (普通话)Chinese (Mandarin)_Gentle_Youth温润青年
47中文 (普通话)Chinese (Mandarin)_Warm_Girl温暖少女
48中文 (普通话)Chinese (Mandarin)_Kind-hearted_Elder花甲奶奶
49中文 (普通话)Chinese (Mandarin)_Cute_Spirit憨憨萌兽
50中文 (普通话)Chinese (Mandarin)_Radio_Host电台男主播
51中文 (普通话)Chinese (Mandarin)_Lyrical_Voice抒情男声
52中文 (普通话)Chinese (Mandarin)_Straightforward_Boy率真弟弟
53中文 (普通话)Chinese (Mandarin)_Sincere_Adult真诚青年
54中文 (普通话)Chinese (Mandarin)_Gentle_Senior温柔学姐
55中文 (普通话)Chinese (Mandarin)_Stubborn_Friend嘴硬竹马
56中文 (普通话)Chinese (Mandarin)_Crisp_Girl清脆少女
57中文 (普通话)Chinese (Mandarin)_Pure-hearted_Boy清澈邻家弟弟
58中文 (普通话)Chinese (Mandarin)_Soft_Girl柔和少女
59中文 (粤语)Cantonese_ProfessionalHost(F)专业女主持
60中文 (粤语)Cantonese_GentleLady温柔女声
61中文 (粤语)Cantonese_ProfessionalHost(M)专业男主持
62中文 (粤语)Cantonese_PlayfulMan活泼男声
63中文 (粤语)Cantonese_CuteGirl可爱女孩
64中文 (粤语)Cantonese_KindWoman善良女声
65英文Santa_ClausSanta Claus
66英文GrinchGrinch
67英文RudolphRudolph
68英文ArnoldArnold
69英文Charming_SantaCharming Santa
70英文Charming_LadyCharming Lady
71英文Sweet_GirlSweet Girl
72英文Cute_ElfCute Elf
73英文Attractive_GirlAttractive Girl
74英文Serene_WomanSerene Woman
75英文English_Trustworthy_ManTrustworthy Man
76英文English_Graceful_LadyGraceful Lady
77英文English_Aussie_BlokeAussie Bloke
78英文English_Whispering_girlWhispering girl
79英文English_Diligent_ManDiligent Man
80英文English_Gentle-voiced_manGentle-voiced man
81日文Japanese_IntellectualSeniorIntellectual Senior
82日文Japanese_DecisivePrincessDecisive Princess
83日文Japanese_LoyalKnightLoyal Knight
84日文Japanese_DominantManDominant Man
85日文Japanese_SeriousCommanderSerious Commander
86日文Japanese_ColdQueenCold Queen
87日文Japanese_DependableWomanDependable Woman
88日文Japanese_GentleButlerGentle Butler
89日文Japanese_KindLadyKind Lady
90日文Japanese_CalmLadyCalm Lady
91日文Japanese_OptimisticYouthOptimistic Youth
92日文Japanese_GenerousIzakayaOwnerGenerous Izakaya Owner
93日文Japanese_SportyStudentSporty Student
94日文Japanese_InnocentBoyInnocent Boy
95日文Japanese_GracefulMaidenGraceful Maiden
96韩文Korean_SweetGirlSweet Girl
97韩文Korean_CheerfulBoyfriendCheerful Boyfriend
98韩文Korean_EnchantingSisterEnchanting Sister
99韩文Korean_ShyGirlShy Girl
100韩文Korean_ReliableSisterReliable Sister
101韩文Korean_StrictBossStrict Boss
102韩文Korean_SassyGirlSassy Girl
103韩文Korean_ChildhoodFriendGirlChildhood Friend Girl
104韩文Korean_PlayboyCharmerPlayboy Charmer
105韩文Korean_ElegantPrincessElegant Princess
106韩文Korean_BraveFemaleWarriorBrave Female Warrior
107韩文Korean_BraveYouthBrave Youth
108韩文Korean_CalmLadyCalm Lady
109韩文Korean_EnthusiasticTeenEnthusiastic Teen
110韩文Korean_SoothingLadySoothing Lady
111韩文Korean_IntellectualSeniorIntellectual Senior
112韩文Korean_LonelyWarriorLonely Warrior
113韩文Korean_MatureLadyMature Lady
114韩文Korean_InnocentBoyInnocent Boy
115韩文Korean_CharmingSisterCharming Sister
116韩文Korean_AthleticStudentAthletic Student
117韩文Korean_BraveAdventurerBrave Adventurer
118韩文Korean_CalmGentlemanCalm Gentleman
119韩文Korean_WiseElfWise Elf
120韩文Korean_CheerfulCoolJuniorCheerful Cool Junior
121韩文Korean_DecisiveQueenDecisive Queen
122韩文Korean_ColdYoungManCold Young Man
123韩文Korean_MysteriousGirlMysterious Girl
124韩文Korean_QuirkyGirlQuirky Girl
125韩文Korean_ConsiderateSeniorConsiderate Senior
126韩文Korean_CheerfulLittleSisterCheerful Little Sister
127韩文Korean_DominantManDominant Man
128韩文Korean_AirheadedGirlAirheaded Girl
129韩文Korean_ReliableYouthReliable Youth
130韩文Korean_FriendlyBigSisterFriendly Big Sister
131韩文Korean_GentleBossGentle Boss
132韩文Korean_ColdGirlCold Girl
133韩文Korean_HaughtyLadyHaughty Lady
134韩文Korean_CharmingElderSisterCharming Elder Sister
135韩文Korean_IntellectualManIntellectual Man
136韩文Korean_CaringWomanCaring Woman
137韩文Korean_WiseTeacherWise Teacher
138韩文Korean_ConfidentBossConfident Boss
139韩文Korean_AthleticGirlAthletic Girl
140韩文Korean_PossessiveManPossessive Man
141韩文Korean_GentleWomanGentle Woman
142韩文Korean_CockyGuyCocky Guy
143韩文Korean_ThoughtfulWomanThoughtful Woman
144韩文Korean_OptimisticYouthOptimistic Youth
145西班牙文Spanish_SereneWomanSerene Woman
146西班牙文Spanish_MaturePartnerMature Partner
147西班牙文Spanish_CaptivatingStorytellerCaptivating Storyteller
148西班牙文Spanish_NarratorNarrator
149西班牙文Spanish_WiseScholarWise Scholar
150西班牙文Spanish_Kind-heartedGirlKind-hearted Girl
151西班牙文Spanish_DeterminedManagerDetermined Manager
152西班牙文Spanish_BossyLeaderBossy Leader
153西班牙文Spanish_ReservedYoungManReserved Young Man
154西班牙文Spanish_ConfidentWomanConfident Woman
155西班牙文Spanish_ThoughtfulManThoughtful Man
156西班牙文Spanish_Strong-WilledBoyStrong-willed Boy
157西班牙文Spanish_SophisticatedLadySophisticated Lady
158西班牙文Spanish_RationalManRational Man
159西班牙文Spanish_AnimeCharacterAnime Character
160西班牙文Spanish_Deep-tonedManDeep-toned Man
161西班牙文Spanish_FussyhostessFussy hostess
162西班牙文Spanish_SincereTeenSincere Teen
163西班牙文Spanish_FrankLadyFrank Lady
164西班牙文Spanish_ComedianComedian
165西班牙文Spanish_DebatorDebator
166西班牙文Spanish_ToughBossTough Boss
167西班牙文Spanish_WiseladyWise Lady
168西班牙文Spanish_SteadymentorSteady Mentor
169西班牙文Spanish_JovialmanJovial Man
170西班牙文Spanish_SantaClausSanta Claus
171西班牙文Spanish_RudolphRudolph
172西班牙文Spanish_IntonategirlIntonate Girl
173西班牙文Spanish_ArnoldArnold
174西班牙文Spanish_GhostGhost
175西班牙文Spanish_HumorousElderHumorous Elder
176西班牙文Spanish_EnergeticBoyEnergetic Boy
177西班牙文Spanish_WhimsicalGirlWhimsical Girl
178西班牙文Spanish_StrictBossStrict Boss
179西班牙文Spanish_ReliableManReliable Man
180西班牙文Spanish_SereneElderSerene Elder
181西班牙文Spanish_AngryManAngry Man
182西班牙文Spanish_AssertiveQueenAssertive Queen
183西班牙文Spanish_CaringGirlfriendCaring Girlfriend
184西班牙文Spanish_PowerfulSoldierPowerful Soldier
185西班牙文Spanish_PassionateWarriorPassionate Warrior
186西班牙文Spanish_ChattyGirlChatty Girl
187西班牙文Spanish_RomanticHusbandRomantic Husband
188西班牙文Spanish_CompellingGirlCompelling Girl
189西班牙文Spanish_PowerfulVeteranPowerful Veteran
190西班牙文Spanish_SensibleManagerSensible Manager
191西班牙文Spanish_ThoughtfulLadyThoughtful Lady
192葡萄牙文Portuguese_SentimentalLadySentimental Lady
193葡萄牙文Portuguese_BossyLeaderBossy Leader
194葡萄牙文Portuguese_WiseladyWise lady
195葡萄牙文Portuguese_Strong-WilledBoyStrong-willed Boy
196葡萄牙文Portuguese_Deep-VoicedGentlemanDeep-voiced Gentleman
197葡萄牙文Portuguese_UpsetGirlUpset Girl
198葡萄牙文Portuguese_PassionateWarriorPassionate Warrior
199葡萄牙文Portuguese_AnimeCharacterAnime Character
200葡萄牙文Portuguese_ConfidentWomanConfident Woman
201葡萄牙文Portuguese_AngryManAngry Man
202葡萄牙文Portuguese_CaptivatingStorytellerCaptivating Storyteller
203葡萄牙文Portuguese_GodfatherGodfather
204葡萄牙文Portuguese_ReservedYoungManReserved Young Man
205葡萄牙文Portuguese_SmartYoungGirlSmart Young Girl
206葡萄牙文Portuguese_Kind-heartedGirlKind-hearted Girl
207葡萄牙文Portuguese_PompousladyPompous lady
208葡萄牙文Portuguese_GrinchGrinch
209葡萄牙文Portuguese_DebatorDebator
210葡萄牙文Portuguese_SweetGirlSweet Girl
211葡萄牙文Portuguese_AttractiveGirlAttractive Girl
212葡萄牙文Portuguese_ThoughtfulManThoughtful Man
213葡萄牙文Portuguese_PlayfulGirlPlayful Girl
214葡萄牙文Portuguese_GorgeousLadyGorgeous Lady
215葡萄牙文Portuguese_LovelyLadyLovely Lady
216葡萄牙文Portuguese_SereneWomanSerene Woman
217葡萄牙文Portuguese_SadTeenSad Teen
218葡萄牙文Portuguese_MaturePartnerMature Partner
219葡萄牙文Portuguese_ComedianComedian
220葡萄牙文Portuguese_NaughtySchoolgirlNaughty Schoolgirl
221葡萄牙文Portuguese_NarratorNarrator
222葡萄牙文Portuguese_ToughBossTough Boss
223葡萄牙文Portuguese_FussyhostessFussy hostess
224葡萄牙文Portuguese_DramatistDramatist
225葡萄牙文Portuguese_SteadymentorSteady Mentor
226葡萄牙文Portuguese_JovialmanJovial Man
227葡萄牙文Portuguese_CharmingQueenCharming Queen
228葡萄牙文Portuguese_SantaClausSanta Claus
229葡萄牙文Portuguese_RudolphRudolph
230葡萄牙文Portuguese_ArnoldArnold
231葡萄牙文Portuguese_CharmingSantaCharming Santa
232葡萄牙文Portuguese_CharmingLadyCharming Lady
233葡萄牙文Portuguese_GhostGhost
234葡萄牙文Portuguese_HumorousElderHumorous Elder
235葡萄牙文Portuguese_CalmLeaderCalm Leader
236葡萄牙文Portuguese_GentleTeacherGentle Teacher
237葡萄牙文Portuguese_EnergeticBoyEnergetic Boy
238葡萄牙文Portuguese_ReliableManReliable Man
239葡萄牙文Portuguese_SereneElderSerene Elder
240葡萄牙文Portuguese_GrimReaperGrim Reaper
241葡萄牙文Portuguese_AssertiveQueenAssertive Queen
242葡萄牙文Portuguese_WhimsicalGirlWhimsical Girl
243葡萄牙文Portuguese_StressedLadyStressed Lady
244葡萄牙文Portuguese_FriendlyNeighborFriendly Neighbor
245葡萄牙文Portuguese_CaringGirlfriendCaring Girlfriend
246葡萄牙文Portuguese_PowerfulSoldierPowerful Soldier
247葡萄牙文Portuguese_FascinatingBoyFascinating Boy
248葡萄牙文Portuguese_RomanticHusbandRomantic Husband
249葡萄牙文Portuguese_StrictBossStrict Boss
250葡萄牙文Portuguese_InspiringLadyInspiring Lady
251葡萄牙文Portuguese_PlayfulSpiritPlayful Spirit
252葡萄牙文Portuguese_ElegantGirlElegant Girl
253葡萄牙文Portuguese_CompellingGirlCompelling Girl
254葡萄牙文Portuguese_PowerfulVeteranPowerful Veteran
255葡萄牙文Portuguese_SensibleManagerSensible Manager
256葡萄牙文Portuguese_ThoughtfulLadyThoughtful Lady
257葡萄牙文Portuguese_TheatricalActorTheatrical Actor
258葡萄牙文Portuguese_FragileBoyFragile Boy
259葡萄牙文Portuguese_ChattyGirlChatty Girl
260葡萄牙文Portuguese_ConscientiousinstructorConscientious Instructor
261葡萄牙文Portuguese_RationalManRational Man
262葡萄牙文Portuguese_WiseScholarWise Scholar
263葡萄牙文Portuguese_FrankLadyFrank Lady
264葡萄牙文Portuguese_DeterminedManagerDetermined Manager
265法文French_Male_Speech_NewLevel-Headed Man
266法文French_Female_News AnchorPatient Female Presenter
267法文French_CasualManCasual Man
268法文French_MovieLeadFemaleMovie Lead Female
269法文French_FemaleAnchorFemale Anchor
270法文French_MaleNarratorMale Narrator
271印尼文Indonesian_SweetGirlSweet Girl
272印尼文Indonesian_ReservedYoungManReserved Young Man
273印尼文Indonesian_CharmingGirlCharming Girl
274印尼文Indonesian_CalmWomanCalm Woman
275印尼文Indonesian_ConfidentWomanConfident Woman
276印尼文Indonesian_CaringManCaring Man
277印尼文Indonesian_BossyLeaderBossy Leader
278印尼文Indonesian_DeterminedBoyDetermined Boy
279印尼文Indonesian_GentleGirlGentle Girl
280德文German_FriendlyManFriendly Man
281德文German_SweetLadySweet Lady
282德文German_PlayfulManPlayful Man
283俄文Russian_HandsomeChildhoodFriendHandsome Childhood Friend
284俄文Russian_BrightHeroineBright Queen
285俄文Russian_AmbitiousWomanAmbitious Woman
286俄文Russian_ReliableManReliable Man
287俄文Russian_CrazyQueenCrazy Girl
288俄文Russian_PessimisticGirlPessimistic Girl
289俄文Russian_AttractiveGuyAttractive Guy
290俄文Russian_Bad-temperedBoyBad-tempered Boy
291意大利文Italian_BraveHeroineBrave Heroine
292意大利文Italian_NarratorNarrator
293意大利文Italian_WanderingSorcererWandering Sorcerer
294意大利文Italian_DiligentLeaderDiligent Leader
295阿拉伯文Arabic_CalmWomanCalm Woman
296阿拉伯文Arabic_FriendlyGuyFriendly Guy
297土耳其文Turkish_CalmWomanCalm Woman
298土耳其文Turkish_TrustworthymanTrustworthy man
299乌克兰文Ukrainian_CalmWomanCalm Woman
300乌克兰文Ukrainian_WiseScholarWise Scholar
301荷兰文Dutch_kindhearted_girlKind-hearted girl
302荷兰文Dutch_bossy_leaderBossy leader
303越南文Vietnamese_kindhearted_girlKind-hearted girl
304泰文Thai_male_1_sample8Serene Man
305泰文Thai_male_2_sample2Friendly Man
306泰文Thai_female_1_sample1Confident Woman
307泰文Thai_female_2_sample2Energetic Woman
308波兰文Polish_male_1_sample4Male Narrator
309波兰文Polish_male_2_sample3Male Anchor
310波兰文Polish_female_1_sample1Calm Woman
311波兰文Polish_female_2_sample3Casual Woman
312罗马尼亚文Romanian_male_1_sample2Reliable Man
313罗马尼亚文Romanian_male_2_sample1Energetic Youth
314罗马尼亚文Romanian_female_1_sample4Optimistic Youth
315罗马尼亚文Romanian_female_2_sample1Gentle Woman
316希腊文greek_male_1a_v1Thoughtful Mentor
317希腊文Greek_female_1_sample1Gentle Lady
318希腊文Greek_female_2_sample3Girl Next Door
319捷克文czech_male_1_v1Assured Presenter
320捷克文czech_female_5_v7Steadfast Narrator
321捷克文czech_female_2_v2Elegant Lady
322芬兰文finnish_male_3_v1Upbeat Man
323芬兰文finnish_male_1_v2Friendly Boy
324芬兰文finnish_female_4_v1Assetive Woman
325印地文hindi_male_1_v2Trustworthy Advisor
326印地文hindi_female_2_v1Tranquil Woman
327印地文hindi_female_1_v2News Anchor

语种参数(input.language

可选。对应 MiniMax language_boost,用于增强指定语种或方言的合成效果。省略或传 auto 时由模型自动检测。
language说明
Chinese普通话
Chinese,Yue粤语(勿使用 Cantonese
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
合成粤语文本时,请显式设置 languageChinese,Yue,并选用粤语音色(如 Cantonese_*)。
开通克隆能力后,也可使用最长 64 字符的自定义 voice_id

可选参数

FieldTypeDescription
speednumber语速 0.52.0,默认 1
volumenumber音量 010,默认 1
pitchinteger音调 -1212 半音,默认 0
emotionstringhappysadcalmneutralfluent
formatstring输出格式:mp3wavflacpcm(默认 mp3
languagestring语种增强,见上文 语种参数autoChineseChinese,Yue 等)
english_normalizationboolean英文数字/日期朗读规范化

授权

Authorization
string
header
必填

Authorization: Bearer YOUR_API_KEY

请求体

application/json
model
string
默认值:speech-2.8-hd
必填

Model ID. Use speech-2.8-hd for this endpoint.

示例:

"speech-2.8-hd"

function
enum<string>
必填

Task type. Must be audio for text-to-speech.

可用选项:
audio
示例:

"audio"

input
object
必填
webhook
string<uri>

Optional HTTPS callback URL when the task completes, fails, or is cancelled.

响应

Async task created

data
object
必填