Moknah Dokumentacja
Zacznij za darmo
Dokumentacja API

Lista głosów

Pobierz dostępne głosy dla TTS

POST /api/v1/voices/

Zwraca listę wszystkich głosów, których uwierzytelniony użytkownik może używać z API zamiany tekstu na mowę.

Uwierzytelnianie

Umieść swój klucz API w nagłówku Authorization jako Bearer YOUR_API_KEY.

Treść żądania

Parametr Wymagane Typ Opis
language opcjonalne string Język nazw głosów i wartości odznak, np. ar, fr lub zh-hans (można też podać jako ?language= w adresie URL). Głos bez tekstu w tym języku jest pokazywany po angielsku, podobnie przy braku kodu lub nieobsługiwanym kodzie. Nagłówek odpowiedzi Content-Language podaje użyty język.
engine opcjonalne string Twój klucz API wyświetla tylko głosy swojego typu (standardowego lub zaawansowanego, wybranego przy tworzeniu klucza). Jeśli wysyłasz engine, musi on odpowiadać typowi klucza.

Odpowiedź

Pole Typ Opis
voice_id liczba całkowita Unikalny identyfikator głosu
voice_name string Wyświetlana nazwa głosu
voice_sample_url string URL do pliku audio z próbką głosu
voice_fees float Opłata za użycie tego głosu (0 oznacza darmowy)
voice_badges object Dodatkowe metadane głosu, np. język, płeć, wiek, zastosowanie
voice_engine string standard lub advanced. Głosy silnika Standardowego używają parametru mode; głosy silnika Zaawansowanego używają parametrów context, setting, style oraz pace. Zobacz Silniki i tryby.

Przykład

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);

Przykład odpowiedzi

[
    {
        "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"
    }
]
Wsparcie API

W razie pytań lub problemów związanych z API skontaktuj się z nami pod adresem api@moknah.io.