请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
text | 是 | The words to be spoken, exactly as written. Sound tags such as (sighs) or (laughs) are performed. |
pitch | 否 | Pitch shift in semitones; 0 keeps the voice's own pitch. ≥ -12 · ≤ 12 · 默认值: 0 |
speed | 否 | 语速。 ≥ 0.5 · ≤ 2 · 默认值: 1 |
volume | 否 | Loudness multiplier; 1 is the normal level. ≥ 0.1 · ≤ 10 · 默认值: 1 |
bitrate | 否 | MP3 bitrate in bits per second; ignored for other formats. The model uses 128000 when omitted. 32000 · 64000 · 128000 · 256000 |
emotion | 否 | 朗读的情绪。 neutral · happy · sad · angry · fearful · disgusted · surprised · 默认值: neutral |
language | 否 | 朗读的语言。 auto · zh · yue · en · ar · ru · es · fr · pt · de · tr · nl · uk · vi · id · ja · it · ko · th · pl · ro · el · cs · fi · hi · bg · da · he · ms · fa · sk · sv · hr · fil · hu · no · sl · ca · nn · ta · af · 默认值: auto |
voice_id | 否 | 从可用音色里挑一个。 Wise_Woman · Friendly_Person · Inspirational_girl · Deep_Voice_Man · Calm_Woman · Casual_Guy · Lively_Girl · Patient_Man · Young_Knight · Determined_Man · Lovely_Girl · Decent_Boy · Imposing_Manner · Elegant_Man · Abbess · Sweet_Girl_2 · Exuberant_Girl · English_expressive_narrator · English_radiant_girl · English_magnetic_voiced_man · English_compelling_lady1 · English_Aussie_Bloke · English_captivating_female1 · English_Upbeat_Woman · English_Trustworth_Man · English_CalmWoman · English_UpsetGirl · English_Gentle-voiced_man · English_Whispering_girl_v3 · English_Diligent_Man · English_Graceful_Lady · English_Husky_MetalHead · English_ReservedYoungMan · English_PlayfulGirl · English_ManWithDeepVoice · English_GentleTeacher · English_MaturePartner · English_FriendlyPerson · English_MatureBoss · English_Debator · whisper_man · English_Abbess · English_LovelyGirl · whisper_woman_1 · English_Steadymentor · English_Deep-VoicedGentleman · English_DeterminedMan · English_Wiselady · English_CaptivatingStoryteller · English_AttractiveGirl · English_DecentYoungMan · English_SentimentalLady · English_ImposingManner · English_SadTeen · English_ThoughtfulMan · English_PassionateWarrior · English_DecentBoy · English_WiseScholar · English_Soft-spokenGirl · English_SereneWoman · English_ConfidentWoman · English_PatientMan · English_Comedian · English_GorgeousLady · English_BossyLeader · English_LovelyLady · English_Strong-WilledBoy · English_Deep-tonedMan · English_StressedLady · English_AssertiveQueen · English_AnimeCharacter · English_Jovialman · English_WhimsicalGirl · English_CharmingQueen · English_Kind-heartedGirl · English_FriendlyNeighbor · English_Sweet_Female_4 · English_Magnetic_Male_2 · English_Lively_Male_11 · English_Friendly_Female_3 · English_Steady_Female_1 · English_Lively_Male_10 · English_Magnetic_Male_12 · English_Steady_Female_5 · English_Insightful_Speaker · English_patient_man_v1 · English_Persuasive_Man · English_Explanatory_Man · English_intellect_female_1 · English_energetic_male_1 · English_witty_female_1 · English_Lucky_Robot · English_Cute_Girl · English_Sharp_Commentator · English_Honest_Man · angry_pirate_1 · massive_kind_troll · movie_trailer_deep · peace_and_ease · moss_audio_6dc281eb-713c-11f0-a447-9613c873494c · moss_audio_c12a59b9-7115-11f0-a447-9613c873494c · moss_audio_076697ad-7144-11f0-a447-9613c873494c · moss_audio_737a299c-734a-11f0-918f-4e0486034804 · moss_audio_19dbb103-7350-11f0-ad20-f2bc95e89150 · moss_audio_7c7e7ae2-7356-11f0-9540-7ef9b4b62566 · moss_audio_570551b1-735c-11f0-b236-0adeeecad052 · moss_audio_ad5baf92-735f-11f0-8263-fe5a2fe98ec8 · moss_audio_cedfd4d2-736d-11f0-99be-fe40dd2a5fe8 · moss_audio_a0d611da-737c-11f0-ad20-f2bc95e89150 · moss_audio_4f4172f4-737b-11f0-9540-7ef9b4b62566 · moss_audio_62ca20b0-7380-11f0-99be-fe40dd2a5fe8 · conversational_female_1_v1 · conversational_female_2_v1 · socialmedia_female_1_v1 · BritishChild_male_1_v1 · BritishChild_female_1_v1 · Chinese (Mandarin)_Reliable_Executive · Chinese (Mandarin)_News_Anchor · Chinese (Mandarin)_Unrestrained_Young_Man · Chinese (Mandarin)_Mature_Woman · Arrogant_Miss · Chinese (Mandarin)_Kind-hearted_Antie · Robot_Armor · hunyin_6 · Chinese (Mandarin)_HK_Flight_Attendant · Chinese (Mandarin)_Humorous_Elder · Chinese (Mandarin)_Gentleman · Chinese (Mandarin)_Warm_Bestie · Chinese (Mandarin)_Stubborn_Friend · Chinese (Mandarin)_Sweet_Lady · Chinese (Mandarin)_Southern_Young_Man · Chinese (Mandarin)_Wise_Women · Chinese (Mandarin)_Gentle_Youth · Chinese (Mandarin)_Warm_Girl · Chinese (Mandarin)_Male_Announcer · Chinese (Mandarin)_Kind-hearted_Elder · Chinese (Mandarin)_Cute_Spirit · Chinese (Mandarin)_Radio_Host · Chinese (Mandarin)_Lyrical_Voice · Chinese (Mandarin)_Straightforward_Boy · Chinese (Mandarin)_Sincere_Adult · Chinese (Mandarin)_Gentle_Senior · Chinese (Mandarin)_Crisp_Girl · Chinese (Mandarin)_Pure-hearted_Boy · Chinese (Mandarin)_Soft_Girl · Chinese (Mandarin)_IntellectualGirl · Chinese (Mandarin)_Warm_HeartedGirl · Chinese (Mandarin)_Laid_BackGirl · Chinese (Mandarin)_ExplorativeGirl · Chinese (Mandarin)_Warm-HeartedAunt · Chinese (Mandarin)_BashfulGirl · Arabic_CalmWoman · Arabic_FriendlyGuy · Cantonese_ProfessionalHost(F) · Cantonese_GentleLady · Cantonese_ProfessionalHost(M) · Cantonese_PlayfulMan · Cantonese_CuteGirl · Cantonese_KindWoman · Cantonese_Narrator · Cantonese_WiselProfessor · Cantonese_IndifferentStaff · Dutch_kindhearted_girl · Dutch_bossy_leader · French_Male_Speech_New · French_Female_News Anchor · French_CasualMan · French_MovieLeadFemale · French_FemaleAnchor · French_MaleNarrator · French_Female Journalist · French_Female_Speech_New · German_FriendlyMan · German_SweetLady · German_PlayfulMan · Indonesian_SweetGirl · Indonesian_ReservedYoungMan · Indonesian_CharmingGirl · Indonesian_CalmWoman · Indonesian_ConfidentWoman · Indonesian_CaringMan · Indonesian_BossyLeader · Indonesian_DeterminedBoy · Indonesian_GentleGirl · Italian_BraveHeroine · Italian_Narrator · Italian_WanderingSorcerer · Italian_DiligentLeader · Italian_ReliableMan · Italian_AthleticStudent · Italian_ArrogantPrincess · Japanese_Whisper_Belle · Japanese_IntellectualSenior · Japanese_DecisivePrincess · Japanese_LoyalKnight · Japanese_DominantMan · Japanese_SeriousCommander · Japanese_ColdQueen · Japanese_DependableWoman · Japanese_GentleButler · Japanese_KindLady · Japanese_CalmLady · Japanese_OptimisticYouth · Japanese_GenerousIzakayaOwner · Japanese_SportyStudent · Japanese_InnocentBoy · Japanese_GracefulMaiden · Korean_PowerfulGirl · Korean_BossyMan · Korean_SweetGirl · Korean_CheerfulBoyfriend · Korean_EnchantingSister · Korean_ShyGirl · Korean_ReliableSister · Korean_StrictBoss · Korean_SassyGirl · Korean_ChildhoodFriendGirl · Korean_PlayboyCharmer · Korean_ElegantPrincess · Korean_BraveFemaleWarrior · Korean_BraveYouth · Korean_CalmLady · Korean_EnthusiasticTeen · Korean_SoothingLady · Korean_IntellectualSenior · Korean_LonelyWarrior · Korean_MatureLady · Korean_InnocentBoy · Korean_CharmingSister · Korean_AthleticStudent · Korean_BraveAdventurer · Korean_CalmGentleman · Korean_WiseElf · Korean_CheerfulCoolJunior · Korean_DecisiveQueen · Korean_ColdYoungMan · Korean_MysteriousGirl · Korean_QuirkyGirl · Korean_ConsiderateSenior · Korean_CheerfulLittleSister · Korean_DominantMan · Korean_AirheadedGirl · Korean_ReliableYouth · Korean_FriendlyBigSister · Korean_GentleBoss · Korean_ColdGirl · Korean_HaughtyLady · Korean_CharmingElderSister · Korean_IntellectualMan · Korean_CaringWoman · Korean_WiseTeacher · Korean_ConfidentBoss · Korean_AthleticGirl · Korean_PossessiveMan · Korean_GentleWoman · Korean_CockyGuy · Korean_ThoughtfulWoman · Korean_OptimisticYouth · Portuguese_AnxiousMan · Portuguese_Matureresearcher · Portuguese_Optimisticyouth · Portuguese_CuteElf · Portuguese_EnergeticGirl · Portuguese_FunnyGuy · Portuguese_Nuttylady · Portuguese_Deep-tonedMan · Portuguese_SentimentalLady · Portuguese_BossyLeader · Portuguese_Wiselady · Portuguese_Strong-WilledBoy · Portuguese_Deep-VoicedGentleman · Portuguese_UpsetGirl · Portuguese_PassionateWarrior · Portuguese_AnimeCharacter · Portuguese_ConfidentWoman · Portuguese_AngryMan · Portuguese_CaptivatingStoryteller · Portuguese_Godfather · Portuguese_ReservedYoungMan · Portuguese_SmartYoungGirl · Portuguese_Kind-heartedGirl · Portuguese_Pompouslady · Portuguese_Grinch · Portuguese_Debator · Portuguese_SweetGirl · Portuguese_AttractiveGirl · Portuguese_ThoughtfulMan · Portuguese_PlayfulGirl · Portuguese_GorgeousLady · Portuguese_LovelyLady · Portuguese_SereneWoman · Portuguese_SadTeen · Portuguese_MaturePartner · Portuguese_Comedian · Portuguese_NaughtySchoolgirl · Portuguese_Narrator · Portuguese_ToughBoss · Portuguese_Fussyhostess · Portuguese_Dramatist · Portuguese_Steadymentor · Portuguese_Jovialman · Portuguese_CharmingQueen · Portuguese_SantaClaus · Portuguese_Rudolph · Portuguese_Arnold · Portuguese_CharmingSanta · Portuguese_Ghost · Portuguese_HumorousElder · Portuguese_CalmLeader · Portuguese_GentleTeacher · Portuguese_EnergeticBoy · Portuguese_ReliableMan · Portuguese_SereneElder · Portuguese_GrimReaper · Portuguese_AssertiveQueen · Portuguese_WhimsicalGirl · Portuguese_StressedLady · Portuguese_FriendlyNeighbor · Portuguese_CaringGirlfriend · Portuguese_PowerfulSoldier · Portuguese_FascinatingBoy · Portuguese_RomanticHusband · Portuguese_StrictBoss · Portuguese_InspiringLady · Portuguese_PlayfulSpirit · Portuguese_ElegantGirl · Portuguese_CompellingGirl · Portuguese_PowerfulVeteran · Portuguese_SensibleManager · Portuguese_ThoughtfulLady · Portuguese_TheatricalActor · Portuguese_FragileBoy · Portuguese_ChattyGirl · Portuguese_Conscientiousinstructor · Portuguese_RationalMan · Portuguese_WiseScholar · Portuguese_FrankLady · Portuguese_DeterminedManager · Portuguese_CharmingLady · Russian_HandsomeChildhoodFriend · Russian_BrightHeroine · Russian_AmbitiousWoman · Russian_ReliableMan · Russian_CrazyQueen · Russian_PessimisticGirl · Russian_AttractiveGuy · Russian_Bad-temperedBoy · Spanish_FriendlyNeighbor · Spanish_FragileBoy · Spanish_UpsetGirl · Spanish_Soft-spokenGirl · Spanish_CharmingQueen · Spanish_Nuttylady · Spanish_ElegantGirl · Spanish_FascinatingBoy · Spanish_FunnyGuy · Spanish_PlayfulSpirit · Spanish_TheatricalActor · Spanish_SereneWoman · Spanish_MaturePartner · Spanish_CaptivatingStoryteller · Spanish_Narrator · Spanish_WiseScholar · Spanish_Kind-heartedGirl · Spanish_DeterminedManager · Spanish_BossyLeader · Spanish_ReservedYoungMan · Spanish_ConfidentWoman · Spanish_ThoughtfulMan · Spanish_Strong-WilledBoy · Spanish_SophisticatedLady · Spanish_RationalMan · Spanish_AnimeCharacter · Spanish_Deep-tonedMan · Spanish_Fussyhostess · Spanish_SincereTeen · Spanish_FrankLady · Spanish_Comedian · Spanish_Debator · Spanish_ToughBoss · Spanish_Wiselady · Spanish_Steadymentor · Spanish_Jovialman · Spanish_SantaClaus · Spanish_Rudolph · Spanish_Intonategirl · Spanish_Arnold · Spanish_Ghost · Spanish_HumorousElder · Spanish_EnergeticBoy · Spanish_WhimsicalGirl · Spanish_StrictBoss · Spanish_ReliableMan · Spanish_SereneElder · Spanish_AngryMan · Spanish_AssertiveQueen · Spanish_CaringGirlfriend · Spanish_PowerfulSoldier · Spanish_PassionateWarrior · Spanish_ChattyGirl · Spanish_RomanticHusband · Spanish_CompellingGirl · Spanish_PowerfulVeteran · Spanish_SensibleManager · Spanish_ThoughtfulLady · Turkish_CalmWoman · Turkish_Trustworthyman · Ukrainian_CalmWoman · Ukrainian_WiseScholar · Vietnamese_Serene_Man · Vietnamese_female_4_v1 · Vietnamese_male_1_v2 · Vietnamese_kindhearted_girl · Thai_Optimistic_girl · Thai_male_1_sample8 · Thai_Tender_Woman · Thai_male_2_sample2 · Thai_female_1_sample1 · Thai_female_2_sample2 · Polish_male_1_sample4 · Polish_male_2_sample3 · Polish_female_1_sample1 · Polish_female_2_sample3 · Romanian_male_1_sample2 · Romanian_male_2_sample1 · Romanian_female_1_sample4 · Romanian_female_2_sample1 · Greek_female_1_sample1 · greek_male_1a_v1 · Greek_female_2_sample3 · czech_male_1_v1 · czech_female_5_v7 · czech_female_2_v2 · finnish_male_3_v1 · finnish_female_4_v1 · finnish_male_1_v2 · hindi_male_1_v2 · hindi_female_2_v1 · hindi_female_1_v2 · Bulgarian_male_2_v1 · Bulgarian_female_1_v1 · Danish_male_1_v1 · Danish_female_1_v1 · Hebrew_male_1_v1 · Hebrew_female_1_v1 · Malay_male_1_v1 · Malay_female_1_v1 · Malay_female_2_v1 · Persian_male_1_v1 · Persian_female_1_v1 · Slovak_male_1_v1 · Slovak_female_1_v1 · Swedish_male_1_v1 · Swedish_female_1_v1 · Croatian_male_1_v1 · Croatian_female_1_v1 · Filipino_male_1_v1 · Filipino_female_1_v1 · Hungarian_male_1_v1 · Hungarian_female_1_v1 · Norwegian_male_1_v1 · Norwegian_female_1_v1 · Slovenian_male_1_v1 · Slovenian_female_1_v2 · Catalan_male_1_v1 · Catalan_female_1_v1 · Nynorsk_male_1_v1 · Nynorsk_female_1_v1 · Tamil_male_1_v1 · Tamil_female_1_v1 · Afrikaans_male_1_v1 · Afrikaans_female_1_v1 · Chinese (Mandarin)_Sincere_Adult · 默认值: Calm_Woman |
sample_rate | 否 | Sample rate in Hz. The model uses 32000 when omitted. 8000 · 16000 · 22050 · 24000 · 32000 · 44100 |
output_format | 否 | 结果的文件格式。 mp3 · wav · flac · pcm · 默认值: mp3 |
audio_channels | 否 | Mono or stereo output. Mono when omitted. mono · stereo |
pronunciation_dict | 否 | Custom pronunciations: each alias in the text is read as its pronunciation. |
english_normalization | 否 | Read numbers, dates and abbreviations in English text the way a person would say them. 默认值: false |
价格
价格以积分计,和网站上用的是同一种积分(1 积分 = $0.01)。任务受理时先冻结积分,完成后按实际费用结算;失败的任务会退还。
| 选项 | 积分 /1,000 字符 | ≈ 美元 |
|---|---|---|
| 标准 | 10.8 | US$0.11 |
每个任务按整数积分向上取整,所以最低档跑一次是 11 积分/1,000 字符(US$0.11)。
想在运行前知道确切金额,把同样的请求体发到 POST /jobs/quote 即可。
API 快速上手
三步调用 MiniMax Speech 2.8 Turbo API
- 创建 API 密钥. 登录 PopNow,在 API 控制台创建密钥。密钥以 sk-popnow- 开头,和网站共用同一份积分。
- 发送请求. 向 POST /jobs/createTask 发请求,model 填 minimax/speech-2.8-turbo/text-to-speech,input 按参数表填写。响应会立刻返回任务 ID。
- 取回结果. 用任务 ID 轮询 GET /jobs/recordInfo,或者传 callBackUrl,结果会推送到这个地址。任务成功后下载输出链接。
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "minimax/speech-2.8-turbo/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download.",
"voice_id": "Calm_Woman",
"emotion": "neutral",
"language": "auto",
"output_format": "mp3"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"请把提示词和链接换成你自己的。API 页签里有响应、轮询和回调的参考。
MiniMax Speech 2.8 Turbo API 常见问题
MiniMax Speech 2.8 Turbo API 怎么收费?
MiniMax Speech 2.8 Turbo:11 积分(US$0.11)/1,000 字符。积分和网站通用(1 积分 = $0.01),新账号赠送 30 积分,失败的任务会退还。
MiniMax Speech 2.8 Turbo 在 API 里的调用名是什么?
在 POST /jobs/createTask 的 model 字段里填 文字转语音用 minimax/speech-2.8-turbo/text-to-speech。
MiniMax Speech 2.8 Turbo API 有哪些限制?
文本长度(字符):5,000;音色:473;语言:40。超出这些限制的请求会在扣费之前被拒绝。
不写代码能试 MiniMax Speech 2.8 Turbo 吗?
可以。Playground 用你的 PopNow 积分运行 MiniMax Speech 2.8 Turbo,不需要 API 密钥,每次运行都会给出对应的代码。
全部 MiniMax 模型
MiniMax Speech 2.8 HD 音色相同、保真度更高,适合最终的旁白成品。
- MiniMax H3 API表现力强的带声视频,最高 2K28 积分起 / 5 秒视频
- MiniMax Speech 2.8 HD API高保真语音,400 多种音色,可控情绪18 积分起 /1,000 字符
- MiniMax Music 3.0 API立体声完整成曲,可带人声也可纯音乐27 积分起 /次
- MiniMax H3 Singularity LoRA API社区调校的 H3 视频,可加载你自己的 LoRA45 积分起 / 5 秒视频
- MiniMax H3 Max API出片快,自带环境声、音效和配乐38 积分起 / 5 秒视频
- MiniMax H3 LoRA APIMiniMax H3 带声视频,最多挂三个你自己的 LoRA38 积分起 / 5 秒视频
- MiniMax H3 Image LoRA APIH3 出图和改图,最多挂三个你自己的 LoRA7 积分起 /张
- MiniMax Speech 2.8 Turbo API快速语音合成,400 多种音色,可控情绪11 积分起 /1,000 字符


