Uw eerste transcriptie-oproep
Op deze pagina
Cursus bijgewerkt op 3 november 2026 voor Voxtral 3, gebaseerd op de gids Migrate from Voxtral 2 van Mistral: Voxtral 2-modellen (
voxtral-mini-2602,voxtral-mini-transcribe-realtime-2602,voxtral-mini-tts-2603), verouderd op 31 oktober 2026 en verwijderd op 30 april 2027, worden in de voorbeelden vervangen doorvoxtral-mini-transcribe-3,voxtral-mini-transcribe-realtime-3envoxtral-mini-tts-3-0. Belangrijkste wijzigingen: tijdstempels zijn alleen per segment beschikbaar (wordgeeft een 400-fout), diarisation is mogelijk in realtime, sessie-instellingen voor realtime worden vergrendeld na het eerste audioblok, encontext_bias-invoer is vrij vormgegeven (zinnen met spaties). Bronnen: Migrate from Voxtral 2 · Speech to Text.
Uw eerste transcriptie met Voxtral
Genoeg theorie. In deze les doet u uw eerste volledige oproep naar de offline transcriptie-API: een lokaal audiobestand gaat naar Voxtral Mini Transcribe 3 en u verwerkt de geretourneerde tekst. De code past in een paar regels, maar we bouwen dit vervolgens uit tot een robuuste versie die geschikt is voor onbemande werking.
De omgeving voorbereiden
De Mistral SDK installeert u met één commando. De daaropvolgende verificatiestap bespaart u later het zoeken naar een importfout.
# Installeer de Mistral SDK
pip install mistralai
# Verifieer de installatie
python -c "from mistralai.client import Mistral; print('SDK installed')"
U heeft een Mistral API-sleutel nodig. Maak er een aan op console.mistral.ai en sla deze op in een omgevingsvariabele in plaats van deze hard te coderen:
export MISTRAL_API_KEY="your-api-key-here"
Een lokaal bestand transcriberen
Hier is de volledige code om een lokaal audiobestand te transcriberen:
import os
from mistralai.client import Mistral
# Initialiseer de client
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
# Open en transcribeer het audiobestand
with open("mon_audio.mp3", "rb") as f:
response = client.audio.transcriptions.complete(
model="voxtral-mini-transcribe-3",
file={"content": f, "file_name": "mon_audio.mp3"}
)
# Toon het resultaat
print("=== Transcriptie ===")
print(response.text)
Dat is alles. In vier regels actieve code ontvangt u de volledige transcriptie van uw audiobestand.
Laten we deze vier regels doorlopen. Mistral(api_key=...) maakt de client aan met uw API-sleutel; dit is het object dat u voor alle volgende oproepen hergebruikt. open("mon_audio.mp3", "rb") opent het bestand in binaire modus, wat verplicht is voor audio; het weglaten van de b veroorzaakt een decoderingsfout die moeilijk te interpreteren is. De parameter file={"content": f, "file_name": "..."} verwacht een woordenboek met het bestandsobject en de naam; deze naam is niet louter decoratief, maar helpt de server bij het detecteren van het formaat. Tot slot bevat response.text de volledige transcriptie als een string.
Transcriberen vanaf een URL
Als uw audiobestand al online staat, gebruikt u file_url in plaats van file:
import os
from mistralai.client import Mistral
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
response = client.audio.transcriptions.complete(
model="voxtral-mini-transcribe-3",
file_url="https://example.com/mon_audio.mp3"
)
print(response.text)
De URL moet openbaar toegankelijk zijn. De Mistral-server downloadt het bestand direct, waardoor u audio niet via uw eigen machine hoeft te routeren wanneer deze zich al in de cloud bevindt. Dit levert een aanzienlijke bandbreedtebesparing op bij een catalogus van enkele honderden bestanden.
Overstappen naar een robuuste versie
Het minimale script werkt voor een test. In een productieomgeving moet u rekening houden met ontbrekende bestanden, onverwachte formaten, ontbrekende sleutels en netwerkfouten. Het volgende script voert deze controles uit vóór de oproep en slaat vervolgens het resultaat op.
import os
import sys
from pathlib import Path
from mistralai.client import Mistral
def transcrire_audio(chemin_fichier: str) -> str:
"""Transcribeert een audiobestand met Voxtral Mini Transcribe 3."""
# Controleer of het bestand bestaat
fichier = Path(chemin_fichier)
if not fichier.exists():
raise FileNotFoundError(f"Fichier introuvable : {chemin_fichier}")
# Controleer de extensie
extensions_valides = {".mp3", ".wav", ".flac", ".ogg", ".m4a", ".webm"}
if fichier.suffix.lower() not in extensions_valides:
raise ValueError(
f"Format non supporté : {fichier.suffix}. "
f"Formats valides : {', '.join(extensions_valides)}"
)
# Controleer de grootte (praktische limiet: ~200 MB)
taille_mo = fichier.stat().st_size / (1024 * 1024)
if taille_mo > 200:
print(f"Attention : fichier volumineux ({taille_mo:.1f} Mo)")
# Initialiseer de client
api_key = os.environ.get("MISTRAL_API_KEY")
if not api_key:
raise EnvironmentError("Variable MISTRAL_API_KEY non définie")
client = Mistral(api_key=api_key)
# Transcribeer
try:
with open(chemin_fichier, "rb") as f:
response = client.audio.transcriptions.complete(
model="voxtral-mini-transcribe-3",
file={"content": f, "file_name": fichier.name}
)
return response.text
except Exception as e:
raise RuntimeError(f"Erreur de transcription : {e}")
if __name__ == "__main__":
if len(sys.argv) < 2:
print("Usage : python transcrire.py <fichier_audio>")
sys.exit(1)
chemin = sys.argv[1]
print(f"Transcription de : {chemin}")
print("-" * 50)
texte = transcrire_audio(chemin)
print(texte)
# Opslaan naar tekstbestand
sortie = Path(chemin).stem + "_transcription.txt"
Path(sortie).write_text(texte, encoding="utf-8")
print(f"\nTranscription sauvegardée dans : {sortie}")
Voer dit uit vanaf de terminal door het bestandspad mee te geven:
python transcribe.py meeting_march15.mp3
Het script controleert het bestand, transcribeert het, toont het resultaat en slaat het automatisch op in een .txt-bestand met dezelfde basisnaam. U heeft nu het skelet voor batchverwerking: loop door een map heen en uw audio-archief wordt een doorzoekbaar tekstarchief.
Wat het antwoord bevat
Het response-object beperkt zich niet tot tekst. Het biedt ook de duur van de verwerkte audio en de taal die door het model is herkend. Dit zijn twee nuttige informatiepunten voor het loggen van uw taken en het detecteren van bestanden die niet in de verwachte taal zijn.
# Volledige tekst
print(response.text)
# Audioduur (in seconden)
print(f"Durée : {response.duration:.1f}s")
# Gedetecteerde taal
print(f"Langue : {response.language}")
De beste manier om de kwaliteit van het model te peilen, is door het te testen met uw eigen stem. Neem een spraakbericht op van dertig seconden tot twee minuten, voer het bovenstaande script uit en vergelijk het resultaat woord voor woord met wat u hebt gezegd: u ziet direct waar de zeldzame fouten zitten, bijna altijd bij eigennamen. Herhaal vervolgens de oefening met een bestand in een andere taal, zonder de code te wijzigen, om de automatische taaldetectie in actie te观察en.
Belangrijkste punten
- De minimale oproep vereist 4 regels: client, bestand openen, API-oproep, resultaat lezen
- Twee verzendmodi: lokaal bestand (
file) of URL (file_url) - De bestandsnaam in het
file-woordenboek helpt bij formaatdetectie - Voeg in productie foutafhandeling toe (ontbrekend bestand, ongeldig formaat, netwerkfout)
response.textbevat altijd de volledige transcriptie als een string