Hoe converteer ik tekst naar spraak voor navigatie?

Door NavigoZeg redactie · Bijgewerkt 2026-11-19

Deze gids laat je zien hoe je NavigoZeg’s tekst-naar-spraak API integreert in navigatie-apparaten en in-car systemen. We nemen je mee door de complete workflow: van het voorbereiden van korte route-instructies tot het verwerken van het gegenereerde audio-bestand. Je leert welke stemmen het beste werken voor voice-guidance en hoe je de API-opties instelt voor optimale prestaties in mobiele omgevingen.

Ideaal voor indie developers die snelle, lichte audio-bestanden nodig hebben voor dashboards of automatische nieuwsupdates. Je vindt concrete voorbeelden voor het versturen van requests, het afhandelen van fouten en het schalen van je implementatie. Begin direct met de gratis proefversie om de kwaliteit en snelheid van de synthese te testen voordat je je app integreert.

Hoe converteer ik tekst naar spraak voor navigatie?

Veelgestelde vragen

Wat is de beste voice voor navigatie-instructies?

Atlas is het meest geschikt voor navigatie-instructies vanwege de neutrale, nieuwsachtige toon. Sage biedt een kalme, instructieve stem die goed werkt voor gedetailleerde routebeschrijvingen. Aria’s warme vertelstijl is ideaal voor langere mededelingen. Alle acht stemmen ondersteunen 23 talen, zodat je consistente voice guidance kunt leveren over verschillende regio's in je navigatie-app of in-car entertainment systeem.

Hoe lang mag een tekst zijn voor één request?

Elke request mag maximaal 4096 tekens bevatten. Voor langere teksten splits je de tekst in delen van deze lengte en voeg je de gegenereerde audio-bestanden achteraf samen. Dit zorgt ervoor dat de API elke instructie efficiënt verwerkt zonder limietoverschrijdingen tijdens de conversie.

Welk audioformaat is het beste voor mobiele apparaten?

MP3 is het meest compatibel met mobiele navigatie-apparaten en dashboards. Het biedt een goede balans tussen bestandsgrootte en geluidskwaliteit. Je kunt ook WAV of OPUS kiezen, afhankelijk van je specifieke implementatievereisten. FLAC en PCM zijn beschikbaar voor hogere kwaliteit of specifieke use-cases.

Kan ik de snelheid van de speech aanpassen?

Ja, je kunt de snelheid instellen tussen 0.25 en 4.0. Dit stelt je in staat de spraakversnelling aan te passen aan de behoeften van de gebruiker of de snelheid van de navigatie-instructies. Standaard is de snelheid normaal, maar je kunt dit volledig controleren.

Hoe herken ik de taal automatisch?

Als je het veld 'language' niet instelt, wordt de taal geraden op basis van het script. Latijnse tekst wordt standaard als Engels herkend. Voor andere talen met Latijns schrift moet je de 'language'-parameter expliciet instellen op de ISO-code om fouten te voorkomen.

Wat zijn de rate limits voor de API?

Je hebt 60 requests per minuut per sleutel, mits je saldo positief is. Voor nieuwe accounts zonder top-up is dit 10 requests per minuut. Dit is voldoende voor de meeste navigatie-applicaties. Bij hoge belasting kunnen requests in wachtrij komen te staan.

Hoe verwerk ik fouten in mijn code?

Foute requests worden gratis en het bedrag wordt volledig teruggeboekt. Je kunt de API-statuscodes gebruiken om fouten te detecteren. Als er een fout optreedt, wordt de tekst niet gefactureerd. Zorg dat je code foutafhandeling implementeert voor een robuuste navigatie-ervaring.

Kan ik de audio offline afspelen?

Ja, de gegenereerde audio-bestanden worden direct in de response teruggegeven. Je kunt deze bestanden opslaan en offline afspelen op navigatie-apparaten of mobiele telefoons. De bestanden bevatten een onhoorbaar watermerk dat aangeeft dat het synthetische spraak is, maar dit beïnvloedt de afspeling niet.

