Veelgestelde vragen
Hoe werkt de taalherkenning voor Vlaams Nederlands?
De API detecteert de taal op basis van het script. Bij Latijnse karakters wordt standaard Engels aangenomen, dus stel expliciet language in op 'nl' voor Nederlands. De API ondersteunt Nederlands naast 22 andere talen. Alle acht stemmen kunnen elke taal spreken, waardoor Vlaams en Nederlands naadloos worden gegenereerd zonder extra configuratie.
Zijn de stemmen geschikt voor professionele localisatie?
Ja, de acht stemmen zijn gebaseerd op gelicentieerde opnames van LibriTTS-R en LibriVox. Ze bieden een neutrale, professionele toon zonder emotietags. Elke gegenereerde audio bevat een onhoorbaar watermerk dat synthetische spraak aangeeft. Dit is ideaal voor bulkverwerking en localisatie, waar consistentie en transparantie over de aard van de audio belangrijk zijn.
Hoe wordt de lengte van de tekst gemeten voor facturatie?
Facturatie gebeurt per miljoen tekens. Ruimtes en leestekens tellen mee als tekens. De prijs is $0,01 per 1.000 tekens. Mislukte requests worden gratis en het bedrag wordt volledig teruggestort. Dit zorgt voor een transparante kostenstructuur, waarbij je alleen betaalt voor succesvol gegenereerde audio.
Kan ik de snelheid van de spraak aanpassen?
Ja, je kunt de snelheid instellen tussen 0,25 en 4,0 via het speed veld in de request body. Dit stelt je in staat de uitspraak aan te passen aan de context van de localisatie. De standaard snelheid is 1.0. Pas de snelheid aan voor optimale leesbaarheid in de doeltaal.
Wordt mijn ingevoerde tekst gebruikt voor training?
Nee, je invoertekst wordt uitsluitend gebruikt om de audio te genereren en niet voor training van modellen. De gegenereerde audio wordt niet opgeslagen na verzending. Alleen requestmetadata zoals tijd, aantal tekens en status worden bewaard voor facturatiedoeleinden. Dit garandeert dat je content niet wordt gebruikt voor modelverbetering.
Welke audioformaten worden ondersteund?
De API ondersteunt de formaten mp3, wav, opus, flac en pcm. Je kunt het gewenste formaat specificeren via het response_format veld in de request body. Dit biedt flexibiliteit voor verschillende integraties in localisatiepipelines. Kies het formaat dat het beste past bij je downstream verwerkingsinfrastructuur.
Hoe gaat de API om met teksten langer dan 4096 tekens?
Teksten worden automatisch opgesplitst in delen van maximaal 4096 tekens per request. De gegenereerde audiobestanden worden vervolgens aan elkaar geplakt. Je hoeft dit niet handmatig te doen; de API verwerkt dit proces achter de schermen. Dit zorgt voor een naadloze ervaring bij het converteren van lange documenten.
Wat gebeurt er als een request mislukt?
Als de synthesefaalt, wordt het volledige bedrag terugbetaald. Er vinden geen kosten plaats voor mislukte requests. Dit zorgt voor een eerlijke facturatie, waarbij je alleen betaalt voor succesvol gegenereerde audio. De status van de request wordt wel geregistreerd voor auditdoeleinden en facturatiecontrole.
Is er een verschil tussen tts-1 en tts-1-hd?
Nee, beide modellen gebruiken dezelfde engine en hebben dezelfde prijs. Het enige verschil is de resolutie van de audio. tts-1-hd biedt hogere kwaliteit, maar de kosten zijn identiek. Je kunt kiezen op basis van je kwaliteitsbehoeften zonder extra kosten voor de hogere resolutie.
Hoeveel tekens kan ik per minuut versturen?
Je hebt een limiet van 60 requests per minuut per API-sleutel. Voorafgaand aan de eerste top-up is dit 10 requests per minuut. Elke request kan tot 4096 tekens bevatten. De verwerking gebeurt sequentieel, dus onder belasting kunnen requests in de wachtrij komen. Houd rekening met deze limieten voor hoge volumes.
Zijn er extra kosten voor hoge resolutie audio?
Nee, er zijn geen extra kosten voor hoge resolutie audio. Het model tts-1-hd heeft dezelfde prijs als tts-1. De tarieven zijn gebaseerd op het aantal tekens, niet op de audiokwaliteit. Je kunt dus zonder financiële consequenties kiezen voor de betere geluidskwaliteit van HD-modellen.
Kan ik meerdere API sleutels tegelijk gebruiken?
Ja, je kunt meerdere API-sleutels genereren. Elke sleutel heeft een eigen limiet van 60 requests per minuut. Dit stelt je in staat om de throughput te verhogen door requests over meerdere sleutels te verdelen. Je kunt ook een nieuwe sleutel genereren, waardoor de oude direct ongeldig wordt.
Hoe lang blijft mijn saldo geldig?
Je saldo vervalt niet. Top-ups via USDT op het TRON-netwerk worden automatisch binnen enkele minuten bijgeschreven. Er zijn geen maandelijkse abonnementen of minimale uitgaven. Het saldo blijft beschikbaar zolang je account actief is, wat ideaal is voor projectgebonden localisatieklussen met wisselende volumeverwachtingen.
Welke talen worden niet ondersteund?
Vietnamitaans, Indonesisch, Thai, Oekraïens, Roemeens, Tsjechisch en Bengaals worden niet ondersteund. Ook andere talen buiten de lijst van 23 ondersteunde talen zijn niet beschikbaar. De API ondersteunt onder andere Nederlands, Engels, Duits, Frans en Spaans. Controleer altijd de lijst met ondersteunde talen voordat je een project start.
Eerste verzoek
curl
curl https://api.kb333.info/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.mp3API voor bulk-audioproductie
De API biedt een directe POST /v1/audio/speech endpoint voor het omzetten van tekst naar spraak. Dit is de kernfunctionaliteit voor bulkverwerking, waarbij tekst wordt geconverteerd naar audiobestanden via een eenvoudige JSON-aanroep.
Voor localisatiebureaus en publishers betekent dit een gestroomlijnde workflow zonder ingewikkelde platformen. Je stuurt tekst en ontvangt direct het audiobestand, volledig geïntegreerd in je bestaande technische infrastructuur.
POST /v1/audio/speech endpoint
Elke aanroep verwerkt tekst van maximaal 4096 tekens. Je stelt het model (tts-1 of tts-1-hd), de voice, het formaat en de snelheid in via een JSON-body. De respons bevat het gegenereerde audiobestand direct in de response.
- JSON-body met model, input, voice, response_format en speed
- Maximale inputlengte van 4096 tekens per request
- Directe retourneer van het audiobestand in de response
OpenAI SDK compatibiliteit
De API volgt exact dezelfde request-shape als de OpenAI speech endpoint. Door de base_url aan te passen naar https://api.kb333.info/v1, werken de officiële OpenAI SDK’s direct zonder extra code-aanpassingen.
- Volledige compatibiliteit met OpenAI SDKs
- Enkel de base_url wijzigen naar https://api.kb333.info/v1
- Geen extra libraries of SDKs nodig
Automatische splitsing van lange teksten
Voor teksten langer dan 4096 tekens splitst het systeem automatisch in delen. Elke sectie wordt afzonderlijk gegenereerd en vervolgens samengevoegd tot één lopend audiobestand. Dit voorkomt fouten en behoudt de context.
- Automatische splitsing bij overschrijding van 4096 tekens
- Sequentiële generatie van audio-segmenten
- Naadloze samenvoeging tot één audio-bestand
Stemselectie voor diverse genres
Kies een voice die past bij de toon van je gelokaliseerde content. Ons aanbod bestaat uit acht duidelijke presets, verdeeld over vrouwelijke en manlijke registers, zonder ingewikkelde emotie-tags.
Vrouwelijke stemmen: Aria, Nova, Luna, Sage
Aria biedt een warme, heldere narrator-stem. Nova is helder en energiek, ideaal voor lichte teksten. Luna zorgt voor een zachte verteltoon, terwijl Sage rustig en instructief overkomt.
Mannelijke stemmen: Felix, Milo, Atlas, Orion
Felix is energiek en geschikt voor promo’s. Milo spreekt vriendelijk en conversatoerig. Atlas levert een neutrale nieuwsstem, en Orion biedt een diepe, documentaire-achtige uitstraling.
Neutraliteit en duidelijkheid voor nieuws en instructie
Voor zakelijke localisatie waar helderheid voorop staat, zijn Atlas en Sage de stabiele keuze. Deze stemmen verminderen afleiding en zorgen voor een directe overbrenging van de tekstinhoud zonder overmatige expressie.
Taalondersteuning en detectie
Onze API ondersteunt 23 talen, waaronder Nederlands en Engels. Dit maakt de dienst direct inzetbaar voor Vlaamse en Nederlandse localisatiebureaus die meerdere talen moeten verwerken. De stemmen spreken elk van deze talen vloeiend.
Voor precieze output is het belangrijk om de taalcorrectie te begrijpen. Door de juiste instellingen te gebruiken, voorkom je onnodige fouten in de spraakgeneratie.
23 ondersteunde talen inclusief Nederlands
De API ondersteunt Arabisch, Chinees, Deens, Engels, Fins, Frans, Duits, Grieks, Hebreeuws, Hindi, Italiaans, Japans, Koreaans, Maleis, Noors, Pools, Portugees, Russisch, Spaans, Swahili, Zweeds en Turks. Daarnaast is het Nederlands volledig ondersteund voor zowel Nederlandse als Vlaamse contexten.
Talen die niet worden ondersteund, zoals Tsjechisch, Oekraïens en Roemeens, worden niet gegarandeerd correct weergegeven. Voor andere talen buiten deze lijst kunt u contact opnemen via e-mail.
- Nederlands
- Engels
- Frans
- Duits
- Spaans
Automatische taalherkenning via script
Als u geen expliciete taalcode opgeeft, detecteert het systeem de taal aan de hand van het script. Tekst in Latijns schrift wordt standaard als Engels geïnterpreteerd.
Deze automatische detectie versnelt de integratie, maar vereist aandacht bij gemengde teksten of minder voorkomende talen binnen het Latijnse alfabet.
Expliciete taalcode instellen voor precisie
Voor maximale nauwkeurigheid, vooral bij niet-Engelse teksten in Latijns schrift, stelt u de language parameter in met de ISO-code. Dit voorkomt dat het systeem de taal verkeerd inschat.
Deze instelling is cruciaal voor localisatiebureaus die consistente uitspraak en intonatie willen garanderen in hun eindproducten.
Audioformaten en kwaliteit
De API biedt directe ondersteuning voor vijf audioformaten: mp3, wav, opus, flac en pcm. Dit stelt localisatiebureaus in staat om audiobestanden naadloos te integreren in hun bestaande dubbingpipelines, ongeacht de vereiste codec van de eindbestemming.
Elk gegenereerd bestand bevat een onhoorbaar watermerk dat de synthetische oorsprong aangeeft. Dit biedt transparantie zonder de luisterervaring te belemmeren, essentieel voor publicaties waar de herkomst van de voice-over duidelijk moet zijn.
Ondersteunde formats: mp3, wav, opus, flac, pcm
Kies het formaat dat past bij je workflow. MP3 en OPUS zijn compact voor webstreaming, WAV en FLAC behouden hoge kwaliteit voor archivering, en PCM is ideaal voor directe postproductie.
- MP3: breed compatibel, kleine bestandsgrootte
- WAV: ongecomprimeerd, hoge kwaliteit
- OPUS: efficiënt voor streaming
- FLAC: verliesvrije compressie
- PCM: ruw, ongecomprimeerd audio
Onhoorbaar watermerk in synthetische bestanden
Elk audio bestand draagt een digitaal watermerk dat aangeeft dat het gegenereerd is door de API. Dit is niet hoorbaar voor de luisteraar, maar kan technisch geverifieerd worden indien nodig voor authenticatie van de bron.
Snelheidsregulatie van 0.25x tot 4.0x
De snelheid kan worden aangepast tussen 0.25 en 4.0. Dit stelt je in staat de uitspraaksnelheid af te stemmen op de doelgroep of het genre, zonder de toon of intonatie van de geselecteerde stem te veranderen.
Voor publishers en localisatiebureaus
Een robuuste API voor tekst-naar-spraak, speciaal ontworpen voor publishers en localisatiebureaus die Vlaamse en Nederlandse content converteren naar spraak. Wij bieden een directe verbinding tussen tekst en audio, zonder ingewikkelde platforms of extra software. Onze oplossing is gebouwd voor bulkverwerking en schaalbaarheid, zodat je snel en efficiënt audioboeken of geluidsbestanden kunt genereren.
Schaalbare input tot 4096 tekens per request
Elke API-request accepteert maximaal 4096 tekens. Voor langere teksten splitst de API de input automatisch in delen en voegt de audiobestanden samen tot één bestand. Zo houd je controle over de kwaliteit en structuur van je audioproductie.
- Maximaal 4096 tekens per request
Geen training van input data voor AI-modellen
Je inputtext wordt uitsluitend gebruikt om het audiobestand te genereren. We gebruiken jouw tekst niet voor het trainen van onze AI-modellen. Dit garandeert dat je content volledig van jou blijft en niet wordt gebruikt voor andere doeleinden.
Betrouwbare facturatie per karakter
We rekenen alleen voor wat je gebruikt. Er zijn geen vaste maandelijkse kosten of abonnementen. Je betaalt per karakter, met een transparant tarief van €0,01 per 1000 tekens. Zo houd je altijd controle over je kosten en budget.
- Geen vaste maandelijkse kosten

