Veelgestelde vragen
Wat is het verschil tussen TTS en SSML?
Onze API is een pure tekst-naar-spraak oplossing. We ondersteunen geen SSML, dus je kunt geen custom markup gebruiken voor intonatie of pauzes. Je stuurt platte tekst via een JSON-body en ontvangt direct het audiobestand. Dit houdt de integratie simpel voor developers die geen complexe markup nodig hebben.
Hoe wordt de tekst verwerkt tot audio?
Je stuurt een POST-request naar /v1/audio/speech met je tekst en gewenste voice. Onze servers syntheseren de audio en retourneren het bestand direct in de response. Bij lange teksten splitst u deze in delen van maximaal 4096 karakters en voegt u de audiobestanden achteraf samen.
Zijn de stemmen statisch of dynamisch?
De stemmen zijn statische presets gebaseerd op gelicentieerde opnames. Je kiest uit acht vaste opties zoals Aria, Nova of Felix. Er is geen real-time aanpassing van emotie of toonhoogte mogelijk tijdens de synthesise. De voice blijft consistent per request, wat ideaal is voor herhaalbare datasetgeneratie.
Kan ik de API gebruiken voor realtime toepassingen?
Nee, de API is niet geschikt voor realtime streaming. Er is geen WebSocket of stream-endpoint. Je ontvangt het volledige audiobestand na voltooiing van de synthesise. Voor korte zinnen duurt dit enkele seconden; bij langere teksten kan wachttijd optreden door de wachtrij onder druk. Het is ontworpen voor batchverwerking.
Wat is de latency van de API?
De generatiesnelheid is ongeveer even snel als de werkelijke spreeksnelheid (25 tekens per seconde). Korte zinnen zijn binnen enkele seconden klaar. Bij hoge belasting kunnen requests in een wachtrij komen en langer duren. De API verwerkt requests sequentieel, dus latency varieert afhankelijk van de huidige serverbelasting.
Hoeveel data verbruikt een API verzoek?
Elk verzoek telt mee voor je karakterlimiet. De prijs is $0,01 per 1.000 tekens, inclusief spaties en leestekens. Je kunt maximaal 4096 tekens per request versturen. Bij falen van de synthesise krijg je het bedrag volledig terug, dus je verbruikt geen credit voor mislukte pogingen.
Is de API geschikt voor commercieel gebruik?
Ja, de gegenereerde audio is bedoeld voor commercieel en ML-doeleinden. Elke audiofile bevat een onhoorbaar watermerk dat aangeeft dat het synthetische spraak is. De inputtekst wordt niet gebruikt voor training. Je kunt de bestanden vrij gebruiken zonder extra licentiekosten boven de API-tarieven.
Worden de audio bestanden gecomprimeerd?
Je kiest zelf het formaat: mp3, wav, opus, flac of pcm. Mp3 en opus zijn gecomprimeerd, terwijl wav en flac lossless zijn. PCM is onbewerkt. De keuze hangt af van je opslagbehoefte en compatibiliteit met je ML-pipeline. De API retourneert het bestand direct in het gekozen formaat.
Kan ik de API combineren met andere tools?
Zeker. De API volgt de requeststructuur van de OpenAI speech endpoint. Je kunt de officiële OpenAI SDKs gebruiken door de base_url aan te passen naar https://api.r38.info/v1. Dit maakt integratie met bestaande Python, Node.js of andere applicaties eenvoudig zonder nieuwe client libraries te schrijven.
Wat is een voice preset?
Een voice preset is een van de acht vaste stemopties: Aria, Nova, Luna, Sage, Felix, Milo, Atlas of Orion. Elke preset heeft een specifieke klankkleur, zoals 'warm' of 'energiek'. Je selecteert deze via het 'voice'-veld in je JSON-request. De stemmen zijn gebaseerd op gelicentieerde opnames.
Hoe kies ik de juiste voice voor mijn dataset?
Kies op basis van de gewenste toon voor je ML-model. Aria is een warme verteller, Felix is energiek voor promo’s, en Atlas is neutraal voor nieuws. Test verschillende presets met je tekst. Omdat de voices statisch zijn, blijft de klank consistent over je hele dataset, wat belangrijk is voor training.
Zijn er beperkingen aan de tekstlengte?
Ja, maximaal 4096 tekens per API-request. Voor langere teksten moet je ze splitsen in delen van deze lengte. Je ontvangt dan meerdere audiobestanden die je zelf moet samenvoegen tot één bestand. Dit is een technische beperking van de endpointstructuur, niet van de synthesise-engine zelf.
Kan ik de API batchsgewijs gebruiken?
Ja, je kunt meerdere requests achter elkaar sturen. Omdat requests sequentieel worden verwerkt, kunnen ze in een wachtrij komen bij hoge belasting. Je kunt dit automatiseren via scripts. Houd rekening met de rate limit van 60 requests per minuut per key voor optimale prestaties bij grote datasets.
Hoe werkt de taalherkenning?
De API detecteert de taal automatisch op basis van het script. Latijnse tekst wordt standaard als Engels geïnterpreteerd. Voor andere talen met Latijns schrift, zoals Nederlands of Frans, moet je het 'language'-veld expliciet instellen met de ISO-code. Dit voorkomt foutieve uitspraak van niet-Engelse teksten.
Definitie van TTS API
Een TTS API (Text-to-Speech API) is een cloudservice die tekst omzet in gesproken audio via een standaard endpoint. In plaats van lokale software te draaien, verstuur je een HTTP POST-request naar een JSON-endpoint en ontvang je direct een audiobestand terug. Dit stelt indie developers in staat om synthetische spraak naadloos te integreren in hun applicaties zonder dat ze zelf de audio-engine hoeven te beheren.
Wat is de API?
De API fungeert als een brug tussen je code en de synthese-engine. Je stuurt de tekst als input mee in een JSON-body en krijgt een geluidsbestand terug in formaten zoals MP3, WAV, OPUS, FLAC of PCM. De structuur is vergelijkbaar met de OpenAI speech-endpoint, wat betekent dat je bestaande SDKs kunt blijven gebruiken door de base_url aan te passen.
- Standaardiseert de conversie van tekst naar audio
- Ondersteunt meerdere audioformaten voor verschillende use cases
- Geen installatie van software nodig op de client
Klant-server model
Bij het klant-server model verloopt de verwerking op de server. Jij verstuurt de tekst en de server retourneert het resultaat. Dit is ideaal voor het genereren van grote datasets voor machine learning, omdat je rekenkracht niet gebonden is aan je eigen hardware. Je gebruikt het endpoint POST https://api.r38.info/v1/audio/speech met je API-key in de header.
- Verwerking vindt volledig op de server plaats
- Client heeft geen zware hardware nodig
- Snel en direct resultaat na verzending
Cloud basis
De API is volledig cloudgebaseerd, wat betekent dat je altijd toegang hebt tot de laatste engine-versies zonder updates te hoeven installeren. De infrastructuur zorgt voor de schaalbaarheid die nodig is bij het genereren van duizenden uren aan trainingsdata. Je betaalt alleen voor het verbruik, zonder vaste kosten voor serveronderhoud.
- Geen hardware-investering nodig
- Automatische schaling bij hoge volumes
- Altijd de meest recente engine-versie
Werking van de API
De API verwerkt tekst via een eenvoudige POST-request naar /v1/audio/speech. Je levert een JSON-body met het model, de gewenste voice en het te converteren inputtekst, dat maximaal 4096 karakters mag bevatten voor één verzoek.
Na ontvangst analyseert de cloud-engine de tekst, past de opgegeven snelheid en taal toe, en genereert de audio. Mocht de synthesefout optreden, dan krijg je de kosten terug zonder dat er geld van je saldo wordt afgeschreven.
Input tekst
Je stuurt je tekst als JSON-veld input. Het systeem accepteert teksten tot 4096 karakters per verzoek. Voor langere teksten splitst u deze in delen van maximaal 4096 karakters en voegt u de audiobestanden later samen.
De language parameter is optioneel; de API detecteert deze automatisch, maar je kunt een ISO-code specificeren voor preciezere resultaten bij niet-Engelse Latijnse teksten.
- Maximaal 4096 karakters per request
- Optionele
languageISO-code
Verwerking
De API verwerkt verzoeken sequentieel. Bij hoge belasting kunnen requests in een wachtrij komen. De gemiddelde snelheid is ongeveer real-time (25 karakters per seconde), maar korte zinnen kunnen enkele seconden duren.
De engine ondersteunt snelheden tussen 0.25x en 4.0x. Fouten bij de synthesefase resulteren in een volledige terugboeking van de kosten.
Output audio
Je ontvangt het audiobestand direct in de HTTP-response. Je kunt kiezen uit formaten zoals MP3, WAV, OPUS, FLAC of PCM. Het formaat bepaalt de balans tussen bestandsgrootte en kwaliteit.
Elk gegenereerd bestand bevat een onhoorbaar watermerk dat aangeeft dat het synthetische spraak betreft, wat nuttig is voor het traceren van ML-datasets.
- Formats: mp3, wav, opus, flac, pcm
- Onhoorbaar watermerk in elke file
Gebruik in ML
Een TTS API is essentieel voor het genereren van synthetische spraakdata voor machine learning-modellen. Door tekst naar audio om te zetten, kunnen ontwikkelaars grote datasets creëren zonder dure studiokosten of sessies met menselijke voice-over artiesten.
Dataset generatie
Met de SpraakKern API kun je snel honderden uren aan audio genereren door teksten in te voeren. Dit versnelt het trainingsproces voor NLP-modellen aanzienlijk, omdat je niet afhankelijk bent van het beschikbaar zijn van menselijke sprekers.
- Genereer audio op grote schaal voor trainingsdata
- Ondersteuning voor 23 talen voor multilinguale modellen
- Automatische taalherkenning bij ontbrekend 'language' veld
Stem consistentie
Voor consistente datasetkwaliteit kies je een vaste voice preset. Elke gegenereerde clip klinkt als dezelfde spreker, wat cruciaal is voor modellen die gevoelig zijn voor variatie in timbre en intonatie.
- 8 vaste presets voor uniforme geluidskwaliteit
- Invisibel watermark markeert synthetische spraak
- Geen variatie door wisselende menselijke acteurs
Schaalbaarheid
De API verwerkt requests op een cloudinfrastructuur, wat betekent dat je datasets kunt uitbreiden zonder nieuwe hardware. Bij hoge belasting kunnen requests in de wachtrij komen, maar de prijs blijft transparant: $0,01 per 1.000 tekens.
- Geen limiet aan totale datasetgrootte
- Betaling per karakter, niet per minuut
- Automatische verwerking van lange teksten
Voordelen boven lokale TTS
Lokale TTS vereist vaak dure GPU's en geheime afhankelijkheid van je eigen infrastructuur. Met een cloud-API zoals SpraakKern draait de syntheseprocess in onze cloud. Je hebt geen dure hardware nodig om grote datasetmengen te genereren voor ML-modellen.
Geen hardware nodig
Je verspill geen capaciteit aan het onderhouden van servers voor batch-generatie. De API verwerkt de tekst en levert direct audio-bestanden op via een eenvoudige HTTP-request.
Automatisch schalen
Of je nu 100 of 100.000 karakters wilt converteren, de infrastructuur past zich aan. Geen wachtrijen bij lage volumes; bij hoge belasting worden verzoeken verwerkt volgens de capaciteit van de API.
Updates door provider
Modelverbeteringen en bugfixes worden door ons geïmplementeerd zonder dat jij je code hoeft aan te passen. Je profiteert altijd van de nieuwste synthesetechniek zonder extra ontwikkelkosten.
Nadelen en beperkingen
Spreken over de beperkingen van de SpraakKern API is essentieel voor indie developers die grote datasets genereren. Hoewel de API betrouwbaar is, zijn er duidelijke randvoorwaarden die je architectuur moeten beïnvloeren. Het gaat hier niet om hype, maar om de feitelijke werking van het systeem.
De volgende sectie belicht drie cruciale aandachtspunten: de afhankelijkheid van internetverbindingen, het verbruiksmodel en de technische limieten van de invoer.
Internet afhankelijk
Omdat het een cloudgebaseerde API is, vereist elke syntheserequest een actieve internetverbinding. Er is geen lokale cache of offline modus mogelijk. Bij onderbreking van de verbinding of hoge latency, moet je implementatie een backoff-strategie gebruiken om requests te herhalen.
Kosten per gebruik
Het tarief is transparant: $10 per miljoen tekens. Er zijn geen vaste abonnementskosten of seats, wat ideaal is voor projectgebonden budgetten. Let op dat mislukte requests gratis blijven, maar succesvolle synthesen direct in rekening worden gebracht. De minimale top-up is $5 via USDT (TRC-20).
Karakter limieten
Elke single request is beperkt tot 4.096 tekens. Voor langere teksten moet je zelf split-en join-tools bouwen of een middleware gebruiken. Ruimtes en leestekens tellen mee in deze limiet. Bij hoge belasting kan verwerking in een wachtrij terechtkomen, wat de totale laadtijd verhoogt.
- Max. 4.096 tekens per request
- Ruimtes en leestekens tellen mee
- Geen SSML voor fine-grained control
Data formaten
Bij het genereren van datasets voor machine learning is de keuze van het audioformaat cruciaal voor de efficiëntie van je pipeline. Onze API ondersteunt MP3, WAV, OPUS, FLAC en PCM, waardoor je direct de juiste balans kunt kiezen tussen bestandsgrootte en verwerkingslast zonder extra conversiestappen.
De API levert de audio direct terug in de gevraagde structuur. Voor ML-workflows waarbij consistentie en lage overhead belangrijk zijn, kies je vaak voor PCM of WAV. Bij grote volumes waar opslagkosten tellen, biedt MP3 of OPUS een compactere oplossing.
MP3 vs WAV
WAV is een lossless formaat dat de volledige audiokwaliteit behoudt, ideaal voor trainingdata waar elke nuance van de synthetische stem relevant is voor het model. MP3 daarentegen is gecomprimeerd en vermindert de bestandsgrootte aanzienlijk, wat de I/O-prestaties van je dataset verhoogt.
- WAV: lossless, hoge resolutie, grotere bestanden
- MP3: gecomprimeerd, kleinere bestanden, geschikt voor opslag
Compressie
Onze API biedt zowel gecomprimeerde (MP3, OPUS) als ongedecomprimeerde (WAV, FLAC, PCM) opties. FLAC behoudt lossless kwaliteit met kleinere bestanden dan WAV, maar vereist mogelijk extra CPU-resources bij het decoderen door je model. OPUS biedt hoge compressie bij behoud van speech-kwaliteit.
- OPUS: hoge compressie, lage bitrate
- FLAC: lossless, compactere dan WAV
Kwaliteit vs grootte
De keuze hangt af van je gebruik. Voor voice assistants of eindgebruikersaudio is MP3 vaak voldoende. Voor NLP-training of fonemische analyse kan WAV of FLAC nodig zijn om artefacten te minimaliseren. Houd er rekening mee dat elk formaat dezelfde tekstinput verwerkt via hetzelfde model.
Authenticatie
Authenticatie bij SpraakKern gebeurt via een unieke API-sleutel die je opmaakt op /get-api-key/. Deze sleutel (startend met "tts-") identificeert je account en koppelt verbruik direct aan je saldo.
API Key nodig
Elke request vereist de header Authorization: Bearer tts-.... Zonder geldige sleutel wordt je verzoek geweigerd. De sleutel is gekoppeld aan één account per site.
Veiligheid
Gebruik HTTPS om de sleutel te beschermen bij het verzenden. De sleutel fungeert als enkel auth-middel; er is geen extra token-systeem nodig.
- HTTPS is verplicht voor betrouwbare verbinding.
- Sleutel geeft volledige toegang tot je saldo.
Key management
Je kunt op elk moment een nieuwe sleutel genereren. De oude sleutel wordt direct ongeldig, waardoor je snel kunt schakelen bij verdacht gebruik.
- Directe invalidatie van oude keys.
- Onbeperkt aantal keren vernieuwen.