Hoeveel kost het om 1 uur navigatie te genereren?

De kosten zijn $0.01 per 1000 tekens. Een uur navigatieaudio hangt af van de lengte van de instructies. Bij een typische snelheid van 25 tekens per seconde zijn dat 90.000 tekens, wat neerkomt op $0.90.

Wordt de tekst opgeslagen na conversie?

Nee, de ingevoerde tekst wordt alleen gebruikt om de audio te genereren en niet opgeslagen voor training. De gegenereerde audio wordt ook niet opgeslagen na verzending. Alleen metadata zoals tijd, tekens en status wordt bewaard voor facturatie doeleinden. Je privacy blijft gewaarborgd.

Kan ik meerdere talen in één tekst gebruiken?

Ja, je kunt meerdere talen in één tekst gebruiken. De API detecteert de taal automatisch op basis van het script, of je kunt de 'language'-parameter instellen. Als je een specifieke taal wilt forceren, stel dan de ISO-code in in het veld 'language' voor de hele request.

Hoe test ik de API voor navigatie?

Gebruik de gratis proefversie van $0.50 bij aanmelding via Google. Dit geeft je 50.000 tekens om de API te testen. Je kunt de curl-voorbeelden op de /get-api-key/ pagina gebruiken om direct te experimenteren met verschillende stemmen en talen voor je navigatie-applicatie.

Is er een limiet aan het aantal woorden?

Er is geen limiet aan het aantal woorden, maar wel aan het aantal tekens per request: maximaal 4096 tekens. Voor langere teksten moet je ze splitsen en de audio-bestanden later samenvoegen. Dit zorgt ervoor dat je elke lengte navigatie-instructies kunt genereren.

Hoe kies ik de juiste taal voor een regio?

Stel de 'language'-parameter in op de ISO-code van de gewenste taal. Bijvoorbeeld 'nl' voor Nederlands of 'de' voor Duits. Als je dit niet doet, wordt de taal geraden op basis van het script. Voor Latijnse tekst wordt standaard Engels gebruikt, dus stel de taal expliciet in voor andere talen.

Bereid je tekst voor voor conversie

Geluidsgolfillustratie voor: Bereid je tekst voor voor conversie

Voor navigatie-apparaten en dashboards is helderheid cruciaal. Bereid je tekst voor door korte, actieve zinnen te gebruiken voor route-instructies. Dit zorgt voor natuurlijkere voice-guidance en voorkomt dat luisteraars tekst moeten ontcijferen tijdens het rijden.

Korte zinnen voor route-instructies

Houd instructies bondig en specifiek. Vermijd complexe bijzinconstructies die de synthese vertragen of onduidelijk maken. Korte zinnen zoals 'Sla rechtsaf bij de volgende afslag' werken beter dan lange beschrijvingen met veel details.

Vermijd speciale tekens in de input

Verwijder onnodige symbolen zoals accolades, haakjes of niet-standaard leestekens uit je input tekst. Dit vermindert het risico op onnatuurlijke pauzes of foutieve uitspraak tijdens de conversie naar audio.

Split lange teksten in delen van 4096 tekens

De API accepteert maximaal 4096 tekens per request. Voor langere tekstblokken, zoals automatische nieuwsupdates, deel je de tekst eerst op. Je kunt de resulterende audio-bestanden daarna samenvoegen tot één bestand voor afspelen in je in-car entertainment systeem.

Kies de juiste voice voor navigatie

Geluidsgolfillustratie voor: Kies de juiste voice voor navigatie

De keuze van de voice beïnvloedt direct hoe gebruikers route-instructies en updates ontvangen. NavigoZeg biedt acht vaste presets die zijn gebaseerd op gelicenseerde opnames. Voor navigatie-apparaten en in-car entertainment systemen zijn drie stemmen het meest geschikt vanwege hun klankkarakter en duidelijkheid.

