Parameters voor TTS-verzoeken
Op deze pagina
Bijgewerkt op 3 november 2026, gebaseerd op de xAI-pagina Text to Speech en de Voice API-referentie. Bronnen: Text to Speech · Voice API.
Uw spraaksynthese fijnafstemmen
Het eindpunt POST /v1/tts draait om vier hoofdparameters in de JSON-aanvraagbody, plus enkele optionele instellingen. Elke parameter geeft u nauwkeurige controle over de gegenereerde audio. Door ze te begrijpen, kunt u de synthese perfect afstemmen op uw use case.
De parameter text
Samen met language is text de enige verplichte parameter. Deze accepteert een string van maximaal 60.000 tekens, die platte tekst of expressieve tags kan bevatten (behandeld in de volgende sectie).
{
"text": "Hello and welcome. Today, we're going to talk about artificial intelligence."
}
Boven de 60.000 tekens wordt het HTTP-verzoek geweigerd. Voor langere teksten raadt xAI WebSocket aan, dat geen totaallimiet heeft (lessen 9 tot en met 12), of het splitsen van de tekst in segmenten waarvan u de audio samenvoegt. Splits op natuurlijke grenzen (einde van zinnen, einde van alinea’s) voor een vloeiend resultaat.
De parameter voice_id
Deze parameter stelt de stem in die voor de synthese wordt gebruikt. Hij is optioneel en standaard ingesteld op eve. ID’s zijn hoofdlettergevoelig: Eve, EVE en eve zijn equivalent.
xAI biedt 28 ingebouwde stemmen (per 3 november 2026), hetzelfde als voor de voice agent, plus aangepaste stemmen gemaakt met de Custom Voices API. De vijf originele stemmen, zoals xAI ze beschrijft:
- eve: energiek en optimistisch, Brits accent
- ara: warm en vriendelijk
- rex: zelfverzekerd en helder
- sal: soepel en gebalanceerd
- leo: autoritair en krachtig, Brits accent
De andere 23 (carina, zagan, helix, orion, luna, iris, altair, zenith, perseus, helios, lux, kepler, rigel, cosmo, celeste, ursa, sirius, lumen, castor, naksh, atlas, aurora en liora) worden beschreven met hun use cases op de xAI-pagina Text to Speech; GET /v1/tts/voices geeft de huidige lijst terug (les 3).
{
"text": "Welcome to this tutorial.",
"voice_id": "rex",
"language": "en"
}
Volgens xAI spreekt elke stem alle ondersteunde talen. Uw keuze voor een stem heeft geen invloed op de prijs; deze is gebaseerd op het aantal tekens.
De parameter language
Deze parameter is verplicht. Hij accepteert een BCP-47-code of de speciale waarde auto voor automatische taaldetectie.
De 20 ondersteunde talen zijn:
| Code | Taal | Code | Taal |
|---|---|---|---|
en | Engels | ko | Koreaans |
fr | Frans | hi | Hindi |
de | Duits | bn | Bengaals |
es-ES | Spaans (Spanje) | ar-EG | Arabisch (Egypte) |
es-MX | Spaans (Mexico) | ar-SA | Arabisch (Saoedi-Arabië) |
pt-BR | Portugees (Brazilië) | ar-AE | Arabisch (VAE) |
pt-PT | Portugees (Portugal) | tr | Turks |
it | Italiaans | id | Indonesisch |
ru | Russisch | vi | Vietnamees |
zh | Chinees | ja | Japans |
Automatische detectie (auto) werkt goed voor teksten in één taal, maar voor teksten die meerdere talen mengen, geeft u de hoofdtaal expliciet op.
De parameter output_format
Deze optionele parameter is een JSON-object dat het audio-uitvoerformaat regelt. Het heeft drie sub-parameters.
codec
De codec stelt het coderingsformaat in:
mp3(standaard): een gecomprimeerd formaat, ideaal voor het web en streamingwav: een verliesvrij formaat, betere kwaliteit maar grotere bestandenpcm: ruwe audio zonder header, voor verwerkingspipelinesmulaw/ulaw: de G.711 mu-law-codec voor telefoniealaw: de G.711 A-law-codec voor telefonie
sample_rate
De samplefrequentie in hertz. Geaccepteerde waarden: 8000, 16000, 22050, 24000 (standaard), 44100, 48000.
bit_rate
De bitsnelheid in bits per seconde, alleen voor de MP3-codec. Geaccepteerde waarden: 32000, 64000, 96000, 128000 (standaard), 192000.
{
"text": "High-quality audio for production.",
"voice_id": "ara",
"language": "en",
"output_format": {
"codec": "wav",
"sample_rate": 48000
}
}
De parameter speed
speed stelt de afspeelsnelheid in: 1.0 is de normale snelheid (de standaard) en het bereik loopt van 0.7 tot 1.5. Een iets langzamer tempo helpt bij dense educatieve content; boven 1.2 luistert u het resultaat altijd opnieuw af.
Aanbevolen combinaties
| Use case | codec | sample_rate | bit_rate |
|---|---|---|---|
| Web / streaming | mp3 | 24000 | 128000 |
| Audioproductie | wav | 48000 | — |
| VoIP-telefonie | mulaw | 8000 | — |
| ML-pipeline | pcm | 16000 | — |
Belangrijkste punten
textenlanguagezijn de enige verplichte parametersvoice_idis optioneel (standaard:eve) en hoofdlettergevoeligoutput_formatregelt de codec, samplefrequentie en bitsnelheid;speedstelt de snelheid in (0,7 tot 1,5)- MP3 op 24 kHz / 128 kbps is een goede standaardbalans tussen kwaliteit en grootte
- Gebruik voor telefonie
mulawofalawop 8 kHz