Veelgestelde vragen
Welke modellen zijn beschikbaar?
Er zijn twee modellen: tts-1 en tts-1-hd. Beide gebruiken dezelfde engine en hebben dezelfde prijs. Je kiest het model via het veld 'model' in de JSON-body van je POST-request naar de endpoint /v1/audio/speech. De keuze heeft geen invloed op de kosten.
Wat is het verschil tussen tts-1 en tts-1-hd?
Volgens de specificaties gebruiken beide modellen dezelfde engine en hebben ze dezelfde prijs. Het veld 'model' accepteert zowel 'tts-1' als 'tts-1-hd'.
Hoe stel ik de taalhandmatig in?
Voeg het veld 'language' toe aan je request met een ISO-taalcode. Als je dit veld weglaat, wordt de taal geraden op basis van het script; Latijnse teksten worden standaard als Engels geïnterpreteerd. Voor niet-Engelse teksten in Latijns schrift is handmatige instelling aanbevolen.
Kan ik de snelheid dynamisch aanpassen?
Ja, je kunt de snelheid instellen via het veld 'speed' in de request body. De waarde moet een getal zijn tussen 0.25 en 4.0. Dit stelt je in staat de uitspraakversnelling of -vertraging precies af te stemmen op de gewenste cadans van je podcast.
Welke formaten worden ondersteund?
Je kunt kiezen uit mp3, wav, opus, flac en pcm. Specificeer het gewenste formaat met het veld 'response_format' in je JSON-request. De gegenereerde audio wordt direct in het gevraagde formaat teruggegeven in de respons van de API, zonder extra conversiestappen.
Hoeveel characters per request?
Een enkele request mag maximaal 4096 tekens bevatten. Dit bedrag is inclusief spaties en leestekens. Als je tekst langer is, moet je deze splitsen in delen van maximaal 4096 tekens en de audiobestanden achteraf aan elkaar plakken.
Wat gebeurt er bij een rate limit?
Je hebt een limiet van 60 requests per minuut per sleutel (10 voor de eerste top-up). Requests worden één voor één verwerkt. Onder belasting kan een request in de wachtrij komen te staan en iets langer duren voordat hij wordt verwerkt.
Wordt de audio gestreamd?
Nee, streaming wordt niet ondersteund. Je ontvangt het volledige audiobestand als reactie op je POST-request. Er is geen WebSocket-verbinding of real-time partiële audio beschikbaar. De API retourneert het gegenereerde bestand direct na voltooiing van de syntheseprocess.
Heb ik een eigen SDK nodig?
Nee, je hebt geen eigen SDK nodig. Je kunt de officiële OpenAI SDKs gebruiken door de base_url aan te passen naar https://api.prachurja.net/v1. Je kunt ook gewoon HTTP-requests gebruiken met je API-sleutel in de Authorization-header.
Hoe werk ik met SSML?
SSML wordt niet ondersteund. De API accepteert eenvoudige tekst in het veld 'input'. Je kunt geen SSML-tags gebruiken voor intonatie of pauzes. Voor fijnere controle kun je wel de snelheid aanpassen via het 'speed'-veld.
Kan ik phoneme dictionaries gebruiken?
Nee, het ondersteunen van fonemwoordenboeken of aangepaste uitspraaklexicons is niet mogelijk. De API verwerkt alleen de ingevoerde tekststring. Je hebt geen toegang tot laag-niveau uitspraakcontrole op fonemniveau binnen de huidige API-functionaliteit.
Hoe verwerk ik teksten langer dan 4096 tekens?
Splits je tekst in delen van maximaal 4096 tekens per request. Stuur elk deel afzonderlijk naar de API en ontvang de audiobestanden. Plak de gegenereerde audiobestanden achteraf aan elkaar om het volledige audiofragment te vormen.
Wat is de typische responstijd?
De generatie is ongeveer real-time: circa 25 tekens per seconde gegenereerde audio. Korte zinnen duren enkele seconden. Bij belasting kunnen requests in de wachtrij komen, waardoor de responstijd kan toenemen. De verwerking gebeurt sequentieel.
Hoe registreer ik fouten in mijn logs?
Foute aanvragen zijn gratis en de charge wordt volledig teruggenomen. Houd de HTTP-statuscodes en de responsbody bij voor foutmeldingen. De API retourneert een foutbericht bij mislukte syntheseprocessen, zodat je deze kunt loggen voor debugging.
Eerste verzoek
curl
curl https://api.prachurja.net/v1/audio/speech \
-H "Authorization: Bearer $TTS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"tts-1","voice":"aria","input":"Hello from the API.","response_format":"mp3"}' \
--output hello.mp3Python (openai)
from openai import OpenAI
client = OpenAI(base_url="https://api.prachurja.net/v1", api_key="tts-...")
with client.audio.speech.with_streaming_response.create(
model="tts-1", voice="nova", input="Hello from Python.", response_format="mp3"
) as response:
response.stream_to_file("hello.mp3")Node.js (openai)
import OpenAI from "openai";
import fs from "node:fs";
const client = new OpenAI({ baseURL: "https://api.prachurja.net/v1", apiKey: process.env.TTS_API_KEY });
const res = await client.audio.speech.create({ model: "tts-1", voice: "milo", input: "Hello from Node.js." });
fs.writeFileSync("hello.mp3", Buffer.from(await res.arrayBuffer()));| voice | |
|---|---|
aria | vrouwelijk |
nova | vrouwelijk |
luna | vrouwelijk |
sage | vrouwelijk |
felix | mannelijk |
milo | mannelijk |
atlas | mannelijk |
orion | mannelijk |
| language | |
|---|---|
ar | العربية |
zh | 中文 |
da | Dansk |
nl | Nederlands |
en | English |
fi | Suomi |
fr | Français |
de | Deutsch |
el | Ελληνικά |
he | עברית |
hi | हिन्दी |
it | Italiano |
ja | 日本語 |
ko | 한국어 |
ms | Bahasa Melayu |
no | Norsk |
pl | Polski |
pt | Português |
ru | Русский |
es | Español |
sw | Kiswahili |
sv | Svenska |
tr | Türkçe |
Krijg je API key
Begin met het aanmaken van je account via de /get-api-key/ pagina. Je kunt kiezen voor aanmelding met Google of het registreren met een e-mailadres en wachtwoord. Het is belangrijk om te weten dat accounts die met e-mail zijn aangemaakt beginnen zonder proefcredit.
Registratie via Google of e-mail
Je kunt je account aanmaken door te kiezen voor inloggen met Google of door een nieuw account aan te maken met je e-mailadres en een wachtwoord. Bij registratie met e-mail start je zonder proefcredit; Google-inloggers ontvangen automatisch $0,50 aan credit voor 7 dagen. Accounts gemaakt met e-mail en wachtwoord beginnen zonder proefcredit.
API key locatie in dashboard
Na het aanmaken van je account wordt je API key direct zichtbaar in het dashboard. Deze sleutel is vereist voor authenticatie bij elk verzoek naar de API. Je ziet hier ook je resterende saldo en het aantal verbruikte tekens.
Key beheren en regenereren
Je hebt één actieve key per account. Op elk moment kun je een nieuwe key genereren. Zodra de nieuwe key is aangemaakt, wordt de oude key direct ongeldig, waardoor je oude sessies mogelijk onderbroken worden tot je de nieuwe sleutel hebt geconfigureerd.
Eerste request met cURL
Na het verkrijgen van je API key kun je direct beginnen met het genereren van audio. Dit hoofdstuk legt uit hoe je een eerste verzoek opzet met cURL, zodat je de basisfunctionaliteit van de API kunt verifiëren zonder extra software.
We gebruiken de standaard POST-structuur die bekend is van andere TTS-APIs. Door de juiste headers te setten en het tekstbericht correct te formatteren, ontvang je direct een audiobestand dat je kunt afspelen of opslaan voor je podcastproductie.
Basis POST request structuur
Stuur een POST-verzoek naar https://api.prachurja.net/v1/audio/speech. Het lichaam (body) moet een JSON-object bevatten met de velden model, input, voice en response_format. De maximale tekstlengte per verzoek is 4096 karakters.
Voorbeeld van een minimaal geldig verzoek:
```bash curl -X POST https://api.prachurja.net/v1/audio/speech \ -H "Content-Type: application/json" \ -H "Authorization: Bearer tts-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \ -d '{"model": "tts-1", "input": "Dit is een test voor je podcast.", "voice": "aria", "response_format": "mp3"}' ```
Authenticatie header instellen
Voeg je API key toe als een Bearer token in de Authorization-header. Zorg dat je key correct is gekopieerd uit je dashboard op /get-api-key/. Een ongeldige key resulteert in een 401 fout.
De header ziet er als volgt uit:
``bash
-H "Authorization: Bearer tts-je-api-key-hier"
``
Audio response ontvangen
Bij een succesvol verzoek ontvang je het audiobestand direct in de response body. Het formaat komt overeen met het aangevraagde response_format (bijv. mp3, wav, opus, flac, of pcm).
Sla de response op in een bestand met -o output.mp3. Bij fouten ontvang je een JSON-foutbericht met een beschrijving van de oorzaak.
Integratie met OpenAI SDK
De API volgt de exacte requeststructuur van de OpenAI speech-endpoint. Dit betekent dat je de officiële OpenAI SDKs direct kunt gebruiken zonder nieuwe bibliotheken te installeren. Je hoeft alleen de basis-URL aan te passen naar https://api.prachurja.net/v1 en je API-key te configureren.
Base URL aanpassen
Pas de base_url in je SDK-configuratie aan naar https://api.prachurja.net/v1. Authenticatie verloopt via de Authorization: Bearer header met je unieke sleutel. De request-vorm blijft identiek aan de standaard OpenAI implementatie.
Model selectie: tts-1 of tts-1-hd
Kies tussen tts-1 en tts-1-hd als modelwaarde. Beide gebruiken dezelfde motor en hebben dezelfde prijs van $10 per miljoen tekens. Het verschil zit in de audiokwaliteit, niet in de verwerkingstijd of de API-structuur.
Code voorbeelden voor Python
Initialiseer de client met je aangepaste basis-URL. Roep de speech-methode aan met je tekst, stemkeuze en gewenste audioformaat. De SDK retourneert de audio-data direct, klaar voor opslag of directe afspelling in je podcastworkflow.
- Stel
base_urlin ophttps://api.prachurja.net/v1. - Gebruik
model='tts-1'ofmodel='tts-1-hd'. - Voeg je
tts-...sleutel toe aan de headers.
Beschikbare voice presets
Kies je voice preset op basis van de narratieve stijl van je podcast. De acht beschikbare stemmen zijn gebaseerd op gelicentieerde opnames uit LibriTTS-R (CC BY 4.0), afkomstig van LibriVox publiek domein luisterboekopnames.
Aria en Nova voor narratie
Aria levert een warme, duidelijke vertelstem die ideaal is voor het weergeven van verhalen of gedetailleerde uitleg. Nova is helder en energiek, wat werkt voor lichte, up-to-date content waar de luisteraar direct geboeid moet blijven.
- Aria: warme, duidelijke vertelstem
- Nova: heldere, opgewekte toon
Felix en Milo voor conversatie
Felix brengt energie in je audio, geschikt voor promo's of dynamische segmenten. Milo klinkt vriendelijk en gespreksgericht, perfect voor interviews die zijn omgezet naar tekst of voor conversational podcasts waar de nadruk op natuurlijke dialoog ligt.
- Felix: energiek, ideaal voor promo's
- Milo: vriendelijk, gespreksgericht
Atlas en Orion voor nieuws en documentaires
Atlas biedt een neutrale, journalistieke toon die betrouwbaarheid uitstraalt, ideaal voor nieuwsupdates. Orion levert een diepe, documentaire-stijl voice-over die serieus en gravitatieus overkomt, perfect voor lange-form content of onderzoeksrapporten.
- Atlas: neutraal, journalistiek
- Orion: diep, documentaire-stijl
Audio formaten en instellingen
Kies het juiste audiobestandstype voor je podcastworkflow. MP3 biedt een goede balans tussen kwaliteit en bestandsgrootte, ideaal voor snelle distributie. WAV en FLAC behouden de volledige audiokwaliteit zonder compressieverlies, wat nuttig is voor postproductie. Voor efficiënte overdracht zijn OPUS en de ruwe PCM-indeling beschikbaar.
De snelheid van de synthese kun je fijnafstemmen tussen 0.25x en 4.0x. Dit stelt je in staat om de ritme van de voice-over aan te passen zonder de toon te veranderen. Gebruik langzamere snelheden voor rustige narratie en hogere snelheden voor drukke updates of korte mededelingen.
MP3, WAV, OPUS, FLAC, PCM
Kies het bestandsformaat dat past bij je distributiekanaal. MP3 is een veelgebruikt formaat voor online distributie en biedt een goede balans tussen kwaliteit en bestandsgrootte. WAV en FLAC zijn ideaal voor postproductie omdat ze ongecomprimeerd zijn en geen kwaliteit verliezen. OPUS is efficiënt voor data-overdracht, terwijl PCM ruwe, onbewerkte audio levert voor maximale controle in je editor.
- MP3: compact en breed ondersteund
- WAV/FLAC: hoge kwaliteit voor editing
- OPUS: efficiënt voor streaming
- PCM: ruwe data voor postproductie
Snelheid variëren van 0.25x tot 4.0x
Met de snelheidsparameter pas je de uitspraaksnelheid aan binnen het bereik van 0.25 tot 4.0 keer de normale snelheid. Dit stelt je in staat om de pacing van je podcast te verfijnen zonder de toonhoogte of klankkleur van de voice te veranderen. Langzamere snelheden werken goed voor complexe informatie, terwijl hogere snelheden geschikt zijn voor korte updates of energieke content.
- Standaard snelheid is 1.0x
- Bereik: 0.25x tot 4.0x
- Behoudt toon en klankkleur
Taalspecificatie via ISO code
Specificeer de taal expliciet met een ISO-code in de request body. Hoewel het systeem de taal vaak automatisch detecteert op basis van het script, is een expliciete instelling veiliger voor teksten in het Latijnse alfabet die niet Engels zijn. Dit voorkomt foutieve uitspraak en zorgt voor consistente resultaten, vooral bij gemengde talen of specifieke dialecten.
- Gebruik ISO 639-1 codes
- Vermijdt foutieve auto-detectie
- Ondersteund voor alle 23 talen