Gebruik de juiste voice om de luisterervaring te optimaliseren. Elke voice heeft een specifieke toon die past bij het type tekst. Kies bewust voor Sage voor rustige instructies, Atlas voor neutrale updates, of Felix voor energieke bestemmingen.

Sage voor kalme routebeschrijvingen

Sage is een kalme, instructieve vrouwelijke stem. Deze voice is ideaal voor langdurige route-instructies waarbij rust en helderheid belangrijk zijn. De neutrale toon zorgt ervoor dat gebruikers de informatie rustig kunnen verwerken zonder afleiding.

Gebruik Sage voor complexe bochteninstructies of lange reeksen van aanwijzingen. De stem leent zich goed voor voice-guidance die continu wordt afgespeeld tijdens het rijden.

  • Ideaal voor langdurige route-instructies
  • Kalme en heldere klank
  • Geschikt voor continu voice-guidance

Atlas voor neutrale nieuwsupdates

Atlas is een neutrale mannelijke stem met een nieuwsachtig karakter. Deze voice is perfect voor het afspelen van verkeersinformatie, nieuwsupdates of officiële mededelingen. De neutrale toon zorgt voor een professionele uitstraling.

Gebruik Atlas voor segmenten die feitelijke informatie overbrengen zonder emotionele lading. De stem is duidelijk en verstoort de navigatie-ervaring niet met overbodige expressie.

  • Neutrale nieuwsachtige toon
  • Geschikt voor verkeersinformatie
  • Professionele uitstraling

Felix voor energieke bestemmingen

Felix is een energieke mannelijke stem die ideaal is voor het aankondigen van bestemmingen of speciale evenementen. De upbeat klank trekt de aandacht van de gebruiker en maakt het afspelen van bestemmingsinformatie levendiger.

Gebruik Felix wanneer je de gebruiker wil attenderen op een specifieke locatie of een feestelijke boodschap wilt overbrengen. De energie van de voice zorgt voor een positieve ervaring bij het bereiken van de bestemming.

  • Energieke en upbeat klank
  • Ideaal voor bestemmingsaankondigingen
  • Trekt de aandacht van de gebruiker

Stuur een request naar de API

Geluidsgolfillustratie voor: Stuur een request naar de API

Na het voorbereiden van je tekst en selecteren van de juiste voice, verzend je de data naar de API. De conversie verloopt via een eenvoudige POST-request die direct audio teruggeeft.

Het proces is ontworpen voor snelheid en betrouwbaarheid, essentieel voor real-time navigatie-instructies in je dashboard of in-car systeem.

Gebruik POST methode op de endpoint

Stuur je verzoek naar POST https://api.db222.info/v1/audio/speech. Dit endpoint accepteert JSON-gegevens en retourneert het gegenereerde audiobestand direct in de response. De structuur is compatibel met de OpenAI Speech API, waardoor je bestaande SDKs kunt blijven gebruiken door de base_url aan te passen.

Voeg API key toe als Bearer token

Authenticeer je request door je unieke sleutel mee te sturen in de header: Authorization: Bearer tts-.... Zorg dat je key actief is; bij het genereren van een nieuwe key stopt de oude direct. Dit voorkomt ongeautoriseerde toegang tot je account en facturatie.

Specificeer model en input tekst

Definieer het model als "tts-1" of "tts-1-hd" en voeg je tekst toe aan het input veld. Let op: de tekst mag maximaal 4096 tekens bevatten per request. Voor langere instructies splits je de tekst handmatig op en voeg je de audiobestanden later samen. Specificeer ook de voice en eventueel de language voor nauwkeurige uitspraak.

  • Model: tts-1 of tts-1-hd
  • Max. inputlengte: 4096 tekens
  • Verplichte headers: Authorization
  • Ondersteunde formats: mp3, wav, opus, flac, pcm

Verwerk de audio response

Geluidsgolfillustratie voor: Verwerk de audio response

