Por ahora esta guía solo está en inglés. →
Parámetros de la petición
| Parámetro | Obligatorio | Descripción |
|---|---|---|
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 · Por defecto: 0 |
speed | No | Ritmo al hablar. ≥ 0.5 · ≤ 2 · Por defecto: 1 |
volume | No | Loudness multiplier; 1 is the normal level. ≥ 0.1 · ≤ 10 · Por defecto: 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 | El tono emocional de la lectura. neutral · happy · sad · angry · fearful · disgusted · surprised · Por defecto: neutral |
language | No | El idioma de la locución. 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 · Por defecto: auto |
voice_id | No | Elige entre las voces disponibles. 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 · Por defecto: 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 de archivo del resultado. mp3 · wav · flac · pcm · Por defecto: 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. Por defecto: false |
Precios
Los precios están en créditos, los mismos que usas en la web (1 crédito = 0,01 $). El importe se retiene cuando se acepta la tarea y se liquida al coste real cuando termina; las tareas fallidas se reembolsan.
| Opción | Créditos por 1.000 caracteres | ≈ USD |
|---|---|---|
| Estándar | 18 | 0,18 US$ |
Para saber la cifra exacta antes de ejecutar, envía el mismo cuerpo a POST /jobs/quote.
Inicio rápido de la API
Llama a la API de MiniMax Speech 2.8 HD en tres pasos
- Crea una clave de API. Inicia sesión en PopNow y crea una clave en la consola de la API. Las claves empiezan por sk-popnow- y usan los mismos créditos que el sitio web.
- Envía la solicitud. Haz POST /jobs/createTask con model minimax/speech-2.8-hd/text-to-speech y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
- Obtén el resultado. Consulta GET /jobs/recordInfo con el ID de tarea, o pasa una callBackUrl y te enviamos el resultado ahí. Descarga los enlaces de salida cuando la tarea termine bien.
# 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-hd/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"Sustituye el prompt y los enlaces por los tuyos. La pestaña API tiene la referencia de la respuesta, el sondeo y el callback.
Preguntas sobre la API de MiniMax Speech 2.8 HD
¿Cuánto cuesta la API de MiniMax Speech 2.8 HD?
MiniMax Speech 2.8 HD cuesta 18 créditos (0,18 US$) por 1.000 caracteres. Los créditos son los mismos que en la web (1 crédito = 0,01 $), las cuentas nuevas reciben 30 créditos gratis y las tareas fallidas se reembolsan.
¿Cuál es el nombre de modelo de MiniMax Speech 2.8 HD en la API?
Pon minimax/speech-2.8-hd/text-to-speech para Texto a voz en el campo model de POST /jobs/createTask.
¿Cómo controlo la voz y la emoción?
Elige una de 472 voces del sistema con voice_id y una de siete emociones con emotion: neutral, happy, sad, angry, fearful, disgusted o surprised. Las etiquetas de sonido entre paréntesis como (sighs) o (laughs) en el texto se interpretan como sonido, no se leen en voz alta.
¿Qué idiomas lee?
Detecta el idioma del guion automáticamente. También puedes usar language para indicar uno de 40 idiomas, entre ellos mandarín, cantonés, inglés, árabe, ruso, español, francés, portugués, alemán, japonés y coreano, cuando un guion corto o mixto necesita ayuda con la pronunciación.
¿Puede copiar la voz de una persona real?
No. Este endpoint solo ofrece las 472 voces del sistema; no hay clonación ni carga de una voz de referencia.
¿Qué límites tiene la API de MiniMax Speech 2.8 HD?
Longitud del texto (caracteres): 5,000; Voces: 473; Idiomas: 40. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.
¿Puedo probar MiniMax Speech 2.8 HD sin escribir código?
Sí. El Playground ejecuta MiniMax Speech 2.8 HD con tus créditos de PopNow, no necesita clave API y te muestra el código de cada generación.
Todos los modelos de MiniMax
- API de MiniMax H3Clips expresivos con audio, hasta 2KDesde 28 créditos por un clip de 5 segundos
- API de MiniMax Speech 2.8 HDVoz de alta fidelidad con más de 400 voces y control emocionalDesde 18 créditos por 1.000 caracteres
- API de MiniMax Music 3.0Canciones estéreo terminadas, con voz o instrumentalesDesde 27 créditos por generación
- API de MiniMax H3 Singularity LoRAVideo H3 ajustado por la comunidad que carga tus LoRADesde 45 créditos por un clip de 5 segundos
- API de MiniMax H3 MaxClips rápidos con ambiente, efectos y músicaDesde 38 créditos por un clip de 5 segundos
- API de MiniMax H3 LoRAVideo MiniMax H3 con sonido y hasta tres de tus LoRADesde 38 créditos por un clip de 5 segundos
- API de MiniMax H3 Image LoRAImágenes y ediciones con H3 y hasta tres de tus LoRADesde 7 créditos por imagen
- API de MiniMax Speech 2.8 TurboVoz rápida con más de 400 voces y control emocionalDesde 11 créditos por 1.000 caracteres


