Moknah Docs
Gratis starten
API-referentie

Stemmenlijst

Beschikbare stemmen voor TTS ophalen

POST /api/v1/voices/

Retourneert een lijst met alle stemmen die de geverifieerde gebruiker mag gebruiken met de Tekst-naar-spraak-API.

Authenticatie

Neem je API-sleutel op in de Authorization-header als Bearer YOUR_API_KEY.

Request body

Parameter Verplicht Type Beschrijving
language optioneel string Taal voor stemnamen en badgewaarden, bijvoorbeeld ar, fr of zh-hans (ook mogelijk als ?language= in de URL). Een stem zonder tekst in die taal wordt in het Engels getoond, net als bij een ontbrekende of niet-ondersteunde code. De response-header Content-Language toont de gebruikte taal.
engine optioneel string Uw API-sleutel toont alleen stemmen van zijn eigen type (standaard of geavanceerd, gekozen bij het aanmaken van de sleutel). Als u engine meestuurt, moet die overeenkomen met het type van de sleutel.

Respons

Veld Type Beschrijving
voice_id geheel getal Unieke stem-ID
voice_name string Weergavenaam van stem
voice_sample_url string URL naar het audiobestand met het stemvoorbeeld
voice_fees float Kosten voor het gebruik van deze stem (0 betekent gratis)
voice_badges object Aanvullende metadata voor de stem, bijv. taal, geslacht, leeftijd, toepassing
voice_engine string standard of advanced. Stemmen van de Standaard-engine gebruiken mode; stemmen van de Geavanceerde engine gebruiken context, setting, style en pace. Zie Engines & modi.

Voorbeeld

curl "https://moknah.io/api/v1/voices/" \
  -H "Authorization: Bearer YOUR_API_KEY"
import requests

response = requests.post(
    "https://moknah.io/api/v1/voices/",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)

voices = response.json()
for voice in voices:
    print(voice["voice_name"], voice["voice_sample_url"])
const response = await fetch(
    'https://moknah.io/api/v1/voices/',
    {
        headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
    }
);

const voices = await response.json();
console.log(voices);

Voorbeeldrespons

[
    {
        "voice_id": 1328,
        "voice_name": "Adnan",
        "voice_sample_url": "https://storage.moknah.io/media/voice_samples/Adnan.mp3",
        "voice_fees": 0.0,
        "voice_badges": {
            "language": "Arabic",
            "gender": "Male",
            "age": "Young Adult",
            "use_case": "Documentary, Audiobook, Article",
        },
        "voice_engine": "standard"
    }
]
API-ondersteuning

Voor vragen of problemen met betrekking tot de API kun je contact met ons opnemen via api@moknah.io.