De API retourneert het gegenereerde audiobestand direct in de response body. Je ontvangt een bestand in het opgegeven formaat, zoals MP3 of WAV, dat direct verwerkt kan worden door je navigatiesysteem.

Dit bestand is klaar voor afspelen of opslag. Omdat de API geen streaming ondersteunt, is het bestand compleet bij ontvangst, wat ideaal is voor stabiele voice-guidance in auto's.

Ontvangst van MP3 of WAV bestand

Na de POST-request ontvang je een audio-bestand in de response. Kies MP3 voor compacte bestandsgroottes, ideaal voor mobiele netwerken, of WAV voor hoge kwaliteit zonder compressieverlies.

Het formaat wordt bepaald door het response_format veld in je request. De API levert geen gedeeltelijke streams; het bestand is volledig gegenereerd voordat het wordt teruggestuurd.

  • MP3: klein formaat, geschikt voor bandbreedte-beperkte verbindingen
  • WAV: ongecomprimeerd, hoger verbruik maar groter bestand
  • Geen streaming; volledige ontvangst vereist voor afspelen

Afspelen via de audio-player van het apparaat

Speel het ontvangen bestand af via de standaard audio-speler van het navigatiedevice of dashboard. De audio begint direct na ontvangst, wat cruciaal is voor tijdkritische route-instructies.

Zorg dat je app de audio-prioriteit correct instelt, zodat navigatiegeluid voorrang krijgt op achtergrondmuziek tijdens het afspelen van de gegenereerde spraak.

  • Gebruik de native audio-speler van het besturingssysteem
  • Stel audio-focus in voor prioriteit ten opzichte van andere geluidsbronnen
  • Test afspelen bij verschillende snelheden (0.25–4.0x)

Opslag van audio voor offline gebruik

Sla het ontvangen audio-bestand op in het lokale opslagmedium van het apparaat voor offline gebruik. Dit is essentieel voor gebieden met slechte verbinding, zoals tunnels of landelijke gebieden.

De API slaat gegenereerde audio niet op; je bent zelf verantwoordelijk voor het beheren van de opgeslagen bestanden op je device.

Controleer de bestandsformaten en compatibiliteit van je opslagoplossing om ervoor te zorgen dat de audio correct wordt afgespeeld wanneer de GPS-positie verandert.

  • Opslag op device voor offline voice-guidance
  • Geen server-side opslag door NavigoZeg
  • Beheer bestanden zelf voor offline toepassing in auto's

Optimaliseer voor mobiele netwerken

Geluidsgolfillustratie voor: Optimaliseer voor mobiele netwerken

Navigatie-apparaten werken vaak in omgevingen met wisselende netwerkdekking, zoals tunnels of buitenstadsgebieden. Het kiezen van het juiste audiocodec is cruciaal om dataverbruik te minimaliseren en de laadtijd van route-instructies te versnellen. Een efficiënte codec zorgt ervoor dat je apparaat niet vastloopt tijdens het afspelen van kritieke stemmensen.

Door slim te kiezen tussen de beschikbare formaten, zorg je voor een betrouwbare user experience. MP3 biedt een goede balans tussen kwaliteit en bestandsgrootte, wat ideaal is voor mobiele netwerken waar bandbreedte beperkt kan zijn. Het vermindert de kans op buffering en zorgt voor snelle reactie van je navigatiesysteem.

Gebruik MP3 voor kleinere bestandsgroottes

MP3 is het meest geschikte formaat voor de meeste navigatie-applicaties. Het biedt een compacte bestandsgrootte zonder aanzienlijk verlies in verstaanbaarheid. Dit is essentieel wanneer je meerdere korte instructies snel achter elkaar moet laden via een mobiele verbinding.

Vergelijk het met WAV, dat ruwweg vijf keer zo groot is. Voor een navigatiesysteem dat continu nieuwe routes berekent, maakt dit verschil in data-verbruik en laadtijd significant uit, vooral op oudere apparaten met beperkte geheugen.

  • MP3 biedt een goede balans tussen kwaliteit en bestandsgrootte.
  • Minder dataverbruik betekent snellere ophaling van instructies.
  • Beter voor apparaten met beperkte opslagruimte.

