Parametre požiadavky TTS
Na tejto strane
Aktualizované 3. novembra 2026 na základe stránky xAI Text to Speech a referencie Voice API. Zdroje: Text to Speech · Voice API.
Vyladenie syntézy reči
Koncový bod POST /v1/tts sa točí okolo štyroch hlavných parametrov v tele požiadavky JSON plus niekoľkých voliteľných nastavení. Každý z nich ti dáva presnú kontrolu nad generovaným audiom a ich pochopenie ti umožní prispôsobiť syntézu tvojmu použitiu.
Parameter text
Spolu s parametrom language je text jediným povinným parametrom. Prijíma reťazec s dĺžkou až 60 000 znakov, ktorý môže obsahovať prostý text alebo expresívne tagy (tým sa budeme zaoberať v ďalšej časti).
{
"text": "Hello and welcome. Today, we're going to talk about artificial intelligence."
}
Pri prekročení 60 000 znakov bude HTTP požiadavka zamietnutá. Pre dlhšie texty xAI odporúča WebSocket, ktorý nemá žiadny limit celkovej dĺžky (lekcie 9 až 12), alebo rozdelenie textu na segmenty, ktorých audio následne spojíš. Rozdeľuj na prirodzených hraniciach (koniec viet, koniec odsekov), aby si dosiahol plynulý výsledok.
Parameter voice_id
Tento parameter nastavuje hlas použitý na syntézu. Je voliteľný a predvolená hodnota je eve. ID nerozlišujú veľkosť písmen: Eve, EVE a eve sú ekvivalentné.
xAI ponúka 28 vstavaných hlasov (k 3. novembru 2026), rovnako ako pre hlasového agenta, plus vlastné hlasy vytvorené prostredníctvom Custom Voices API. Päť pôvodných hlasov podľa popisu xAI:
- eve: energický a veselý, britský prízvuk
- ara: teplý a priateľský
- rex: sebavedomý a zrozumiteľný
- sal: hladký a vyvážený
- leo: autoritatívny a mocný, britský prízvuk
Zvyšných 23 hlasov (carina, zagan, helix, orion, luna, iris, altair, zenith, perseus, helios, lux, kepler, rigel, cosmo, celeste, ursa, sirius, lumen, castor, naksh, atlas, aurora a liora) je popísaných vrátane ich použitia na stránke xAI Text to Speech; koncový bod GET /v1/tts/voices vráti aktuálny zoznam (lekcia 3).
{
"text": "Welcome to this tutorial.",
"voice_id": "rex",
"language": "en"
}
Podľa xAI každý hlas hovorí všetkými podporovanými jazykmi. Výber hlasu neovplyvňuje cenu, ktorá je založená na počte znakov.
Parameter language
Tento parameter je povinný. Prijíma kód BCP-47 alebo špeciálnu hodnotu auto pre automatickú detekciu jazyka.
Podporovaných je 20 jazykov:
| Kód | Jazyk | Kód | Jazyk |
|---|---|---|---|
en | Angličtina | ko | Kórejčina |
fr | Francúzština | hi | Hindčina |
de | Nemčina | bn | Bengálčina |
es-ES | Španielčina (Španielsko) | ar-EG | Arabčina (Egypt) |
es-MX | Španielčina (Mexiko) | ar-SA | Arabčina (Saudská Arábia) |
pt-BR | Portugalčina (Brazília) | ar-AE | Arabčina (SAE) |
pt-PT | Portugalčina (Portugalsko) | tr | Turečtina |
it | Taliančina | id | Indonézština |
ru | Ruština | vi | Vietnamčina |
zh | Čínština | ja | Japončina |
Automatická detekcia (auto) funguje dobre pre texty v jednom jazyku, ale pri textoch miešajúcich viacero jazykov explicitne uveď hlavný jazyk.
Parameter output_format
Tento voliteľný parameter je objekt JSON, ktorý riadi formát výstupného audia. Má tri podparametre.
codec
Kodek nastavuje formát kódovania:
mp3(predvolené): komprimovaný formát, ideálny pre web a streamovaniewav: formát bez strát, lepšia kvalita, ale väčšie súborypcm: surové audio bez hlavičky, určené pre spracovateľské pipelinemulaw/ulaw: kodek G.711 mu-law pre telefóniualaw: kodek G.711 A-law pre telefóniu
sample_rate
Vzorkovacia frekvencia v hertzoch. Prijaté hodnoty: 8000, 16000, 22050, 24000 (predvolené), 44100, 48000.
bit_rate
Bitová rýchlosť v bitoch za sekundu, len pre kodek MP3. Prijaté hodnoty: 32000, 64000, 96000, 128000 (predvolené), 192000.
{
"text": "High-quality audio for production.",
"voice_id": "ara",
"language": "en",
"output_format": {
"codec": "wav",
"sample_rate": 48000
}
}
Parameter speed
speed nastavuje rýchlosť prehrávania: 1.0 je normálna rýchlosť (predvolená hodnota) a rozsah je od 0.7 do 1.5. Mierne pomalšie tempo pomáha pri hutnom vzdelávacom obsahu; pri hodnotách nad 1.2 si výsledok vždy znovu vypočuj.
Odporúčané kombinácie
| Prípad použitia | codec | sample_rate | bit_rate |
|---|---|---|---|
| Web / streamovanie | mp3 | 24000 | 128000 |
| Audio produkcia | wav | 48000 | — |
| Telefónia VoIP | mulaw | 8000 | — |
| ML pipeline | pcm | 16000 | — |
Kľúčové poznatky
textalanguagesú jediné povinné parametrevoice_idje voliteľný (predvolené:eve) a nerozlišuje veľkosť písmenoutput_formatriadi kodek, vzorkovaciu frekvenciu a bitovú rýchlosť;speednastavuje rýchlosť (0,7 až 1,5)- MP3 pri 24 kHz / 128 kbps je dobrým predvoleným kompromisom medzi kvalitou a veľkosťou
- Pre telefóniu použij
mulawaleboalawpri 8 kHz