Moknah Doku
Kostenlos starten
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.