MiniMax: Speech 02 Turbo
Speech 02 Turbo — дайын сценарийді дыбысқа айналдыруға арналған MiniMax мәтінді дыбыстау моделі. minimax/speech-02-turbo нұсқасы толық JSON жауабымен және URL немесе он алтылық дыбыс шығысын таңдаумен дауыс, жеткізу мәнері және дыбыс пішімі параметрлерін ұсынады. Оны дайын хабарландыруды, өнім түсіндірмесін немесе баяндау сценарийін дыбыстық сөйлеуге айналдыру үшін пайдаланыңыз.
Модель туралы
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
Speech 02 Turbo — model: "minimax/speech-02-turbo" арқылы таңдалатын дәл MiniMax сөйлеу нұсқасы. model және айтылатын мәтін бар application/json денесімен POST /v1/audio/speech сұрауын пайдаланыңыз. Оның кірісі — жазбаша сценарий, нәтижесі — синтезделген дыбыс. Хабарландыру үшін text ішіне қысқа алып кету туралы хабарлама сияқты тек айтылуға тиіс сөздерді салыңыз. Өнімді түсіндіру үшін дыбыс жасамас бұрын сценарийді толық сөйлемдерге бөліп, өнім атаулары мен сандарын нақтылаңыз. Үнсіз қалуға тиіс өндірістік ескертпелерді, файл атауларын және бағыттарды айтылатын сценарийден тыс ұстаңыз.
text өрісі бос болмауы және 10 000 Unicode таңбасынан аз болуы тиіс. Толық айтылатын сценарийді stream:false арқылы жіберіңіз немесе stream қоспаңыз. Ұзақ материалды әр бөлігін жібермес бұрын бөлек толық сценарий үзінділеріне бөліңіз. Құжаттың нақты мазмұнын оқып, тиісті үзіндіні text ішіне орналастыру арқылы оны қолдануға болады; құжат URL мекенжайы сценарийдің орнын баспайды.
Дауысты voice_setting.voice_id арқылы таңдаңыз. Құжатталған дауыс санаттарына жүйелік дауыстар және бұрын жасалған клондалған не мәтіннен жобаланған дауыстар кіреді; таңдалған санат үшін жарамды дауыс ID мәнін пайдаланыңыз. Мысал дауысы — audiobook_male_1. Сол нысан 0.5 пен 2 аралығындағы speed, 0 мәнінен жоғары және 10 мәніне дейінгі vol, сондай-ақ -12 мен 12 аралығындағы бүтін pitch мәндерін басқарады. Олардың әдепкі мәндері — 1, 1 және 0. Бұл параметрлер сөйлеу мәнерінің әртүрлі қырларын реттейді, сондықтан олардың атауларын сценарийге жазудың орнына бөлек таңдаңыз.
voice_setting.emotion happy, sad, angry, fearful, disgusted, surprised, calm және fluent мәндерін қабылдайды. Құжаттама мәтіннен эмоцияны автоматты сәйкестендіруді де сипаттайды. Сандары көп сценарийлер үшін voice_setting.text_normalization қытай және ағылшын мәтінін қалыпқа келтіруді қосады, әдепкі мәні — false. voice_setting.latex_read LaTeX өрнектерін оқуды басқарады және оның да әдепкі мәні false болады. pronunciation_dict.tone — айтылым ережелері жолдарының массиві. Жарияланған мысал — ["草地/(cao3)(di1)"]; ереже бергенде сөзді, қиғаш сызықты және жақша ішіндегі айтылым құрылымын сақтаңыз.
audio_setting.format mp3, pcm, flac және wav қабылдайды, әдепкі мәні — mp3. sample_rate 8000, 16000, 22050, 24000, 32000 және 44100 Hz қабылдайды; әдепкі мәні — 32000. channel моно үшін 1 немесе екі арна үшін 2 болады, әдепкі мәні — 1. bitrate мәндері — секундына 32000, 64000, 128000 және 256000 бит, әдепкі мәні — 128000, олар mp3 үшін қолданылады. Нәтижені пайдаланатын ойнатқышқа немесе өңдеу құралына қажет кодтауды таңдаңыз.
language_boost — қосымша жол, әдепкі мәні — null. Оның рұқсат етілген мәндері: Chinese, Chinese,Yue, 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. "Chinese,Yue" — бір мән. Бұл — сценарий мен дауыс ID мәнінен бөлек параметр. Схема voice_id және бүтін weight жұптарының тізімі үшін timber_weights параметрін де ұсынады, әр weight 1 мен 100 аралығында болады. Сұрауды дайындағанда timber_weights параметрінің жазылуын сақтаңыз. voice_modify.sound_effects — spacious_echo, auditorium_echo, lofi_telephone және robotic мәндері бар қосымша жол.
stream әдепкіде false болады. Толық жауап үшін output_format url немесе hex таңдайды, әдепкі мәні — hex. Құжатталған JSON нәтижесінде data.audio таңдалған түрді тасымалдайды: қолтаңбаланған Ailoot URL мекенжайын сұрау жолымен бірге толық жүктеп алыңыз немесе толық он алтылық дыбысты байттарға декодтаңыз. Бастапқы нәтижені data.status, base_resp, trace_id және нақты дыбыс пішімі, дискреттеу жиілігі, арна саны, көлемі мен usage_characters қамтылған extra_info мәндерімен бірге сақтаңыз.
subtitle_enable — әдепкі мәні false болатын және ағынсыз шығысқа қолданылатын логикалық параметр. aigc_watermark — әдепкі мәні false болатын, генерацияланған дыбыстың соңындағы естілетін ырғақ белгісін басқаратын логикалық параметр. Қайтарылған әр дыбыс не субтитр нәтижесін сақтап, қолданбаға орналастырмас бұрын айтылымды, сандарды және дайын файлды тексеріңіз. Жеткізу белгісіз болса, бар әрекетті тексеру үшін бастапқы сұрау сәйкестендіргішін және жауапты сақтаңыз. Ailoot дайын дыбысты медиа кітапханаңызға да сақтайды. output_format:"url" болғанда data.audio ішінде сол сақталған активке қолтаңбаланған сілтеме болады; актив ID мәні оның /v1/media/assets/{asset_id}/content жолында көрінеді. Ailoot қолтаңбаланған файл сілтемелері берілген кезден бастап 24 сағат жарамды. Дыбыс активтерінің жазбаларын табу үшін сол API кілтімен GET /v1/media/assets?family=audio сұрауын пайдаланып, әр next_cursor бойымен өтіңіз. Таңдалған әр жазба үшін GET /v1/media/assets/{asset_id} сұрауын оқып, оның дәл content_url мекенжайын сұрау жолымен бірге жүктеп алыңыз. Файл сұрауы link_expired коды бар 404 қайтарса, жаңартылған content_url алу үшін сол активті қайта оқыңыз. Мерзімі өткен сілтемені алмастыру үшін дыбысты қайта генерацияламай, сақталған нәтижені жаңартыңыз.
Ailoot Ultra · Speech POST /v1/audio/speech minimax/speech-02-turbo
minimax/speech-02-turboБастау
Speech 02 Turbo — дайын сценарийді дыбысқа айналдыруға арналған MiniMax мәтінді дыбыстау моделі. minimax/speech-02-turbo нұсқасы толық JSON жауабымен және URL немесе он алтылық дыбыс шығысын таңдаумен дауыс, жеткізу мәнері және дыбыс пішімі параметрлерін ұсынады. Оны дайын хабарландыруды, өнім түсіндірмесін немесе баяндау сценарийін дыбыстық сөйлеуге айналдыру үшін пайдаланыңыз.
- Қабылданатын кіріс деректері
- Мәтін
- Нәтижелер
- Аудио
Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер
Ailoot Ultra · Speech POST /v1/audio/speech
- Кіріс
text- Шығыс
audio- Шығыс пішімі
- mp3,pcm,flac,wav
| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер minimax/speech-02-turbo | Әдепкі— |
Өрісtext | Түріstring | ТалапМіндетті | Мәндер мен шектеулер | Әдепкі— |
Өрісstream | Түріboolean | ТалапМіндетті емес | Мәндер мен шектеулер false | Әдепкіfalse |
Өрісvoice_setting | Түріobject | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— |
Өрісvoice_setting.voice_id | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— |
Өрісvoice_setting.speed | Түріnumber | ТалапМіндетті емес | Мәндер мен шектеулер Ең азы: 0,5 Ең көбі: 2 | Әдепкі1 |
Өрісvoice_setting.vol | Түріnumber | ТалапМіндетті емес | Мәндер мен шектеулер Ең азы: 0 Ең көбі: 10 | Әдепкі1 |
Өрісvoice_setting.pitch | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер Ең азы: -12 Ең көбі: 12 | Әдепкі0 |
Өрісvoice_setting.emotion | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер happy, sad, angry, fearful, disgusted, surprised, calm, fluent | Әдепкі— |
Өрісvoice_setting.text_normalization | Түріboolean | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкіfalse |
Өрісvoice_setting.latex_read | Түріboolean | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкіfalse |
Өрісaudio_setting | Түріobject | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— |
Өрісaudio_setting.sample_rate | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер 8 000, 16 000, 22 050, 24 000, 32 000, 44 100 | Әдепкі32 000 |
Өрісaudio_setting.bitrate | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер 32 000, 64 000, 128 000, 256 000 | Әдепкі128 000 |
Өрісaudio_setting.format | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер mp3, pcm, flac, wav | Әдепкіmp3 |
Өрісaudio_setting.channel | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер 1, 2 | Әдепкі1 |
Өрісaudio_setting.force_cbr | Түріboolean | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкіfalse |
Өрісpronunciation_dict | Түріobject | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— |
Өрісpronunciation_dict.tone | Түріarray | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— |
Өрісtimber_weights | Түріarray | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— |
Өрісlanguage_boost | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Chinese, Chinese,Yue, 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 | Әдепкі— |
Өрісvoice_modify | Түріobject | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— |
Өрісvoice_modify.pitch | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер -100, 100 | Әдепкі— |
Өрісvoice_modify.intensity | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер -100, 100 | Әдепкі— |
Өрісvoice_modify.timbre | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер -100, 100 | Әдепкі— |
Өрісvoice_modify.sound_effects | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер spacious_echo, auditorium_echo, lofi_telephone, robotic | Әдепкі— |
Өрісsubtitle_enable | Түріboolean | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкіfalse |
Өрісoutput_format | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер url, hex | Әдепкіhex |
Өрісaigc_watermark | Түріboolean | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкіfalse |
Әдіс параметрлері мен өмірлік циклі
| Параметр | Параметр талаптары |
|---|---|
Параметрcontent_type | Параметр талаптарыapplication/json |
Параметрrequired | Параметр талаптарыmodel, text |
Параметрoptional | Параметр талаптарыstream, voice_setting, audio_setting, pronunciation_dict, timber_weights, language_boost, voice_modify, subtitle_enable, output_format, aigc_watermark |
Параметрmaterial_types | Параметр талаптарыtext |
Параметрconditions | Параметр талаптарыUse text, not input or contents. Fewer than 10000 Unicode characters; stream is false or omitted., PCM is raw audio with its returned sample geometry; do not invent a WAV header or bit depth. |
Өмірлік цикл: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Тарифтер
Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.
- Жылдам режим
- Көрсетілмеген Жылдам режим таңдалғанда
- Икемді режим
- Көрсетілмеген flex режимі таңдалғанда
- Ой қорытудың ең жоғары деңгейі
- Көрсетілмеген Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда
Ailoot мөлшерлемелері
Баптаулар бойынша бағалар
Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.
| Баптау | Мөлшерлемелер кестесі | Есептеу бірлігі | Төлем |
|---|---|---|---|
| БаптауТокендердің базалық тарифтері | Мөлшерлемелер кестесіНегізгі мөлшерлеме | Есептеу бірлігі— | Төлем Кіріс · Кіріс токендері — / 1K токен Шығыс · Шығыс токендері — / 1K токен Кіріс · Кэшті оқу — / 1K токен Кіріс · Кэшке жазу — / 1K токен Кіріс · Кэшке жазу, 1 сағ — / 1K токен |
| Баптаукіріс таңбасы | Мөлшерлемелер кестесі— | Есептеу бірлігікіріс таңбасы үшін | Төлем Кіріс · кіріс таңбасы $0.00012 кіріс таңбасы үшін |
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
Сұрау мысалдары
Ailoot Ultra · Speech
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "minimax/speech-02-turbo", "text": "Hello, this is a short speech example.", "stream": false, "output_format": "hex", "audio_setting": {"format": "mp3", "sample_rate": 32000, "channel": 1}}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/audio/speech \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Нәтижелерді алу және сақтау
Ailoot Ultra · Speech
mp3,pcm,flac,wav
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Барлық дайын нәтижені сақтау
Қайтарылған әр толық жауапты, файлды және мазмұн бөлігін сақтаңыз.
Retain the full JSON. Decode every hex audio byte or use the returned owned URL. Keep the actual format, sample rate, channel count and usage_characters.
Бастапқы жауапты тексеру қажет болса
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Жауап өрістері
| Өріс | Түрі |
|---|---|
Өрісdata.audio | Түріstring |
Өрісextra_info | Түріobject |
Өрісtrace_id | Түріstring |
Балама атаулар
Модельдердің балама атаулары
Ailoot Ultra minimax/speech-02-turbo
Әдіс жолдарының балама атаулары
Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.
Шақыруға арналған байланысты ID
FAQ · MiniMax: Speech 02 Turbo
- Қандай кіріс деректері мен нәтижелер қолжетімді?
POST /v1/audio/speech·minimax/speech-02-turbo:text→audio- Сұрау қандай өрістерді пайдаланады?
POST /v1/audio/speech·minimax/speech-02-turbo:model,text,stream,voice_setting,audio_setting,pronunciation_dict,timber_weights,language_boost,voice_modify,subtitle_enable,output_format,aigc_watermark- Қандай шектеулер қолданылады?
POST /v1/audio/speech·minimax/speech-02-turbo:voice_setting.speed.minimum:0.5;voice_setting.speed.maximum:2;voice_setting.vol.minimum:0;voice_setting.vol.maximum:10;voice_setting.pitch.minimum:-12;voice_setting.pitch.maximum:12