Integratie opties
SpraakKern is ontworpen als een directe vervanger voor de OpenAI Audio API. Door dezelfde requeststructuur te gebruiken, kun je bestaande integraties snel aanpassen zonder ingewikkelde migraties.
Het systeem verwacht JSON-payloads met model, input, voice en format. De respons is direct een audiobestand, klaar voor opslag of verwerking in je ML-pipeline.
HTTP requests
Stuur een POST-request naar https://api.r38.info/v1/audio/speech. Je levert de tekst mee via het veld 'input' en specificeert het formaat via 'response_format'. De API retourneert het audio bestand direct in de response body, zonder tussenkomst van tussenformaten.
- Gebruik de endpoint POST /v1/audio/speech
- Stel 'response_format' in op wav, mp3, opus, flac of pcm
SDKs
Je kunt de officiële OpenAI SDK’s gebruiken door de 'base_url' aan te passen naar https://api.r38.info/v1. Dit maakt migratie van bestaande codebases vrijwel nulwerk. Je gebruikt dezelfde methodes voor het genereren van spraak als bij de standaard provider.
- Pas 'base_url' aan naar de r38.info endpoint
- Gebruik de standaard OpenAI Python of Node.js SDKs
Curl
Voor directe testing of scripts is cURL een snelle optie. Je voegt je API-key toe in de Authorization header en stuur de JSON body naar de speech endpoint. Dit is ideaal voor snelle validatie van tekst en voice combinaties.
- Voeg 'Authorization: Bearer tts-...' toe aan de headers
- Stuur de tekst via de 'input' parameter in de JSON body
Voorbeelden van gebruik
TTS API's zijn essentieel voor het automatiseren van audio-productie bij indie developers. In plaats van handmatig opnames te maken, verzenden je tekst naar de API en ontvang je direct een audiobestand.
Dit werkt betrouwbaar voor grote volumes, zoals het genereren van duizenden zinnen voor modeltraining of het snel beschikbaar stellen van audioboeken in verschillende talen.
Audioboeken
Met de SpraakKern API kun je volledige boeken omzetten naar audio. Je splitst grote teksten in delen van maximaal 4096 karakters en voegt de audio's later samen.
Dit is ideaal voor het snel produceren van luisterboeken zonder de overhead van een studio.
- Ondersteuning voor 23 talen
- Keuze uit 8 unieke stemmen
- Consistente kwaliteit over lange teksten
NLP training
Voor machine learning is veel gelabelde audio nodig. De API levert synthetische datasets met consistente stemmen, ideaal voor het trainen van speech-to-text modellen.
De inputtekst wordt niet gebruikt voor training van de TTS zelf, wat de data-integriteit waarborgt.
- Snelle generatie van grote datasets
- Transparante kosten per karakter
- Geen royalty's voor gebruik
Voice assistants
Ontwikkelaars gebruiken de API om voice assistants van tekst te voorzien. De API accepteert standaard HTTP requests, wat integratie in bestaande pipelines vergemakkelijkt.
Hoewel er geen streaming is, is de latency acceptabel voor niet-interactieve prompts.
- Laagdrempelige integratie
- Ondersteuning voor MP3 en WAV
- Snel schalen bij hoge vraag
Toekomst van TTS
De huidige API levert al hoge kwaliteit, maar de focus ligt op verdere verfijning van de synthetische spraak. Door continue training met uitgebreidere datasets worden de overgangen tussen zinsdelen natuurlijker en verminderen artefacten bij complexe zinsconstructies.
Dit stelt indie developers in staat om hun ML-modellen sneller te globaliseren zonder extra integratiekosten voor nieuwe talen.
Kwaliteit verbetering
De focus ligt op het verfijnen van de intonatie en het ritme van de gegenereerde audio. Door het gebruik van geavanceerdere modellen worden de overgangen tussen zinsdelen natuurlijker en worden kleine artefacten bij complexe zinsconstructies geminimaliseerd.
Meer talen
Dit stelt developers in staat hun datasets voor machine learning direct te globaliseren zonder extra integratiekosten voor nieuwe talen.
Real-time
Hoewel we momenteel geen streaming ondersteunen, optimaliseren we de verwerkingstijd voor korte fragmenten. Doel is het versnellen van de wachttijd in de wachtrij bij hoge belasting, zodat responsen sneller beschikbaar zijn voor latency-kritische toepassingen.
Samenvatting
SpraakKern biedt een betrouwbare cloud-TTS API voor indie developers die synthetische spraakdata nodig hebben. Met 8 consistente stemmen, 23 talen en transparante tarieven van $10 per miljoen tekens is het ideaal voor ML-datasets. Geen overhead, geen verrassingen.
Kernpunten
De API accepteert tekst via POST requests en levert audio bestanden op. Met een limiet van 4096 tekens per verzoek en real-time snelheid op lange teksten is het efficiënt voor batchverwerking. Fouten worden gratis verrekend.
Waarom API
Dankzij de cloudinfrastructuur hoef je geen hardware in te kopen of te onderhouden. Je betaalt alleen voor wat je gebruikt, zonder abonnementskosten. De API past zich automatisch aan aan wisselende laadverdeling.
Volgende stappen
Start nu met een gratis proefaccount van $0,50 geldig voor 7 dagen. Registreer je via /get-api-key/ en start direct met het genereren van je eerste audio-bestanden voor je machine learning modellen.
Gerelateerde topics
Voor indie developers die synthetische spraak gebruiken voor machine learning-modellen, is de kwaliteit van de onderliggende data cruciaal. Dit vereist kennis van data annotatie om audiocorrecte tijdlijnen te maken, model training om patronen te herkennen, en audio processing voor formatconversie.
Data annotatie
Bij het genereren van datasets voor NLP is precieze transcriptie essentieel. TTS API’s zoals SpraakKern leveren consistente audio die eenvoudig te koppelen is aan gelabelde tekst, wat de handmatige annotatieversnelt.
Model training
Synthetische spraak verhoogt de hoeveelheid beschikbare trainingsdata aanzienlijk zonder dure opnamesessies. Het gebruikt van APIgegenereerde audio stelt ontwikkelaars in staat om robuustere spraakmodellen te trainen met variërende intonaties en talen.
Audio processing
De gegenereerde bestanden vereisen vaak naverwerking, zoals het samenvoegen van segments of het converteren naar specifieke formaten zoals FLAC of WAV voor optimale kwaliteit. Het begrijpen van sample rates en bitdepths is noodzakelijk voor een naadloze integratie in ML-pipelines.
Luister naar de 8 stemmen
Elk voorbeeld hieronder is gegenereerd door deze API met dezelfde zin. Van registratie tot de eerste audio file duurt het slechts enkele minuten.
23 talen
Elke stem kan elke van deze talen spreken.
