Audio

L'audio de Mistral couvre trois usages : transformer la parole en texte, transformer le texte en parole, et faire fonctionner les deux dans des conversations en direct. Les modèles Voxtral 3 transcrivent des fichiers enregistrés et des flux en direct, avec étiquettes de locuteur, horodatages et vocabulaire personnalisé. Ils génèrent de la parole avec des voix prédéfinies ou clonées, que vous dirigez avec des balises d'émotion et de rythme. Vous pouvez aussi envoyer de l'audio à un modèle de chat pour résumer ou interroger un enregistrement, et construire des agents audio qui répondent aux appelants en temps réel.

Cette section s'adresse aux développeurs qui intègrent l'audio via l'API et les SDK, et aux équipes produit qui évaluent ce que Voxtral peut faire.

Astuce

Vous n'êtes pas développeur ? Dictez des prompts et discutez avec Travail en mode vocal, ou analysez un enregistrement en le téléchargeant dans une conversation. sans écrire une ligne de code.

i
Information

La documentation audio couvre Voxtral 3. Si votre code appelle encore des modèles Voxtral 2, Migrer depuis Voxtral 2 liste les changements à apporter.

Démarrer

Démarrer

1. Créer une clé API

1. Créer une clé API

Chaque requête nécessite une clé API issue d'AI Studio.

  1. Sélectionnez Créez une nouvelle clé, donnez un nom à la clé et définissez une date d'expiration.
  2. Copiez la clé. Elle ne s'affiche qu'une seule fois.
  3. Stockez la clé dans la variable d'environnement MISTRAL_API_KEY, où les exemples la lisent :
export MISTRAL_API_KEY="your-api-key"
i
Information
2. Installer le SDK

2. Installer le SDK

Les exemples curl ne nécessitent aucune installation. Pour Python ou TypeScript, installez le SDK Mistral :

pip install "mistralai[realtime]"

L'extra realtime ajoute le client WebSocket pour la transcription en temps réel.

3. Exécuter votre premier appel

3. Exécuter votre premier appel

Envoyez un fichier enregistré et recevez sa transcription. Téléchargez d'abord l'enregistrement d'exemple, ou récupérez-le depuis la ligne de commande :

curl -O https://docs.mistral.ai/audio/obama.mp3
import os

from mistralai.client import Mistral

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

with open("obama.mp3", "rb") as audio:
    transcription = client.audio.transcriptions.complete(
        model="voxtral-mini-transcribe-3-0",
        file={"file_name": "obama.mp3", "content": audio},
    )

print(transcription.text)
Astuce
Découvrez les modèles

Découvrez les modèles

Voxtral 3 compte cinq modèles : trois transforment la parole en texte, et deux transforment le texte en parole.

Reconnaissance vocale

Reconnaissance vocale

Synthèse vocale

Synthèse vocale

Pour choisir, partez de ce que vous avez à faire :

ModèleUtilisez-le pourChiffres clés
Voxtral Mini Transcribe 3 (voxtral-mini-transcribe-3-0)Transcrire des fichiers enregistrés, avec des étiquettes de locuteur, des horodatages de segments et un vocabulaire personnalisé
Voxtral Mini Transcribe Realtime 3 (voxtral-mini-transcribe-realtime-3-0)Transcrire de l'audio en direct pour des sous-titres et des agents audio, avec détection des tours de paroleLatence de streaming de 80 à 1 200 ms, ou 2 400 ms, définie par session
Voxtral Small Transcribe 3 (voxtral-small-transcribe-3-0)Transcrire des fichiers enregistrés avec une qualité supérieure
Voxtral TTS 3 (voxtral-mini-tts-3-0)Générer de la parole à partir de texte avec des voix prédéfinies ou clonées5 formats de sortie, WAV à 24 kHz ; 34 balises d'émotion et 2 balises de rythme
Voxtral TTS Realtime 3 (voxtral-mini-tts-realtime-3-0)Diffuser de la parole pour des conversations en direct

Pour comparer en détail les modes, les options et les fonctionnalités, consultez Reconnaissance vocale et Synthèse vocale.

Comprendre les concepts

Comprendre les concepts

Avant de régler les options ou de concevoir un produit vocal, lisez comment fonctionne chaque composant de la stack audio et quels compromis comporte chaque choix.

Ce que vous pouvez construire

Ce que vous pouvez construire

Choisissez le scénario le plus proche de votre produit. Chaque guide combine plusieurs fonctionnalités pour aboutir à un résultat unique et renvoie, à chaque étape, vers l'article correspondant.