Compressie van audio voor snelle laadtijden

Hoewel de API al geoptimaliseerde bestanden levert, kan het kiezen voor de juiste snelheid (speed parameter) de bestandsgrootte verder beïnvloeden. Een iets hogere snelheid kan de duur van de audio verkorten, wat resulteert in minder te downloaden bytes.

Het is belangrijk om de snelheid binnen de gestelde marges van 0.25 tot 4.0 te houden. Te snelle spraak kan de verstaanbaarheid bij ruis in de auto verminderen, terwijl te langzame spraak vertraging veroorzaakt bij het laden van de volgende instructie.

  • Pas de snelheid aan om de audioduur te minimaliseren.
  • Houd de verstaanbaarheid hoog voor gebruik in de auto.
  • Test verschillende snelheden onder ruisomstandigheden.

Bufferen van audio voor vloeiend afspelen

Bufferen voorkomt dat de audio stopt tijdens het afspelen van een lange route-instructie. Door de volgende audiofragmenten voor te laden terwijl de huidige nog speelt, voorkom je haperingen bij slechte netwerkverbindingen.

Implementeer een buffer die minimaal twee instructies vasthoudt. Dit zorgt voor een naadloze overgang tussen zinnen en voorkomt dat de gebruiker stilte hoort tijdens het ophalen van de volgende tekst.

Zorg ervoor dat je applicatie feedback geeft als de buffer leegraakt, zodat de gebruiker weet dat er even gewacht wordt op een nieuwe instructie.

Test je implementatie met de gratis proefversie

Geluidsgolfillustratie voor: Test je implementatie met de gratis proefversie

De gratis proefversie van $0,50 is de snelste manier om je navigatie-API te valideren. Je ontvangt dit krediet direct na aanmelding via Google, waarmee je ongeveer 50.000 tekens kunt genereren. Dit volume is voldoende om de basisfunctionaliteit en geluidskwaliteit te testen zonder financiële verplichting.

Gebruik de API sleutel uit je dashboard om een eerste synthes-request te sturen. Controleer of de gegenereerde audio correct wordt afgespeeld in je testomgeving en of de snelheid voldoet aan de vereisten voor real-time navigatie-instructies.

Aanmelden met Google voor $0.50 credit

Registreer je op de /get-api-key/ pagina met je Google-account. Je ontvangt direct $0,50 aan testkrediet, geldig voor 7 dagen. Dit krediet kan worden gebruikt voor het genereren van audio-bestanden via de API.

  • Aanmelden via Google-account
  • Directe toekenning van $0,50 krediet
  • Geldigheid van 7 dagen

Stuur een test request met korte tekst

Gebruik de endpoint POST https://api.db222.info/v1/audio/speech met een korte tekst, zoals 'Volg de volgende afslag naar links'. Zorg dat je API sleutel correct wordt meegegeven als Bearer token in de header.

  • Gebruik POST methode op de juiste endpoint
  • Stuur korte tekst als input
  • Voeg API sleutel toe als Bearer token

Controleer de audio kwaliteit en snelheid

Ontvang het gegenereerde audio-bestand en controleer de uitspraak en duidelijkheid. Verifieer of de generatietijd voldoet aan de verwachtingen van real-time navigatie. Experimenteer met verschillende voices zoals 'sage' voor kalme instructies.

  • Controleer uitspraak en duidelijkheid
  • Verifieer generatietijd
  • Experimenteer met verschillende voices

Handel fouten correct af

Geluidsgolfillustratie voor: Handel fouten correct af

Bij het converteren van route-instructies naar audio kunnen netwerkstabiliteit en API-beperkingen de stroom verstoren. Een robuuste foutafhandeling zorgt ervoor dat gebruikers nooit stil blijven staan bij een missing voice-guidance bericht, zelfs onder wisselende netwerkcondities.

