API-Referenz
Stimmenliste
Verfügbare Stimmen für TTS abrufen
POST
/api/v1/voices/
Gibt eine Liste aller Stimmen zurück, die der authentifizierte Benutzer mit der Text-to-Speech-API verwenden darf.
Authentifizierung
Fügen Sie Ihren API-Schlüssel im Header Authorization als Bearer YOUR_API_KEY hinzu.
Anfragekörper (Request Body)
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
| language | optional | string | Sprache für Stimmennamen und Badge-Werte, z. B. ar, fr oder zh-hans (auch als ?language= in der URL möglich). Hat eine Stimme keinen Text in dieser Sprache, wird Englisch verwendet, ebenso bei fehlendem oder nicht unterstütztem Code. Der Antwort-Header Content-Language zeigt die verwendete Sprache. |
| engine | optional | string | Ihr API-Schlüssel listet nur Stimmen seines eigenen Typs (Standard oder erweitert, beim Erstellen des Schlüssels gewählt). Wenn Sie engine senden, muss es zum Typ des Schlüssels passen. |
Antwort
| Feld | Typ | Beschreibung |
|---|---|---|
| voice_id | Integer | Eindeutige Stimmen-ID |
| voice_name | string | Anzeigename der Stimme |
| voice_sample_url | string | URL zur Audio-Beispieldatei der Stimme |
| voice_fees | float | Gebühr für die Nutzung dieser Stimme (0 bedeutet kostenlos) |
| voice_badges | object | Zusätzliche Metadaten für die Stimme, z. B. Sprache, Geschlecht, Alter, Anwendungsfall |
| voice_engine | string | standard oder advanced. Stimmen der Standard-Engine verwenden mode; Stimmen der Erweiterten Engine verwenden context, setting, style und pace. Siehe Engines & Modi. |
Beispiel
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);
Antwortbeispiel
[
{
"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-Support
Bei Fragen oder Problemen rund um die API kontaktieren Sie uns unter api@moknah.io.