Per ora questa guida è solo in inglese. →
Parametri della richiesta
| Parametro | Obbligatorio | Descrizione |
|---|---|---|
text | Sì | The words to be spoken, exactly as written. Sound tags such as (sighs) or (laughs) are performed. |
pitch | No | Pitch shift in semitones; 0 keeps the voice's own pitch. ≥ -12 · ≤ 12 · Predefinito: 0 |
speed | No | Velocità del parlato. ≥ 0.5 · ≤ 2 · Predefinito: 1 |
volume | No | Loudness multiplier; 1 is the normal level. ≥ 0.1 · ≤ 10 · Predefinito: 1 |
bitrate | No | MP3 bitrate in bits per second; ignored for other formats. The model uses 128000 when omitted. 32000 · 64000 · 128000 · 256000 |
emotion | No | Il tono emotivo della lettura. neutral · happy · sad · angry · fearful · disgusted · surprised · Predefinito: neutral |
language | No | La lingua del parlato. 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 · Predefinito: auto |
voice_id | No | Scegli tra le voci disponibili. 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 · Predefinito: Calm_Woman |
sample_rate | No | Sample rate in Hz. The model uses 32000 when omitted. 8000 · 16000 · 22050 · 24000 · 32000 · 44100 |
output_format | No | Tipo di file del risultato. mp3 · wav · flac · pcm · Predefinito: mp3 |
audio_channels | No | Mono or stereo output. Mono when omitted. mono · stereo |
pronunciation_dict | No | Custom pronunciations: each alias in the text is read as its pronunciation. |
english_normalization | No | Read numbers, dates and abbreviations in English text the way a person would say them. Predefinito: false |
Prezzi
I prezzi sono in crediti, gli stessi che usi sul sito (1 credito = 0,01 $). L'importo viene trattenuto quando il task è accettato e regolato sul costo reale al termine; i task falliti vengono rimborsati.
| Opzione | Crediti ogni 1.000 caratteri | ≈ USD |
|---|---|---|
| Standard | 10,8 | 0,11 USD |
Ogni attività è arrotondata per eccesso ai crediti interi, quindi un'esecuzione al livello più basso costa 11 crediti ogni 1.000 caratteri (0,11 USD).
Per avere la cifra esatta prima di eseguire, invia lo stesso body a POST /jobs/quote.
Guida rapida all'API
Chiama l'API di MiniMax Speech 2.8 Turbo in tre passaggi
- Crea una chiave API. Accedi a PopNow e crea una chiave nella console API. Le chiavi iniziano con sk-popnow- e usano gli stessi crediti del sito.
- Invia la richiesta. Invia POST /jobs/createTask con model minimax/speech-2.8-turbo/text-to-speech e un oggetto input secondo la tabella dei parametri. La risposta restituisce subito un ID attività.
- Recupera il risultato. Interroga GET /jobs/recordInfo con l'ID attività, oppure passa una callBackUrl e ti inviamo lì il risultato. Scarica i link di output quando l'attività riesce.
# 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"Sostituisci il prompt e gli eventuali link con i tuoi. La scheda API contiene il riferimento per risposta, polling e callback.
Domande sull’API di MiniMax Speech 2.8 Turbo
Quanto costa l’API di MiniMax Speech 2.8 Turbo?
MiniMax Speech 2.8 Turbo costa 11 crediti (0,11 USD) ogni 1.000 caratteri. I crediti sono gli stessi del sito (1 credito = 0,01 $), i nuovi account ricevono 30 crediti gratuiti e i task falliti vengono rimborsati.
Qual è il nome del modello di MiniMax Speech 2.8 Turbo nell’API?
Inserisci minimax/speech-2.8-turbo/text-to-speech per Sintesi vocale nel campo model di POST /jobs/createTask.
Come controllo voce ed emozione?
Scegli una delle 472 voci di sistema con voice_id e una delle sette emozioni con emotion — neutral, happy, sad, angry, fearful, disgusted o surprised. I tag sonori tra parentesi come (sighs) o (laughs) inseriti nel testo vengono interpretati come suoni, non letti ad alta voce.
Quali lingue legge?
Rileva automaticamente la lingua dello script. Puoi anche usare language per indicare una delle 40 lingue supportate, tra cui mandarino, cantonese, inglese, arabo, russo, spagnolo, francese, portoghese, tedesco, giapponese e coreano, quando uno script breve o misto ha bisogno di aiuto con la pronuncia.
Può copiare la voce di una persona reale?
No. Su questo endpoint sono disponibili solo le 472 voci di sistema; non è previsto alcun clonaggio né il caricamento di una voce di riferimento.
Quali sono i limiti dell’API di MiniMax Speech 2.8 Turbo?
Lunghezza del testo (caratteri): 5,000; Voci: 473; Lingue: 40. Le richieste fuori da questi limiti vengono rifiutate prima di qualsiasi addebito.
Posso provare MiniMax Speech 2.8 Turbo senza scrivere codice?
Sì. Il Playground esegue MiniMax Speech 2.8 Turbo con i tuoi crediti PopNow, non richiede una chiave API e mostra il codice di ogni generazione.
Tutti i modelli MiniMax
MiniMax Speech 2.8 HD usa le stesse voci con maggiore fedeltà, per narrazioni finite.
- API di MiniMax H3Clip espressive con audio, fino al 2KDa 28 crediti per una clip di 5 secondi
- API di MiniMax Speech 2.8 HDVoce ad alta fedeltà, oltre 400 voci con controllo delle emozioniDa 18 crediti ogni 1.000 caratteri
- API di MiniMax Music 3.0Brani stereo finiti, cantati o strumentaliDa 27 crediti per generazione
- API di MiniMax H3 Singularity LoRAVideo H3 ottimizzato dalla community che carica le tue LoRADa 45 crediti per una clip di 5 secondi
- API di MiniMax H3 MaxClip veloci con ambiente, effetti e musicaDa 38 crediti per una clip di 5 secondi
- API di MiniMax H3 LoRAVideo MiniMax H3 con audio e fino a tre tue LoRADa 38 crediti per una clip di 5 secondi
- API di MiniMax H3 Image LoRAImmagini e modifiche H3 con fino a tre tue LoRADa 7 crediti per immagine
- API di MiniMax Speech 2.8 TurboVoce veloce, oltre 400 voci con controllo delle emozioniDa 11 crediti ogni 1.000 caratteri