Herstuur requests bij timeout fouten

Wacht niet op oneindige laadtijden. Als de synthesetime-out optreedt, herhaal de request met dezelfde parameters. Omdat mislukte requests gratis zijn, kun je veilig retryen zonder kosten. Voor lange teksten is het essentieel om elke segment apart te verwerken, zodat slechts één fout de rest niet blokkeert.

  • Gebruik een retry-mechanisme met exponentiële back-off
  • Splits grote tekstblokken vooraf in chunks van 4096 tekens
  • Herstel alleen de gefaalde segmenten, niet de hele tekst

Controleer rate limits bij hoge volume

Je account is beperkt tot 60 requests per minuut. Overschrijding resulteert in een 429-foutcode. Monitor je verbruik in het dashboard of bereken dit zelf aan de hand van je tekstlengte en het aantal unieke voices. Bij hogere eisen kun je de limiet verlagen door parallelle verwerking te minimaliseren of te wachten tot de quota zich resetten.

  • Maximaal 60 requests per minuut per key
  • 10 requests per minuut voor nieuwe accounts zonder top-up
  • Gebruik een queue-systeem voor batch-verwerking

Log foutmeldingen voor debugging

Log de response codes en tijdsduur van elke request. Dit helpt bij het identificeren van patronen in fouten, zoals specifieke voices die langer nodig hebben of talen die fouten veroorzaken bij bepaalde karakters. Bewaar ook de input tekst en de foutmelding voor later onderzoek zonder je gebruikersdata op te slaan.

  • Log HTTP status codes (bijv. 429, 500)
  • Stel een time-out limiet in voor je client
  • Houd metadata van tijd, karakters en status bij voor facturatie
Handel fouten correct af

Schalen voor grote gebruiksbase

Geluidsgolfillustratie voor: Schalen voor grote gebruiksbase

Om je navigatie-API te laten schalen bij groeiend gebruik, begin je met het verhoogden van je rate limits. Door middel van een top-up met USDT op het TRON-netwerk (TRC-20) ontvang je direct meer bandbreedte, wat essentieel is voor hogere volumes.

Voor de snelste reactietijden kun je parallelle requests gebruiken. Omdat requests sequentieel worden verwerkt, zorgt deze aanpak ervoor dat je dashboard of in-car systeem sneller audio genereert zonder lange wachttijden in de wachtrij.

Verhoog rate limits met top-ups

Standaard is je limiet 60 requests per minuut per key. Door een top-up uit te voeren, verhoog je deze limiet direct. De credit wordt automatisch verwerkt binnen minuten na de overdracht van USTRC-20 tokens.

Er zijn geen maandelijkse abonnementen of vaste limieten. Je betaalt alleen voor wat je gebruikt, waardoor je flexibel kunt schalen zonder vaste kosten voor onbenodigde capaciteit.

  • Minimale top-up van $5
  • Credit wordt automatisch verwerkt
  • Geen vaste maandelijkse kosten

Gebruik parallelle requests voor snelheid

Requests worden één voor één verwerkt. Door meerdere API-aanroepen tegelijkertijd te sturen, verklein je de totale wachttijd voor complexe navigatie-sets. Dit is ideaal voor het genereren van meerdere route-instructies in één keer.

Zorg ervoor dat je API-key correct wordt meegestuurd in de Authorization header. Elk request telt mee voor je verbruik en rate limit, dus monitor je verbruik nauwkeurig.

  • Verwerk requests parallel
  • Vermijd lange wachtrijtijden
  • Controleer API-key per request

Monitor verbruik in het dashboard

Houd je verbruik in de gaten via het dashboard op de website. Je ziet direct je resterende saldo, het aantal verbruikte tekens en je huidige rate limit status. Dit helpt je om verrassingen bij de facturatie te voorkomen.

Gebruik de gegevens om je implementatie te optimaliseren. Als je merkt dat je vaak tegen de rate limit aanloopt, overweeg dan een top-up of pas je request-strategie aan.

  • Realtime saldo-oversicht
  • Volg verbruik per request
  • Optimaliseer je API-strategie

