요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
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자 | ≈ USD |
|---|---|---|
| 기본 | 10.8 | US$0.11 |
작업마다 크레딧은 정수로 올림 처리되므로, 가장 낮은 옵션으로 한 번 실행하면 11크레딧/1,000자(US$0.11)입니다.
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
MiniMax Speech 2.8 Turbo API를 3단계로 호출하기
- 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크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 MiniMax Speech 2.8 Turbo의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 텍스트 음성 변환: minimax/speech-2.8-turbo/text-to-speech을(를) 넣으세요.
보이스와 감정은 어떻게 제어합니까?
voice_id로 472종의 시스템 보이스 중 하나를, emotion으로 neutral, happy, sad, angry, fearful, disgusted, surprised 중 하나를 선택합니다. 텍스트에 괄호로 넣은 (sighs)나 (laughs) 같은 사운드 태그는 소리로 연기되며 소리 내어 읽히지 않습니다.
어떤 언어를 읽을 수 있습니까?
대본의 언어는 자동으로 감지됩니다. language를 사용하면 표준 중국어, 광둥어, 영어, 아랍어, 러시아어, 스페인어, 프랑스어, 포르투갈어, 독일어, 일본어, 한국어 등 40개 언어 중 하나를 힌트로 지정할 수 있으며, 짧거나 여러 언어가 섞인 대본의 발음을 보완할 때 유용합니다.
실제 인물의 목소리를 복제할 수 있습니까?
아니요. 이 엔드포인트에서는 472종의 시스템 보이스만 제공되며, 클로닝이나 참조 음성 업로드는 지원하지 않습니다.
MiniMax Speech 2.8 Turbo API의 제한은 무엇인가요?
텍스트 길이(글자): 5,000; 목소리: 473; 언어: 40. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 MiniMax Speech 2.8 Turbo을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 MiniMax Speech 2.8 Turbo을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.
모든 MiniMax 모델
MiniMax Speech 2.8 HD는 같은 목소리를 더 높은 충실도로 쓸 수 있어서 완성본 내레이션에 좋아요.
- MiniMax H3 API표현력 있는 오디오 포함 클립, 최대 2K28크레딧부터 / 5초 영상
- MiniMax Speech 2.8 HD API400가지 이상 목소리의 고음질 음성, 감정 조절18크레딧부터 /1,000자
- MiniMax Music 3.0 API보컬 또는 연주곡으로 완성된 스테레오 곡27크레딧부터 /회
- MiniMax H3 Singularity LoRA API커뮤니티 튜닝 H3 영상, 내 LoRA 불러오기45크레딧부터 / 5초 영상
- MiniMax H3 Max API앰비언스·효과음·음악까지 담은 빠른 클립38크레딧부터 / 5초 영상
- MiniMax H3 LoRA API사운드 포함 MiniMax H3 영상, 내 LoRA 최대 3개38크레딧부터 / 5초 영상
- MiniMax H3 Image LoRA APIH3 스틸과 편집, 내 LoRA 최대 3개7크레딧부터 /장
- MiniMax Speech 2.8 Turbo API400가지 이상 목소리의 빠른 음성, 감정 조절11크레딧부터 /1,000자


