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.