Gebruik de juiste talen voor regio's

Geluidsgolfillustratie voor: Gebruik de juiste talen voor regio's

Navigatie vereist heldere, begrijpelijke instructies in de taal van de gebruiker. Hoewel de API 23 talen ondersteunt en automatisch de taal gisst op basis van het script, is het bij Latijnse teksten buiten het Engels essentieel om het veld language expliciet in te stellen. Dit voorkomt foutieve uitspraak en zorgt voor een consistente ervaring.

Stel taal expliciet in voor Latijnse teksten

Standaard wordt Latijnse tekst geïnterpreteerd als Engels. Stel de language parameter expliciet in op de ISO-code (bijv. nl voor Nederlands, de voor Duits) om de correcte fonetische regels van de geselecteerde voice te activeren. Dit is cruciaal voor route-instructies waar verkeerde benamingen van straten of landen verwarring kunnen veroorzaken.

Gebruik native stemmen voor elk land

De acht beschikbare voices zijn ontworpen om natuurlijk te klinken in hun respectievelijke taalkundige context. Voor navigatie in Nederland of Vlaanderen biedt sage (calm, instructional) een neutrale, rustige toon die geschikt is voor langdurige luisterervaringen in de auto. Voor Engelstalige navigatie in internationale contexten is atlas (neutral, news) een sterke keuze.

Test uitspraak in lokale dialecten

Hoewel de API standaardtalen ondersteunt, zijn dialecten zoals Zweeds of Zweeds-Zweden niet expliciet gespecificeerd als aparte varianten. De API gebruikt een uniforme uitspraak voor de gespecificeerde taalcode. Test daarom altijd de output met specifieke plaatsnamen en afkortingen die in jouw doelregio voorkomen om te verifiëren dat de synthesizer deze correct leest.

Integreer met bestaande navigatie software

Geluidsgolfillustratie voor: Integreer met bestaande navigatie software

Integreer de NavigoZeg API naadloos in je bestaande navigatiestack door de TTS-endpoint te koppelen aan je route-algoritme. Stel de base_url in op https://api.db222.info/v1 en gebruik dezelfde JSON-structuur als de OpenAI SDK, zodat je bestaande code minimal hoeft aan te passen. Dit zorgt voor een directe koppeling tussen geografische data en audio-uitvoer.

De gegenereerde audio-bestanden kunnen direct worden ingelezen in je dashboardinterface of in-car systeem. Omdat de API tekst naar audio converteert, kun je dynamische instructies genereren op basis van real-time verkeersdata of POI-wijzigingen, zonder vaste audio-bestanden te hoeven beheren.

Koppel API aan je route-algoritme

Verbind je route-engine met de API door tekstfragmenten (zoals 'Ga linksaf over 200 meter') direct naar de endpoint te sturen. Het algoritme bepaalt de juiste momenten voor conversie, waarbij je de voice parameter kunt instellen op 'sage' voor kalme instructies of 'atlas' voor neutrale updates.

  • Gebruik POST https://api.db222.info/v1/audio/speech voor conversie
  • Stel base_url in voor compatibiliteit met bestaande SDKs
  • Kies voice 'sage' voor route-instructies of 'atlas' voor nieuws

Gebruik de audio in je dashboard interface

Ontvang het audio-bestand (mp3, wav, opus, flac of pcm) in de response en speel het af in de gebruikersinterface. Omdat de bestanden lichtgewicht zijn, verloopt het afspelen soepel op zowel dashboards als in-car systemen. Je kunt de speed parameter aanpassen om de narratie te versnellen of vertragen naar behoeve.

  • Ondersteuning voor mp3, wav, opus, flac en pcm formaten
  • Gebruik de speed parameter (0.25–4.0) voor aanpasbare snelheid
  • Directe integratie van audio-bestanden in web- of mobiele interfaces

