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.