Snelheid en verwerking
Het systeem genereert audio met een realistische snelheid, ongeveer even lang als de gesproken tekst bij lange documenten. Korte zinnen vereisen enkele seconden verwerkingstijd, wat een directe feedbackloop mogelijk maakt voor korte passages.
Rijmtijd ongeveer 1:1 bij lange teksten
De verwerkingstijd is ongeveer gelijk aan de duur van de gegenereerde audio. Dit betekent dat het genereren van een minuut aan spraak ongeveer een minuut duurt, gebaseerd op een snelheid van ongeveer 25 tekens per seconde.
Verwerking in wachtrij bij hoge belasting
Verzoeken worden sequentieel afgehandeld. Onder hoge belasting kan een verzoek in de wachtrij komen te staan, wat de totale doorlooptijd kan verlengen ten opzichte van de gemiddelde productiesnelheid.
Korte zinnen genereren enkele seconden
Voor korte teksten is de verwerkingstijd langer dan de gesproken duur. Het genereren van een korte zin kan enkele seconden duren, onafhankelijk van de tekstlengte, door de vaste overhead van de API-aanroep.
Eenvoudige integratie
Authenticatie gebeurt via een enkele API-sleutel die je meegeeft in de request header. Zodra je account is aangemaakt, kun je direct beginnen met het versturen van teksten naar het endpoint. Een nieuwe sleutel genereren stop de vorige onmiddellijk, wat zorgt voor heldere controle over je toegang.
Enkel API sleutel nodig voor authenticatie
Je gebruikt de header Authorization: Bearer tts-... om je identiteit te verifiëren. Er is geen complexe OAuth-flow nodig; één actieve sleutel per account volstaat voor alle requests. Bij twijfel kun je op elk moment een nieuwe sleutel aanmaken.
Geen extra SDKs of plugins nodig
We leveren geen eigen SDK of WordPress-plugin. Je kunt gewoon standaard HTTP-requests gebruiken of de officiële OpenAI SDKs, waarbij je de base_url aanpast naar https://api.kb333.info/v1. Dit maakt integratie in bestaande pipelines direct en zonder overhead mogelijk.
Directe HTTP requests of OpenAI libary
De request structuur is identiek aan de OpenAI speech endpoint. Je stuurt een JSON body met model, input, voice en format. Of je nu bash scripts, Python of Node.js gebruikt, de implementatie blijft simpel en voorspelbaar.
- Geen bijkomende bibliotheken nodig
- Compatibel met OpenAI SDKs via base_url aanpassing
- Standaard HTTP POST methode
- JSON body structuur volgt officiële specificaties
Licentie en bronnen
De stemmen van SpraakZaak zijn gebaseerd op opnames uit LibriTTS-R, gelicentieerd onder CC BY 4.0. Deze bron garandeert dat de basisdata juridisch veilig is voor commerciële toepassingen zonder onzekerheid over auteursrechten van oorspronkelijke opnames.
De onderliggende audioboeken zijn van het publieke domein (LibriVox), wat de herbruikbaarheid van de audio-structuur versterkt. Dit maakt de API geschikt voor uitgevers die risico's bij licentieproblemen willen minimaliseren.
Stemmen gebaseerd op LibriTTS-R (CC BY 4.0)
Alle acht voice presets zijn afgeleid van de LibriTTS-R dataset. Deze dataset valt onder de Creative Commons Attribution 4.0 International licentie.
Dit betekent dat de technische basis van de stemmen vrij te gebruiken is, mits de juiste vermelding wordt gegeven. Voor de meeste API-gebruikers is dit geen beperking, maar een duidelijkheid in de keten.
- CC BY 4.0 licentie voor de onderliggende opnames.
- Commercieel veilig voor eindproducten.
- Geen extra vergoedingen per download.
Public domain audioboeken als basis
De training en basis van de stemmen berust op audioboeken uit het publieke domein, afkomstig van LibriVox.
Diverse vrijwilligers hebben deze teksten voorgelezen, wat leidt tot een natuurlijke, menselijke intonatie zonder kunstmatige synthese-artefacten.
Deze bron is stabiel en historisch vastgelegd, wat consistentie in de stemkwaliteit waarborgt over tijd.
Transparante bronvermelding mogelijk
Hoewel de API de audio direct genereert, kunt u eenvoudig vermelden dat de stemmen op LibriTTS-R gebaseerd zijn.
Dit voldoet aan de eisen van CC BY 4.0 voor attributie. Vermelding van 'SpraakZaak' als provider is voldoende, aanvullende verwijzing naar LibriVox is optioneel maar gewenst voor maximale transparantie.
Deze aanpak biedt localisatiebureaus een schone juridische basis voor hun eindproducten.
Waarom kiezen voor deze API?
De API kent geen maandelijkse vaste lasten of minimale abonnementskosten. Je betaalt uitsluitend voor de werkelijk verbruikte tekens, wat de kostprijs transparant houdt en verhoudt tot de hoeveelheid gegenereerde audio.
Met een tarief van $10 per miljoen tekens heb je volledige controle over je budget. Er zijn geen verborgen kosten voor seats of premium features, wat ideaal is voor projectgebonden budgetten van localisatiebureaus en uitgevers.
Geen maandelijkse vaste lasten
Er zijn geen terugkerende abonnementskosten of vaste maatlasten. Het model is puur usage-based: je top-up je saldo via USDT (TRC-20) en gebruikt dit voor je verzoeken. Dit voorkomt dat je betaalt voor ongebruikte capaciteit tijdens rustige periodes.
- Geen maandelijkse vaste lasten
- Geen verplichte seats
- Saldobalance vervalt niet
Betaal alleen wat je gebruikt
Het tarief bedraagt $10 per miljoen tekens (gelijk aan $0,01 per 1000 tekens). Ruwweg 25 tekens worden per seconde gegenereerd. Dit maakt de API kostenefficiënt voor zowel kleine tests als grote bulkverwerkingen van lokale teksten.
- Tarief: $10 per miljoen tekens
- Betaling via USDT (TRC-20)
- Minimale top-up van $5
Directe controle over de audio-output
Je ontvangt de audiobestanden direct in de response zonder tussenkomst van een complexe dashboard-interface. Je kunt het formaat (mp3, wav, opus, flac, pcm) en de snelheid (0.25x tot 4.0x) nauwkeurig instellen via de API-parameters voor optimale integratie in je workflow.
- Formaatkeuze: mp3, wav, opus, flac, pcm
- Snelheid instelbaar van 0.25x tot 4.0x
- Directe audio-response
Luister naar de 8 stemmen
Elk voorbeeld hieronder is gegenereerd door deze API met dezelfde zin. Verifieer of de gegenereerde audio de beoogde taal correct weergeeft, vooral wanneer de automatische taalherkenning niet exact was.
23 talen
Elke stem kan elke van deze talen spreken.
