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.

Mistral fournit deux jeux de voix prédéfinies. Passez l'identifiant de la voix à n'importe quelle requête de synthèse vocale.

Les voix suivantes sont fournies avec Voxtral 3. Écoutez un extrait pour entendre une voix avant de la choisir.

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.

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.

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.

import os

from mistralai.client import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

# List all preset voices
page = client.audio.voices.search(page_size=50, type_="preset")
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()

# Filter by language and gender
page = client.audio.voices.search(
    language=["fr"],
    gender=["female"],
)
for voice in page.result.data:
    print(f"{voice.name}: {voice.slug}")

# Search by name
page = client.audio.voices.search(query="Marie")
for voice in page.result.data:
    print(f"{voice.name}: {voice.slug}")

import os

from mistralai.client import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

# List all preset voices
page = client.audio.voices.search(page_size=50, type_="preset")
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()

# Filter by language and gender
page = client.audio.voices.search(
    language=["fr"],
    gender=["female"],
)
for voice in page.result.data:
    print(f"{voice.name}: {voice.slug}")

# Search by name
page = client.audio.voices.search(query="Marie")
for voice in page.result.data:
    print(f"{voice.name}: {voice.slug}")

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. Les voix enregistrées comportent un champ retention_notice (30 jours par défaut, 1 jour minimum, 365 jours maximum). Définissez-le lors de la création ou de la mise à jour d’une voix via l’API. Les voix créées depuis l’interface d’AI Studio sont conservées 30 jours par défaut.

Les voix enregistrées peuvent être partagées au sein de votre espace de travail. Le partage se gère dans AI Studio : les administrateurs de l’espace de travail décident si une voix est privée ou partagée avec l’espace de travail. Dans la réponse de la liste des voix, le champ sharing_scope indique la portée actuelle (private, workspace ou global). Les endpoints de l’API de partage sont internes pour l’instant : le partage se fait depuis l’interface d’AI Studio.