Voix
Cette page présente les voix prédéfinies que vous pouvez passer à une requête de synthèse vocale et explique comment lister, écouter, créer et gérer des voix via l'API.
Pour comprendre ce que définit une voix et en quoi les voix prédéfinies, clonées et enregistrées diffèrent, consultez Voix dans la section Concepts.
Bibliothèque de voix
Mistral fournit deux jeux de voix prédéfinies. Passez l'identifiant de la voix à n'importe quelle requête de synthèse vocale.
Voix Voxtral 3
Les voix suivantes sont fournies avec Voxtral 3.
| Voix | Identifiant de voix | Langue |
|---|---|---|
| Sarah | voice_478 | English (en) |
| Yael | voice_447 | English (en) |
| Eric | voice_485 | |
| Jesse | voice_484 | |
| Esmeralda | voice_483 | |
| Andrea | voice_482 | |
| Fiona | voice_481 | |
| Marina | voice_480 | |
| Linda | voice_479 |
Voix prédéfinies Voxtral 2
Voxtral 3 accepte encore ces voix prédéfinies. Chaque locuteur est disponible en plusieurs variantes, une par émotion : choisissez la variante qui correspond au rendu que vous souhaitez.
| Locuteur | Langue | Identifiants de voix |
|---|---|---|
| Paul | English, US (en_us) | en_paul_neutral, en_paul_happy, en_paul_cheerful, en_paul_excited, en_paul_confident, en_paul_sad, en_paul_frustrated, en_paul_angry |
| Jane | English, UK (en_gb) | gb_jane_neutral, gb_jane_confident, gb_jane_curious, gb_jane_confused, gb_jane_sarcasm, gb_jane_sad, gb_jane_shameful, gb_jane_jealousy, gb_jane_frustrated |
| Oliver | English, UK (en_gb) | gb_oliver_neutral, gb_oliver_cheerful, gb_oliver_excited, gb_oliver_confident, gb_oliver_curious, gb_oliver_sad, gb_oliver_angry |
| Marie | French (fr_fr) | fr_marie_neutral, fr_marie_happy, fr_marie_excited, fr_marie_curious, fr_marie_sad, fr_marie_angry |
Avec les voix Voxtral 3, vous gardez une seule voix et définissez plutôt l'émotion directement dans le texte. Voir Balises d'émotion et de rythme.
Utiliser un identifiant de voix
Passez l'identifiant de la voix sous forme de voice_id dans une requête de synthèse vocale. Une voix prédéfinie possède un slug, comme gb_jane_neutral ou voice_478. Une voix enregistrée dans votre espace de travail n'a pas de slug : utilisez l'identifiant que l'API renvoie lorsque vous la créez. Si l'identifiant ne correspond à aucune voix, la requête échoue avec une erreur 404.
Pour voir une requête complète, consultez le guide de démarrage ou Génération de parole.
Gérer les voix
L'API des voix couvre les voix prédéfinies et les voix enregistrées dans votre espace de travail. Le tableau suivant indique à quoi s'applique chaque opération.
| Opération | Méthode SDK | S'applique à |
|---|---|---|
| Lister les voix | voices.search | Les voix prédéfinies et vos voix enregistrées. Le champ type les distingue : preset ou custom. |
| Écouter une voix | voices.get_sample_audio | |
| Créer une voix | voices.create | Une nouvelle voix enregistrée, clonée à partir d'un enregistrement |
| Obtenir, renommer, supprimer | voices.get, voices.update, voices.delete | Vos voix enregistrées |
import os
from mistralai.client import Mistral
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
page = client.audio.voices.search(page_size=50)
while page is not None:
for voice in page.result.data:
languages = ", ".join(voice.languages or []) or "-"
print(f"{voice.slug or voice.id:<38} {voice.name:<28} {voice.type:<7} {languages}")
page = page.next()Les exemples lisent l'enregistrement dans voice_sample.mp3, situé dans le répertoire de travail, et l'identifiant de la voix à gérer dans la variable d'environnement VOICE_ID.
Pour lister les voix, utilisez voices.search. Le SDK marque voices.list comme obsolète.
Pour savoir quel enregistrement fournir et comment utiliser une voix clonée, voir Clonage de la voix.