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.
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.
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
1. Créer une clé API
Chaque requête nécessite une clé API issue d'AI Studio.
- Sélectionnez
Créez une nouvelle clé, donnez un nom à la clé et définissez une date d'expiration. - Copiez la clé. Elle ne s'affiche qu'une seule fois.
- Stockez la clé dans la variable d'environnement
MISTRAL_API_KEY, où les exemples la lisent :
export MISTRAL_API_KEY="your-api-key"Pour des captures d'écran et toutes les options de clé, consultez Activer Studio et générer une clé API. Si votre organisation gère les clés de manière centralisée, consultez Clés API dans la documentation Admin.
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
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.mp3import 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)Cet exemple s'exécute sur Voxtral Mini Transcribe 3. Pour consulter la réponse complète et savoir quoi essayer ensuite, suivez Guide de démarrage : transcrire un fichier audio.
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
Voxtral Mini Transcribe 3
Transcription of recorded audio files.
Voxtral Mini Transcribe Realtime 3
Live transcription of audio streams, with configurable latency.
Voxtral Small Transcribe 3
Higher-quality transcription of recorded audio files.
Synthèse vocale
Voxtral TTS 3
Speech generation from text, with preset voices and zero-shot voice cloning.
Voxtral TTS Realtime 3
Streaming speech generation for live conversations.
Pour choisir, partez de ce que vous avez à faire :
| Modèle | Utilisez-le pour | Chiffres 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 parole | Latence 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ées | 5 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
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
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.