Moknah Documenti
Inizia gratis
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.