Syncroniseer voice-guidance met GPS data

Synchroniseer de gegenereerde audio met GPS-positiegegevens door de tekstinput dynamisch samen te stellen op basis van de huidige route. Zorg ervoor dat de API requests worden gestuurd op het juiste moment, bijvoorbeeld bij nadering van een bocht, om een vloeiende voice-guidance ervaring te garanderen. Houd rekening met de wachttijd bij hoge belasting door tekst vooraf te bufferen.

  • Stel tekst dynamisch samen op basis van GPS-coördinaten
  • Buffer audio vooraf om vertragingen bij wachtrijverwerking te voorkomen
  • Test synchronisatie met verschillende snelheden en talen

Volg best practices voor voice-guidance

Geluidsgolfillustratie voor: Volg best practices voor voice-guidance

Voice-guidance in navigatie-apparaten vereist helderheid en snelheid. Gebruik de API om tekst om te zetten in audio die direct begrijpelijk is tijdens het rijden.

Korte, precieze zinnen vermijden verwarring. Test verschillende snelheden om de optimale balans tussen luistertijd en informatieoverdracht te vinden.

Houd instructies kort en bondig

Gebruik simpele zinnen voor route-instructies. Vermijd complexe structuur zodat de TTS-engine de tekst vloeiend kan uitspreken.

Korte teksten reduceren de laadtijd en zorgen voor snelle feedback op het dashboard van het voertuig.

  • Maximaal 15 woorden per instructie
  • Geen dubbele negaties
  • Actieve zinsvolgorde

Gebruik pauzes tussen zinnen

Voeg pauzes toe tussen separate instructies voor betere leesbaarheid. Dit helpt gebruikers om elke stap duidelijk te verwerken.

De API verwerkt tekst tot 4096 tekens, maar splits lange berichten voor optimale pauzes.

Test met verschillende snelheden

Pas de snelheid aan tussen 0.25 en 4.0 voor verschillende situaties. Snellere audio is ideaal voor drukke verkeersomstandigheden.

Test de audio met de voices 'sage' voor rustige uitleg en 'felix' voor dynamische updates.

Wacht niet te lang met implementeren

Geluidsgolfillustratie voor: Wacht niet te lang met implementeren

Het is verstandig om snel te beginnen met je navigatie-integratie. Met de gratis proefversie van $0,50 kun je direct experimenteren zonder financiële risico’s. Dit stelt je in staat om de API-kwaliteit te testen in je specifieke use-case.

Begin met de gratis proefversie

Registreer je via Google voor directe toegang tot $0,50 credit. Dit bedrag is voldoende om ongeveer 50.000 tekens te genereren, ideaal voor het valideren van je eerste voice-guidance flows.

Integreer stap voor stap in je app

Begin met het implementeren van de API-koppeling in je dashboard of in-car entertainment systeem. Gebruik de beschikbare OpenAI SDK's of directe HTTP-calls om tekst naar audio te converteren en integreer dit geleidelijk in je bestaande codebase.

Verzamel feedback van gebruikers

Test de gegenereerde audio met echte gebruikers in verschillende omstandigheden. Noteer eventuele problemen met uitspraak of laadtijden en pas je instellingen voor snelheid en taal aan op basis van deze directe feedback.

Luister naar de 8 stemmen

Elk voorbeeld hieronder is gegenereerd door deze API met dezelfde zin. Dit maakt het eenvoudig om de kosten voor elke navigatie-instructie of routebeschrijving nauwkeurig te berekenen.

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. LibriVox public-domain audiobooks
  3. FFmpeg documentation
  4. ISO 639 language codes
  5. openai-node on GitHub
  6. MDN: Web Speech API
  7. OpenAI API reference: create speech
  8. Node.js documentation
  9. curl documentation
  10. W3C WAI: making audio and video accessible
  11. LibriTTS-R paper (arXiv 2305.18802)
  12. LibriTTS-R corpus (OpenSLR 141)

Meer op deze site