MiniMax: Speech 2.6 HD
Speech 2.6 HD je model MiniMax na prevod textu na reč, ktorý premieňa dokončený text na zvuk. Edícia minimax/speech-2.6-hd sprístupňuje nastavenia hlasu, prednesu a zvukového formátu s úplnou odpoveďou JSON a výberom zvukového výstupu vo forme URL alebo hexadecimálnych údajov. Použite ju na nahovorenie dodaného rozprávania, výučbovej pasáže alebo sprievodcu produktom.
O modeli
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
Speech 2.6 HD je presná edícia reči MiniMax vybraná pomocou model: "minimax/speech-2.6-hd". Použite POST /v1/audio/speech s telom application/json obsahujúcim model a text, ktorý sa má vysloviť. Vstupom je písomný text na nahovorenie a výsledkom syntetizovaný zvuk. Pri výučbovej pasáži pripravte presné vysvetlenie a príklady, ktoré sa majú čítať nahlas. Pri sprievodcovi produktom napíšte hovorený sled v rovnakom poradí ako viditeľné kroky. Text rozprávania môže obsahovať úplné vety a zámernú interpunkciu; redakčné pokyny, ktoré majú zostať nevyslovené, ponechajte mimo text.
Pole text nesmie byť prázdne a musí obsahovať menej než 10 000 znakov Unicode. Odošlite úplný text na nahovorenie so stream:false alebo stream vynechajte. Dlhšie podklady rozdeľte na samostatné úplné textové úseky pred odoslaním každého z nich. Dokument možno použiť načítaním jeho skutočného obsahu a vložením príslušnej pasáže do text; URL dokumentu nenahrádza text na nahovorenie.
Hlas vyberte cez voice_setting.voice_id. Zdokumentované kategórie hlasov zahŕňajú systémové hlasy a už vytvorené klonované hlasy alebo hlasy navrhnuté z textu; pre vybranú kategóriu použite platné ID hlasu. Hlas v príklade je audiobook_male_1. Ten istý objekt ovláda speed od 0,5 do 2, vol nad 0 a najviac 10 a celočíselné pitch od -12 do 12. Ich predvolené hodnoty sú 1, 1 a 0. Tieto nastavenia upravujú rôzne aspekty hovoreného prednesu, preto ich vyberajte samostatne namiesto vkladania ich názvov do textu na nahovorenie.
voice_setting.emotion prijíma happy, sad, angry, fearful, disgusted, surprised, calm a fluent. Dokumentácia opisuje aj automatické prispôsobenie emócie podľa textu. Pri textoch s množstvom čísel voice_setting.text_normalization zapína normalizáciu čínskeho a anglického textu a má predvolenú hodnotu false. voice_setting.latex_read ovláda čítanie výrazov LaTeX a tiež má predvolenú hodnotu false. pronunciation_dict.tone je pole reťazcov s pravidlami výslovnosti. Zverejnený príklad je ["草地/(cao3)(di1)"]; pri zadávaní pravidla zachovajte slovo, lomku a štruktúru výslovnosti v zátvorkách.
audio_setting.format prijíma mp3, pcm, flac a wav, s predvolenou hodnotou mp3. sample_rate prijíma 8000, 16000, 22050, 24000, 32000 a 44100 Hz; jeho predvolená hodnota je 32000. channel je 1 pre mono alebo 2 pre dva kanály, s predvolenou hodnotou 1. Hodnoty bitrate sú 32000, 64000, 128000 a 256000 bitov za sekundu, s predvolenou hodnotou 128000, a vzťahujú sa na mp3. Vyberte kódovanie potrebné pre prehrávač alebo nástroj na úpravy, ktorý výsledok použije.
language_boost je voliteľný reťazec s predvolenou hodnotou null. Jeho povolené hodnoty sú 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 a auto. "Chinese,Yue" je jedna hodnota. Ide o samostatné nastavenie oddelené od textu na nahovorenie a ID hlasu. Schéma sprístupňuje aj timber_weights pre zoznam dvojíc voice_id a celočíselnej váhy, pričom každá váha je od 1 do 100. Pri príprave požiadavky zachovajte zápis parametra timber_weights. voice_modify.sound_effects je voliteľný reťazec s hodnotami spacious_echo, auditorium_echo, lofi_telephone a robotic.
stream má predvolenú hodnotu false. Pri úplnej odpovedi output_format vyberá url alebo hex a má predvolenú hodnotu hex. V zdokumentovanom výsledku JSON nesie data.audio vybranú reprezentáciu: stiahnite úplnú podpísanú URL Ailoot vrátane reťazca dopytu alebo dekódujte úplný hexadecimálny zvuk na bajty. Uchovajte pôvodný výsledok spolu s data.status, base_resp, trace_id a extra_info, ktoré obsahuje skutočný zvukový formát, vzorkovaciu frekvenciu, počet kanálov, veľkosť a usage_characters.
subtitle_enable je booleovská hodnota s predvolenou hodnotou false a vzťahuje sa na výstup bez priebežného doručovania. aigc_watermark je booleovská hodnota s predvolenou hodnotou false a ovláda počuteľnú rytmickú značku na konci generovaného zvuku. Uchovajte všetky vrátené zvukové výsledky alebo titulky a pred zaradením do aplikácie skontrolujte výslovnosť, čísla a dokončený súbor. Ak je doručenie neisté, uchovajte pôvodný identifikátor požiadavky a odpoveď na kontrolu existujúceho pokusu. Ailoot tiež ukladá dokončený zvuk vo vašej knižnici médií. Pri output_format:"url" obsahuje data.audio podpísaný odkaz na tento uložený súbor; ID súboru sa nachádza v jeho ceste /v1/media/assets/{asset_id}/content. Podpísané odkazy na súbory Ailoot platia 24 hodín od vydania. Pomocou rovnakého kľúča API vykonajte GET /v1/media/assets?family=audio a prejdite každú hodnotu next_cursor, aby ste našli záznamy zvukových súborov. Pre každý vybraný záznam načítajte GET /v1/media/assets/{asset_id} a stiahnite jeho presné content_url vrátane reťazca dopytu. Ak požiadavka na súbor vráti 404 s kódom link_expired, načítajte ten istý súbor znova a získajte obnovené content_url. Obnovte uložený výsledok namiesto opätovného generovania zvuku na nahradenie odkazu s uplynutou platnosťou.
Ailoot Ultra · Speech POST /v1/audio/speech minimax/speech-2.6-hd
minimax/speech-2.6-hdÚvod
Speech 2.6 HD je model MiniMax na prevod textu na reč, ktorý premieňa dokončený text na zvuk. Edícia minimax/speech-2.6-hd sprístupňuje nastavenia hlasu, prednesu a zvukového formátu s úplnou odpoveďou JSON a výberom zvukového výstupu vo forme URL alebo hexadecimálnych údajov. Použite ju na nahovorenie dodaného rozprávania, výučbovej pasáže alebo sprievodcu produktom.
- Povolené vstupy
- Text
- Výsledky
- Audio
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · Speech POST /v1/audio/speech
- Vstup
text- Výstup
audio- Výstupný formát
- mp3,pcm,flac,wav
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity minimax/speech-2.6-hd | Predvolené— |
Poletext | Typstring | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Polestream | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity false | Predvolenéfalse |
Polevoice_setting | Typobject | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polevoice_setting.voice_id | Typstring | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polevoice_setting.speed | Typnumber | PožiadavkaVoliteľné | Hodnoty a limity Minimum: 0,5 Maximum: 2 | Predvolené1 |
Polevoice_setting.vol | Typnumber | PožiadavkaVoliteľné | Hodnoty a limity Minimum: 0 Maximum: 10 | Predvolené1 |
Polevoice_setting.pitch | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Minimum: -12 Maximum: 12 | Predvolené0 |
Polevoice_setting.emotion | Typstring | PožiadavkaVoliteľné | Hodnoty a limity happy, sad, angry, fearful, disgusted, surprised, calm, fluent | Predvolené— |
Polevoice_setting.text_normalization | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity | Predvolenéfalse |
Polevoice_setting.latex_read | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity | Predvolenéfalse |
Poleaudio_setting | Typobject | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Poleaudio_setting.sample_rate | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity 8 000, 16 000, 22 050, 24 000, 32 000, 44 100 | Predvolené32 000 |
Poleaudio_setting.bitrate | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity 32 000, 64 000, 128 000, 256 000 | Predvolené128 000 |
Poleaudio_setting.format | Typstring | PožiadavkaVoliteľné | Hodnoty a limity mp3, pcm, flac, wav | Predvolenémp3 |
Poleaudio_setting.channel | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity 1, 2 | Predvolené1 |
Poleaudio_setting.force_cbr | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity | Predvolenéfalse |
Polepronunciation_dict | Typobject | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polepronunciation_dict.tone | Typarray | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Poletimber_weights | Typarray | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polelanguage_boost | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 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 | Predvolené— |
Polevoice_modify | Typobject | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polevoice_modify.pitch | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity -100, 100 | Predvolené— |
Polevoice_modify.intensity | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity -100, 100 | Predvolené— |
Polevoice_modify.timbre | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity -100, 100 | Predvolené— |
Polevoice_modify.sound_effects | Typstring | PožiadavkaVoliteľné | Hodnoty a limity spacious_echo, auditorium_echo, lofi_telephone, robotic | Predvolené— |
Polesubtitle_enable | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity | Predvolenéfalse |
Poleoutput_format | Typstring | PožiadavkaVoliteľné | Hodnoty a limity url, hex | Predvolenéhex |
Poleaigc_watermark | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity | Predvolenéfalse |
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, text |
Parameteroptional | Špecifikáciastream, voice_setting, audio_setting, pronunciation_dict, timber_weights, language_boost, voice_modify, subtitle_enable, output_format, aigc_watermark |
Parametermaterial_types | Špecifikáciatext |
Parameterconditions | ŠpecifikáciaUse 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. |
Životný cyklus: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Cenník
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
- Rýchly režim
- Neuvedené Keď je zvolený rýchly režim
- Režim Flex
- Neuvedené Keď je zvolený režim flex
- Maximálna úroveň uvažovania
- Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Sadzby Ailoot
Ceny podľa konfigurácie
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Sadzobník | Účtovacia jednotka | Poplatok |
|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Účtovacia jednotka— | Poplatok Vstup · Vstupné tokeny — / 1K tokenov Výstup · Výstupné tokeny — / 1K tokenov Vstup · Čítanie cache — / 1K tokenov Vstup · Zápis do cache — / 1K tokenov Vstup · Zápis do cache, 1 hod — / 1K tokenov |
| Konfiguráciavstupný znak | Sadzobník— | Účtovacia jednotkaza vstupný znak | Poplatok Vstup · vstupný znak $0.0002 za vstupný znak |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Príklady požiadaviek
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-2.6-hd", "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.
Prijať a uložiť výsledky
Ailoot Ultra · Speech
mp3,pcm,flac,wav
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Uchovať všetky dokončené výsledky
Uložte každú úplnú vrátenú odpoveď, súbor a časť obsahu.
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.
Ak treba overiť pôvodnú odpoveď
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Polia odpovede
| Pole | Typ |
|---|---|
Poledata.audio | Typstring |
Poleextra_info | Typobject |
Poletrace_id | Typstring |
Aliasy
Aliasy modelov
Ailoot Ultra minimax/speech-2.6-hd
Aliasy ciest metód
Použite cesty metód uvedené vyššie.
Súvisiace ID na volanie
FAQ · MiniMax: Speech 2.6 HD
- Aké vstupy a výsledky sú dostupné?
POST /v1/audio/speech·minimax/speech-2.6-hd:text→audio- Aké polia používa požiadavka?
POST /v1/audio/speech·minimax/speech-2.6-hd:model,text,stream,voice_setting,audio_setting,pronunciation_dict,timber_weights,language_boost,voice_modify,subtitle_enable,output_format,aigc_watermark- Aké limity platia?
POST /v1/audio/speech·minimax/speech-2.6-hd: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