Veelgestelde vragen
Wat is de base_url voor de API?
De base_url is https://api.db222.info/v1. Dit is nodig om de officiële OpenAI SDKs te gebruiken door de base_url aan te passen. Alle requests worden verstuurd naar dit endpoint voor tekst-naar-spraak conversie.
Welke SDKs worden ondersteund?
We hebben geen eigen SDK. Je kunt de officiële OpenAI SDKs gebruiken door de base_url aan te passen naar https://api.db222.info/v1. Je kunt ook gewone HTTP-requests gebruiken met de juiste JSON-body en authenticatieheader.
Hoe stel ik de taal in voor een request?
Voeg het veld language toe met een ISO-taalcode in de JSON-body. Als je dit veld weglaat, probeert de API de taal te raden op basis van het script. Voor niet-Engelse tekst in Latijns schrift moet je de taal altijd expliciet instellen.
Wat zijn de ondersteunde audioformaten?
Je kunt kiezen uit mp3, wav, opus, flac en pcm. Dit stel je in via het veld response_format in je API-request. De keuze hangt af van je behoefte aan compressie en geluidskwaliteit voor je navigatie- of dashboardapplicatie.
Hoeveel requests kan ik per minuut sturen?
Het rate limit is 60 requests per minuut per API-key. Voor nieuwe accounts zonder top-up is dit limiet 10 requests per minuut. Als je de limiet bereikt, worden je requests geweigerd (429 Too Many Requests).
Wat gebeurt er bij een fout in de request?
Als de synthesefout gaat, wordt het volledige bedrag van de request terugbetaald. Je wordt dus niet gefactureerd voor mislukte pogingen. Controleer je response voor foutcodes en probeer het request opnieuw als het probleem tijdelijk was.
Kan ik de snelheid van de speech aanpassen?
Ja, je kunt de snelheid instellen tussen 0.25 en 4.0 via het veld speed in de request body. Dit stelt je in staat de speech aan te passen voor verschillende navigatiecontexten of voorkeur van de luisteraar.
Wordt de audio tijdelijk opgeslagen?
Nee, de gegenereerde audio wordt niet opgeslagen. Het audiobestand wordt direct teruggegeven in de response van de API. Alleen requestmetadata zoals tijd, aantal tekens en status wordt bewaard voor facturatie doeleinden.
Hoe genereer ik een nieuwe API key?
Je kunt op elk moment een nieuwe API-key laten genereren vanuit je account dashboard. Zodra de nieuwe key is uitgegeven, stopt de oude key direct. Je hebt altijd precies één actieve key per account.
Is de API compatibel met de OpenAI SDK?
Ja, de API is compatibel met de officiële OpenAI SDKs. Je hoeft alleen de base_url aan te passen naar https://api.db222.info/v1 en je eigen API-key te gebruiken. De request structuur is identiek aan de OpenAI speech endpoint.
Wat is het maximum aantal tekens per request?
Het maximum is 4096 tekens per request. Voor langere teksten moet je deze splitsen in delen van maximaal 4096 tekens. Je kunt de gegenereerde audio bestanden daarna samenvoegen tot één continu audio bestand voor je navigatie systeem.
Hoe werkt de taalherkenning in de API?
Als je het language veld niet instelt, raadt de API de taal aan op basis van het script. Tekst in het Latijnse alfabet wordt standaard als Engels beschouwd. Voor andere talen met Latijns schrift moet je de language parameter expliciet instellen.
Kan ik meerdere talen in één request gebruiken?
Nee, je kunt maar één taal per request instellen via het language veld. De API genereert audio in die ene taal. Voor meertalige inhoud moet je meerdere requests doen voor elke taal en de audio bestanden samenvoegen.
Hoe lang duurt de conversie van tekst naar audio?
De typische snelheid is ongeveer één seconde audio per 25 tekens tekst. Korte zinnen duren een paar seconden. Onder druk kan er wachttijd in de queue optreden omdat requests één voor één worden verwerkt.
Eerste verzoek
curl
curl https://api.db222.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.mp3Python (openai)
from openai import OpenAI
client = OpenAI(base_url="https://api.db222.info/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.db222.info/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
Om te beginnen met NavigoZeg moet je eerst een account aanmaken op de /get-api-key/ pagina. Je kunt inloggen met je Google-account of een nieuw account registreren met een e-mailadres en wachtwoord. Let op: accounts zijn per site gebonden, dus je maakt hier een aparte identiteit aan.
Aanmaken account via Google of e-mail
Registratie via Google geeft je direct $0,50 testcredit (ongeveer 50.000 tekens) die zeven dagen geldig is. Kies je voor e-mail en wachtwoord, dan start je zonder deze proefcredit. Je krijgt direct toegang tot de API met je unieke sleutel.
- Google login: direct $0,50 testcredit
- E-mail registratie: geen testcredit
- Account is specifiek voor deze site
Locatie van de key in het dashboard
Na het inloggen zie je op de dashboardpagina je actieve API-sleutel onder het kopje 'Key'. Hier vind je ook je huidige balans, het aantal resterende tekens en een kant-en-klare cURL-voorbeeldcode voor directe testing.
Key kan opnieuw worden gegenereerd
Je kunt je API-sleutel op elk moment opnieuw genereren via het dashboard. Zodra je een nieuwe sleutel aanmaakt, wordt de oude sleutel onmiddellijk ongeldig. Dit zorgt voor directe controle over je toegangsrechten.
- Oude sleutel stopt direct
- Veilig bij verlies van key
Eerste request met cURL
Stuur een POST-verzoek naar https://api.db222.info/v1/audio/speech om tekst direct om te zetten naar audio. Gebruik je Bearer token in de Authorization header voor authenticatie. De API accepteert JSON met model, input tekst en optionele parameters zoals voice en speed.
POST endpoint voor speech generatie
Gebruik het endpoint https://api.db222.info/v1/audio/speech om synthesen te starten. Stuur een POST-verzoek met de nodige JSON-parameters. Zorg dat je API key correct in de header staat vermeld.
JSON body met model en input tekst
Definieer het model ('tts-1' of 'tts-1-hd') en de input tekst in de JSON body. Je kunt ook de voice, response_format en speed specificeren. De tekst mag maximaal 4096 karakters bevatten.
- model: 'tts-1' of 'tts-1-hd'
- input: de tekst die gesproken moet worden
- voice: een van de 8 beschikbare stemmen
- response_format: mp3, wav, opus, flac of pcm
Ontvangst van audio-bestant als response
Na het versturen van het verzoek ontvang je het gegenereerde audio bestand als response. Dit bestand is direct te gebruiken in je navigatie- of dashboard applicatie. Mislukte requests worden volledig terugbetaald.
Gebruik de OpenAI SDK
De NavigoZeg API volgt exact hetzelfde request-shape als de OpenAI speech endpoint. Dit betekent dat je bestaande code kunt blijven gebruiken door simpelweg de base_url aan te passen naar https://api.db222.info/v1. Je hoeft geen nieuwe client libraries te leren; de officiële OpenAI SDKs werken direct met onze infrastructuur.
Instellen van base_url naar onze endpoint
Vervang de standaard URL van de SDK door onze API-base: https://api.db222.info/v1. Dit zorgt ervoor dat alle verzoeken naar onze servers worden gestuurd in plaats van die van OpenAI. De structuur van het JSON-body blijft identiek, waardoor migratie naadloos verloopt.
Veranderen van de API key in de client
Vervang je bestaande API key door de sleutel die je ontvangt via het NavigoZeg dashboard. Gebruik de header Authorization: Bearer tts-... voor authenticatie. Zorg dat je key correct is geconfigureerd voordat je je eerste syntheseverzoek doet.
Compatibiliteit met officiële SDKs
Omdat we dezelfde request-structuur hanteren als OpenAI, zijn de officiële SDKs volledig compatibel. Je hoeft geen eigen client te bouwen. Dit bespaart ontwikkeltijd en zorgt voor een stabiele integratie met je bestaande workflow voor voice-guidance of navigatie-apparaten.
Ondersteunde audioformaten
NavigoZeg levert audio direct als bestand via de response. Je kiest het formaat met het veld response_format in de JSON body. De API ondersteunt MP3, WAV, OPUS, FLAC en PCM. Dit geeft je volledige controle over de balans tussen bestandsgrootte en geluidskwaliteit voor je navigatie- of dashboard-applicatie.
MP3 voor brede compatibiliteit
MP3 is de standaardkeuze voor de meeste navigatie-apparaten en in-car systemen. Het formaat biedt een goede balans tussen bestandsgrootte en geluidskwaliteit. Gebruik mp3 als response_format voor maximale compatibiliteit met bestaande audio-players in je dashboard of entertainment-systeem.
WAV voor hoge kwaliteit audiobestanden
Kies wav wanneer je ongecomprimeerde audio nodig hebt voor hoge eisen aan de geluidsscherpte. Dit formaat is ideaal voor lokale opslag of voorverwerking van voice-guidance berichten. De bestanden zijn groter, maar behouden de volledige resolutie van de synthese.
Opus en FLAC voor efficiëntie
Gebruik opus voor efficiënte compressie met kleine bestandsgroottes, ideaal voor beperkte bandbreedte. Kies flac voor verliesvrije compressie als je archiefkwaliteit nodig hebt zonder de bestandsgrootte van WAV. Beide formaten worden ondersteund via hetzelfde API-endpoint.
Snelheidsinstellingen (Speed)
De snelheidsparameter (speed) bepaalt het tempo van de gegenereerde spraak. Je kunt de waarden tussen 0.25 en 4.0 instellen, waarbij de standaardwaarde 1.0 is. Deze instelling past de uitspraak snelheid aan zonder de toonhoogte of stemkleur van de geselecteerde voice te wijzigen.
Bereik van 0.25 tot 4.0
Stel de snelheid laag in voor duidelijke, rustige navigatie-instructies of hoge voor snelle nieuwsupdates. Het bereik loopt van 0.25 (zeer langzaam) tot 4.0 (zeer snel). Elke waarde tussen deze grenzen is geldig voor een vloeiende afstemming op je use case.
- Minimum: 0.25x voor langzame, gedetailleerde voice-guidance
- Standaard: 1.0x voor natuurlijke gespreksvoering
- Maximum: 4.0x voor snelle data-overdracht
Aanpassen voor voice-guidance snelheid
Voor navigatie-apparaten is een rustiger tempo vaak beter leesbaar. Stel de snelheid in op 0.8 of 0.9 voor heldere wegbeschrijvingen in druk verkeer. Voor automatische nieuwsupdates op dashboards kun je de snelheid verhogen naar 1.2 of 1.5 om meer informatie in minder tijd over te brengen.
Standaard snelheid voor natuurlijke speech
Bij twijfel houd je de standaardwaarde van 1.0 aan. Dit levert de meest natuurlijke luisterervaring op die past bij de geselecteerde voice preset. De API verwerkt requests sequentieel, dus de snelheid van de output blijft consistent, zelfs bij wisselende belasting.

Taal specificatie in requests
De NavigoZeg API ondersteunt 23 talen, waaronder Nederlands, Engels en Duits. Hoewel de taal vaak automatisch wordt gedetecteerd, kun je deze expliciet specificeren voor betrouwbare resultaten. Dit is essentieel voor navigatie-apparaten waar precieze uitspraak cruciaal is voor de gebruiker.
ISO code optioneel instellen
Je kunt het language veld in de request body invullen met een ISO 639-1 code (bijvoorbeeld 'nl' voor Nederlands). Dit is optioneel; de API probeert de taal eerst automatisch te herkennen op basis van de invoertekst.
Automatische detectie van scripts
Zonder expliciete taalinstelling analyseert de engine het script van de input. Tekst in het Latijnse alfabet wordt standaard geïnterpreteerd als Engels. Dit werkt goed voor Engelse commando's in auto's, maar leidt tot fouten bij andere Latijnse talen.
Taal instellen voor Latijnse teksten
Voor niet-Engelse teksten in het Latijnse alfabet (zoals Nederlands of Duits) is het sterk aanbevolen om het language veld expliciet in te stellen. Zonder deze specificatie kiest de API standaard voor Engels, wat de uitspraak van navigatie-instructies of dashboardmeldingen kan verstoren.
Foutafhandeling en statuscodes
NavigoZeg API retourneert specifieke HTTP-statuscodes om fouten te identificeren. Een 4xx-fout treedt op bij ongeldige parameters, zoals een verkeerde voice-ID of een tekst die langer is dan 4096 karakters. Controleer altijd de response body voor een duidelijk foutbericht.
4xx fouten bij invalid parameters
De API keert een 400-fout terug als de JSON-body niet voldoet aan de eisen, bijvoorbeeld bij een ontbrekend 'input'-veld of een ongeldige 'model'-waarde. Zorg dat je 'input' tekst bevat en binnen de limiet blijft. Bij een ongeldige 'voice' of 'response_format' ontvang je eveneens een 4xx-fout.
- 400 Bad Request: Ongeldige JSON structuur of missende velden.
- 401 Unauthorized: Verkeerde of verlopen API key.
- 429 Too Many Requests: Overschrijding van rate limits.
5xx fouten bij serverproblemen
Een 5xx-fout duidt op een server-side probleem, zoals een tijdelijke storing bij de synthesemotor. Deze fouten zijn zeldzaam maar kunnen voorkomen bij hoge belasting. Wacht enkele seconden en probeer je request opnieuw. De verwerking gebeurt sequentieel, wat bij pieken kan leiden tot wachttijden.
Terugbetaling bij mislukte synthesen
Als de synthesefase faalt na het accepteren van de request, wordt het bedrag volledig teruggenomen op je saldo. Dit geldt niet voor fouten die direct bij validatie optreden. Je ziet de terugboeking direct in je dashboard onder 'gebruik'. Dit zorgt ervoor dat je alleen betaalt voor succesvolle audio-uitvoer.
Rate limits en prestaties
Je API-key kent een limiet van 60 requests per minuut zodra je saldo heeft opgewaardeerd. Dit volume is doorgaans voldoende voor de meeste navigatie- en dashboardtoepassingen waarbij tekst continu naar spraak wordt omgezet.
60 requests per minuut na top-up
Na een succesvolle top-up via USDT (TRC-20) verhoogt je limiet naar 60 verzoeken per minuut. Dit stelt je in staat om grotere teksten efficiënt te verwerken zonder al te snel tegen de muren van het systeem aan te lopen.
10 requests per minuut voor nieuwe accounts
Nieuwe accounts, die nog geen tegoed hebben toegevoegd, starten met een limiet van 10 requests per minuut. Deze lagere snelheid is geschikt voor eerste tests en het verkennen van de API-functionaliteiten voordat je schaalbare volume nodig hebt.
Wachtrijverwerking bij hoge belasting
Onder hoge belasting worden verzoeken één voor één verwerkt. Dit kan leiden tot wachttijden bij het genereren van audio, vooral bij langere teksten. Houd hier rekening mee bij het plannen van real-time voice-guidance updates in je navigatiesysteem.
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.
23 talen
Elke stem kan elke van deze talen spreken.
