API Documentatie voor Podcastuitgevers en Contentcreators

Door Podcast Audio Lab redactie · Bijgewerkt 2026-11-18

Dit document is speciaal ontworpen voor podcastuitgevers en contentcreators die hun productiekosten willen verlagen zonder in te leveren op de kwaliteit van de voice-over. U leert hier hoe u de technische infrastructuur van Podcast Audio Lab integreert in uw bestaande workflows, zodat u zich kunt focussen op het verhaal en de productie, terwijl de API zorgt voor de audiogeneratie.

Wij bieden een eenvoudige REST API die naadloos aansluit bij bestaande ontwikkelomgevingen. In deze gids vindt u concrete voorbeelden voor authenticatie, het versturen van tekst naar spraak en het verwerken van audioresponces. Of u nu gebruikt maakt van de OpenAI SDK of directe cURL-commando's, deze documentatie helpt u bij het opzetten van een betrouwbare koppeling voor het genereren van audio.

API Documentatie voor Podcastuitgevers en Contentcreators

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.mp3

Python (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
ariavrouwelijk
novavrouwelijk
lunavrouwelijk
sagevrouwelijk
felixmannelijk
milomannelijk
atlasmannelijk
orionmannelijk
language
arالعربية
zh中文
daDansk
nlNederlands
enEnglish
fiSuomi
frFrançais
deDeutsch
elΕλληνικά
heעברית
hiहिन्दी
itItaliano
ja日本語
ko한국어
msBahasa Melayu
noNorsk
plPolski
ptPortuguês
ruРусский
esEspañol
swKiswahili
svSvenska
trTürkçe

Krijg je API key

Geluidsgolfillustratie voor: 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

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

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

Geluidsgolfillustratie voor: 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

Geluidsgolfillustratie voor: 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_url in op https://api.prachurja.net/v1.
  • Gebruik model='tts-1' of model='tts-1-hd'.
  • Voeg je tts-... sleutel toe aan de headers.

Beschikbare voice presets

Geluidsgolfillustratie voor: 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

Geluidsgolfillustratie voor: 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
Audio formaten en instellingen

Foutcodes en foutafhandeling

Geluidsgolfillustratie voor: 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

Geluidsgolfillustratie voor: 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

Geluidsgolfillustratie voor: 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.

Avatar van de stem aria
ariavrouwelijk
Avatar van de stem nova
novavrouwelijk
Avatar van de stem luna
lunavrouwelijk
Avatar van de stem sage
sagevrouwelijk
Avatar van de stem felix
felixmannelijk
Avatar van de stem milo
milomannelijk
Avatar van de stem atlas
atlasmannelijk
Avatar van de stem orion
orionmannelijk

23 talen

Elke stem kan elke van deze talen spreken.

Bronnen en verdere literatuur

  1. Wikipedia
  2. ISO 639 language codes
  3. Creative Commons Attribution 4.0
  4. FFmpeg documentation
  5. openai-python on GitHub
  6. Tether (USDT)
  7. IETF RFC 7845: Ogg Opus
  8. LibriVox public-domain audiobooks
  9. TRON developer hub: TRC-20
  10. OpenAI API reference: create speech
  11. Python documentation
  12. MDN: Web Speech API

Meer op deze site