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.