Foutcodes en foutafhandeling
De API retourneert specifieke foutcodes om integratiefouten snel te diagnosticeren. Een 401 ontstaat bij een onjuiste API-key, terwijl een 422 duidt op ongeldige parameters zoals een niet-bestaande voice of een tekstlengte boven de 4096 karakters.
Bij een 429-fout is de rate limit overschreden. De API accepteert maximaal 60 requests per minuut per key. Bij een nieuw account begint je met 10 requests per minuut, totdat je je eerste top-up hebt voltooid. Deze limiet voorkomt overbelasting van de synthese-engine.
4xx fouten interpretieren
Gebruik de foutmelding in de response body om het probleem direct te verhelpen. Controleer altijd of de Authorization header correct is ingesteld met het Bearer token.
Rate limit errors begrijpen
Als je de limiet raakt, wacht dan enkele seconden voordat je opnieuw probeert. Regenereren van je key reset niet direct je huidige limiet.
Timeouts en retry logica
Generatie kan enkele seconden duren, vooral bij lange teksten. Implementeer een retry-mechanisme met exponentiële back-off voor tijdelijke serveroverspanning. Fouten tijdens het proces zijn gratis, dus je verliest geen credits bij een mislukte poging.
Rate limits en prestaties
Je API key is beperkt tot 60 verzoeken per minuut. Dit volume is ontworpen voor de batchverwerking van podcastscripts en audioboeken, waarbij je meerdere scènes of hoofdstukken tegelijk kunt genereren zonder dat de infrastructuur overbelast raakt.
60 requests per minuut per key
De limiet geldt per API key. Als je meerdere projecten hebt, kun je verschillende keys aanmaken. Elke key onafhankelijk van de anderen, zodat je workflow niet wordt geblokkeerd door een enkele zware batch.
Wachtrij systeem bij hoge belasting
Verzoeken worden sequentieel verwerkt. Onder hoge belasting kan een verzoek in een wachtrij terecht komen. Dit voorkomt dat de servers overbelast raken, maar betekent dat je niet altijd onmiddellijk resultaat ontvangt.
Typische generatietijden
Voor lange teksten duurt de generatie ongeveer even lang als de duur van de audio zelf (real-time). Korte zinnen kunnen enkele seconden extra duren door overhead. Houd rekening met wachttijden bij stressvolle momenten.
Lange teksten verwerken
Omdat elke API-aanroep beperkt is tot 4096 tekens, moet je langere scriptteksten splitsen in kleinere segmenten voordat je ze verstuurt. Dit zorgt ervoor dat elke request binnen de gestelde limieten blijft zonder dat je handmatig hoeft te tellen.
Splitting van teksten boven 4096 chars
Je tekent het script op in delen van maximaal 4096 tekens. Elke deel wordt afzonderlijk verstuurd naar de endpoint. Zo voorkom je fouten door te lange invoer en houd je de controle over het proces.
Audio bestanden samenvoegen
Na het ontvangen van de audiobestanden voor elk segment, moet je deze aan elkaar plakken. Gebruik een bibliotheek zoals pydub of ffmpeg om de losse MP3- of WAV-bestanden te concateneren tot één lopend audio bestand.
Automatische segmentatie strategieën
Om vloeiende audio te behouden, segmenteer je op zin- of alinea-einden in plaats van willekeurige karakters. Dit voorkomt dat zinnen middenin worden afgekapt. Een eenvoudige regel is om te splitsen bij leesttekens net onder de 4096-grens.
Luister naar de 8 stemmen
Elk voorbeeld hieronder is gegenereerd door deze API met dezelfde zin. Dit maakt het mogelijk om inhoud snel te lokaliseren voor een internationaal publiek zonder dat er extra studio's nodig zijn.
23 talen
Elke stem kan elke van deze talen spreken.
