aethexDocs
Tableau de bord

Voix

Les voix Aethex sont des modèles TTS spécifiques à la langue. Parcourez le catalogue, prévisualisez n'importe quelle voix, puis assignez-en une à votre agent.

Langues

Chaque voix est taguée avec une langue. Assurez-vous que la langue de la voix correspond au champ language de l'agent — utiliser une voix anglaise sur un agent français donne un mélange d'accent étrange.

Métadonnées de voix

Chaque voix dans GET /voices contient des métadonnées sur lesquelles vous pouvez filtrer et afficher : name, language, gender et supports_dialect_style. Utilisez-les pour créer un sélecteur ou pour affiner le catalogue avant de prévisualiser.

Genre

Chaque voix expose un champ gender avec la valeur male, female ou neutral. Il n'existe pas de paramètre de requête dédié — filtrez côté client sur le champ retourné par GET /voices.

Tags

Les voix peuvent être étiquetées avec des tags issus d'un vocabulaire fixe. Filtrez sur un tag unique avec ?tag=, et récupérez l'ensemble complet des tokens valides via GET /voices/tag-vocabulary (nécessite le scope voices:read) — les tokens ne figurant pas dans cet ensemble ne sont pas acceptés. Aucune voix du catalogue n'est encore taguée, donc les filtres par tag retournent actuellement une liste vide.

Style de dialecte

Certaines voix peuvent parler un dialecte localisé en plus de leur langue de base. Celles-ci indiquent supports_dialect_style: true. Associez une telle voix au paramètre dialect_style de l'agent pour modifier son rendu — par exemple, restituer l'anglais en Nigerian Pidgin.

Dialectes locaux

Les voix compatibles avec les dialectes couvrent les variétés régionales pour lesquelles Aethex est optimisé — notamment le Nigerian Pidgin sur les voix en anglais. Une voix sans supports_dialect_style ne parle que sa langue standard.

Parcourir le catalogue

Utilisez GET /voices pour lister toutes les voix de votre compte. Ajoutez ?language= pour filtrer par langue.

Lister les voix en anglais
bash
curl "https://api.aethexai.com/api/v1/voices?language=english" \
  -H "X-API-Key: $AETHEX_API_KEY"

Filtrer par prise en charge des dialectes

Ajoutez ?supports_dialect_style=true à GET /voices pour lister uniquement les voix capables de parler un dialecte local. Combinez avec ?language= pour affiner davantage.

Lister les voix anglaises compatibles avec les dialectes
bash
curl "https://api.aethexai.com/api/v1/voices?language=english&supports_dialect_style=true" \
  -H "X-API-Key: $AETHEX_API_KEY"

Prévisualiser une voix

Avant de vous engager sur une voix, effectuez une prévisualisation texte-vers-parole. Envoyez une courte phrase et recevez un fichier WAV en retour.

Générer une prévisualisation
bash
curl -X POST "https://api.aethexai.com/api/v1/voices/preview" \
  -H "X-API-Key: $AETHEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"voice_id": "5c34046a-ac9b-57d5-8c70-5a61e694be3f", "text": "Welcome to Aethex. How can I help you?"}' \
  --output preview.wav

Prévisualiser un dialecte local

Pour entendre comment une voix compatible avec les dialectes restitue une variété locale, envoyez une phrase rédigée dans ce dialecte à POST /voices/preview avec une voix indiquant supports_dialect_style: true.

Prévisualiser une phrase en Pidgin
bash
curl -X POST "https://api.aethexai.com/api/v1/voices/preview" \
  -H "X-API-Key: $AETHEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"voice_id": "5c34046a-ac9b-57d5-8c70-5a61e694be3f", "text": "Welcome come to Aethex oh! Wetin I fit do for you?"}' \
  --output preview_pidgin.wav

Choisir une voix

Quelques conseils lors du choix :- Correspondre au personnage. Le nom et le ton de la voix doivent s'aligner avec le personnage défini dans le system_prompt de votre agent. Un agent bancaire formel s'accorde mieux avec une voix mesurée ; un agent de support décontracté bénéficie d'une voix plus chaleureuse.
- Testez avec de vraies phrases. Faites passer votre message d'ouverture et quelques réponses typiques dans POST /voices/preview avant de passer en production.
- Vérifiez la cohérence du dialecte. Si vous définissez dialect_style, choisissez une voix entraînée sur le même dialecte.

Suivant

Une fois que vous avez une voix, assignez-la : définissez voice_id sur l'agent avec PATCH /agents/{id}. Si vous avez besoin que l'agent parle plusieurs langues, créez des agents distincts par langue, chacun avec une voix correspondante.