Moknah Documents
Commencez gratuitement
Référence de l’API

Liste des voix

Récupérer les voix disponibles pour la synthèse vocale

PUBLIER /api/v1/voices/

Renvoie une liste de toutes les voix que l’utilisateur authentifié est autorisé à utiliser avec l’API Text-to-Speech.

Authentification

Incluez votre clé API dans l’en-tête Authorization sous la forme Bearer YOUR_API_KEY.

Corps de la requête

Paramètre Obligatoire Type Description
language facultatif chaîne Langue des noms de voix et des valeurs des badges, par exemple ar, fr ou zh-hans (aussi accepté sous la forme ?language= dans l'URL). Une voix sans texte dans cette langue s'affiche en anglais, de même qu'un code absent ou non pris en charge. L'en-tête de réponse Content-Language indique la langue utilisée.
engine facultatif chaîne Votre clé API ne liste que les voix de son propre type (standard ou avancé, choisi à la création de la clé). Si vous envoyez engine, il doit correspondre au type de la clé.

Réponse

Champ Type Description
voice_id nombre entier Identifiant vocal unique
voice_name chaîne Nom d’affichage vocal
voice_sample_url chaîne URL du fichier audio de l’échantillon vocal
voice_fees flotter Frais d’utilisation de cette voix (0 signifie gratuit)
voice_badges objet Métadonnées supplémentaires pour la voix, par exemple : langue, genre, âge, cas d’usage.
voice_engine chaîne standard ou advanced. Les voix du moteur standard utilisent mode ; celles du moteur avancé utilisent context, setting, style et pace. Voir Moteurs et modes.

Exemple

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

Exemple de réponse

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

Pour toute question ou tout problème concernant l’API, contactez-nous à l’adresse api@moknah.io.