Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Uw eerste transcriptie-oproep

Les 5 van 16 Bijgewerkt op 3 november 2026 Ontwikkelaar
Op deze pagina
  1. Uw eerste transcriptie met Voxtral
  2. De omgeving voorbereiden
  3. Een lokaal bestand transcriberen
  4. Transcriberen vanaf een URL
  5. Overstappen naar een robuuste versie
  6. Wat het antwoord bevat
  7. Belangrijkste punten

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 door voxtral-mini-transcribe-3, voxtral-mini-transcribe-realtime-3 en voxtral-mini-tts-3-0. Belangrijkste wijzigingen: tijdstempels zijn alleen per segment beschikbaar (word geeft een 400-fout), diarisation is mogelijk in realtime, sessie-instellingen voor realtime worden vergrendeld na het eerste audioblok, en context_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.text bevat altijd de volledige transcriptie als een string