Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Parameters voor TTS-verzoeken

Les 2 van 14 Bijgewerkt op 3 november 2026 Ontwikkelaar
Op deze pagina
  1. Uw spraaksynthese fijnafstemmen
  2. De parameter text
  3. De parameter voice_id
  4. De parameter language
  5. De parameter output_format
  6. De parameter speed
  7. Aanbevolen combinaties
  8. Belangrijkste punten

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:

CodeTaalCodeTaal
enEngelskoKoreaans
frFranshiHindi
deDuitsbnBengaals
es-ESSpaans (Spanje)ar-EGArabisch (Egypte)
es-MXSpaans (Mexico)ar-SAArabisch (Saoedi-Arabië)
pt-BRPortugees (Brazilië)ar-AEArabisch (VAE)
pt-PTPortugees (Portugal)trTurks
itItaliaansidIndonesisch
ruRussischviVietnamees
zhChineesjaJapans

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 streaming
  • wav: een verliesvrij formaat, betere kwaliteit maar grotere bestanden
  • pcm: ruwe audio zonder header, voor verwerkingspipelines
  • mulaw / ulaw: de G.711 mu-law-codec voor telefonie
  • alaw: 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 casecodecsample_ratebit_rate
Web / streamingmp324000128000
Audioproductiewav48000—
VoIP-telefoniemulaw8000—
ML-pipelinepcm16000—

Belangrijkste punten

  • text en language zijn de enige verplichte parameters
  • voice_id is optioneel (standaard: eve) en hoofdlettergevoelig
  • output_format regelt de codec, samplefrequentie en bitsnelheid; speed stelt 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 mulaw of alaw op 8 kHz