Riferimento API
Elenco voci
Recupera le voci disponibili per il TTS
POST
/api/v1/voices/
Restituisce un elenco di tutte le voci che l'utente autenticato è autorizzato a utilizzare con l'API da testo a voce.
Autenticazione
Includi la tua chiave API nell'intestazione Authorization come Bearer YOUR_API_KEY.
Corpo della richiesta
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
| language | opzionale | string | Lingua dei nomi delle voci e dei valori dei badge, ad esempio ar, fr o zh-hans (accettata anche come ?language= nell'URL). Una voce senza testo in quella lingua viene mostrata in inglese, così come un codice mancante o non supportato. L'intestazione di risposta Content-Language indica la lingua usata. |
| engine | opzionale | string | La tua chiave API elenca solo le voci del suo tipo (standard o avanzato, scelto alla creazione della chiave). Se invii engine, deve corrispondere al tipo della chiave. |
Risposta
| Campo | Tipo | Descrizione |
|---|---|---|
| voice_id | intero | Identificatore univoco della voce |
| voice_name | string | Nome visualizzato della voce |
| voice_sample_url | string | URL del file audio di esempio della voce |
| voice_fees | float | Costo per utilizzare questa voce (0 significa gratuito) |
| voice_badges | object | Metadati aggiuntivi per la voce, ad es. lingua, genere, età, caso d'uso |
| voice_engine | string | standard o advanced. Le voci del motore Standard usano mode; le voci del motore Avanzato usano context, setting, style e pace. Vedi Motori e modalità. |
Esempio
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);
Esempio di risposta
[
{
"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"
}
]
Supporto API
Per domande o problemi relativi all'API, contattaci all'indirizzo api@moknah.io.