Mistral API gebruiken: een eerste aanvraag met Python

zondag, 18 oktober 2026 om 7:34

Met de Mistral API gebruik je AI vanuit je eigen software. Je stuurt een verzoek naar een model en ontvangt een antwoord dat je applicatie verder verwerkt. Voor een eerste test heb je Python, een Mistral-account, toegang tot Studio en een API-sleutel nodig.

Begin met één eenvoudige tekstaanvraag. Daarmee controleer je de verbinding en het antwoordformaat voordat je documenten, klantgegevens of automatische handelingen toevoegt.

Deze handleiding volgt de officiële API-quickstart. Voor de verschillen tussen de assistent, API en lokale modellen kun je eerst het Mistral-overzicht lezen.

Maak een geschikte API-sleutel

Open Mistral Studio en stel je organisatie en API-toegang in. Controleer welke modellen en limieten beschikbaar zijn voordat je facturering activeert of een sleutel maakt voor een toepassing.

Let op het type sleutel. Mistral legt in zijn documentatie over limieten uit dat een sleutel voor het Vibe-gebruiksbudget iets anders is dan een ontwikkelaarssleutel voor API-automatisering.

Bewaar de sleutel als een wachtwoord. Plaats hem niet in openbare broncode, een browserpagina of een screenshot. Het onderstaande voorbeeld leest de sleutel uit een omgevingsvariabele of vraagt hem verborgen op in je terminal.

Installeer de Python-bibliotheek

Gebruik bij voorkeur een aparte Python-omgeving voor je testproject. Installeer daarin de actuele bibliotheek:

python -m pip install --upgrade mistralai

Op systemen waar Python als python3 beschikbaar is, gebruik je die opdrachtnaam. Sla het volgende voorbeeld op als mistral_test.py.

import os from getpass import getpass from mistralai.client import Mistral def main() -> None: api_key = os.getenv("MISTRAL_API_KEY", "").strip() if not api_key: api_key = getpass("Voer je Mistral API-sleutel in: ").strip() if not api_key: raise SystemExit("Geen API-sleutel ingevoerd.") model = os.getenv("MISTRAL_MODEL", "mistral-small-2603") client = Mistral(api_key=api_key) try: answer = client.chat.complete( model=model, messages=[{ "role": "user", "content": ( "Leg in maximaal 80 Nederlandse woorden uit wat " "een taalmodel is. Gebruik geen marketingtaal." ), }], max_tokens=512, ) except Exception as exc: raise SystemExit( f"Aanvraag mislukt ({type(exc).__name__}). " "Controleer modeltoegang, sleutel, saldo en limieten." ) from None if not answer.choices: raise SystemExit("De API gaf geen antwoordkeuze terug.") print(answer.choices[0].message.content) if __name__ == "__main__": main()

Voer het bestand uit met:

python mistral_test.py

Het voorbeeld gebruikt de vastgelegde modelnaam mistral-small-2603, zoals vermeld op de modelkaart van Small 4. Controleer of jouw account toegang heeft. Je kunt via MISTRAL_MODEL een andere beschikbare model-ID instellen.

Waarom een modelversie vastleggen?

Een alias met latest kan naar een nieuwere versie gaan verwijzen. Dat is handig tijdens verkenning, maar minder geschikt wanneer je wilt weten waarom de uitkomst van een proces verandert.

Leg voor herhaalbare tests daarom de model-ID, instructie en instellingen vast. Bewaar ook een kleine testset. Voer die opnieuw uit voordat je een andere versie in een belangrijk proces gebruikt.

Dat betekent niet dat je een model onbeperkt kunt blijven gebruiken. Beschikbaarheid en uitfasering blijven onderdeel van onderhoud. De modelkeuzehulp helpt bij het beoordelen van alternatieven.

Begrijp de eerste foutmeldingen

De officiële quickstart noemt onder meer 401 voor een probleem met de sleutel, 402 voor een betalingsvereiste en 429 voor overschreden limieten.

Probeer bij een fout niet eindeloos dezelfde aanvraag opnieuw. Controleer eerst de oorzaak. Bouw bij tijdelijke limieten wachttijd en een maximaal aantal pogingen in. Laat je applicatie stoppen wanneer het ingestelde budget of aantal pogingen is bereikt.

Het voorbeeld hierboven is een verbindingstest. Een productieapplicatie vraagt daarnaast om passende time-outs, gerichte foutafhandeling, budgetbewaking en gecontroleerde logging.

Van een antwoord naar een toepassing

Stel dat je klantvragen automatisch wilt indelen. Definieer eerst toegestane categorieën, zoals openingstijden, productinformatie en overige vragen. Test met fictieve voorbeelden en bepaal wat er moet gebeuren wanneer geen categorie past.

Laat het model niet meteen een e-mail versturen of een bestelling wijzigen. Scheid interpretatie van uitvoering en controleer de uitvoer voordat andere systemen ermee werken.

Dit onderscheid is ook belangrijk bij AI-agenten: een model dat een actie voorstelt, vervangt geen toegangscontrole of bedrijfsregel.

Houd kosten en privacy apart in beeld

Meet tokenverbruik en kosten per afgeronde taak. Stuur niet voor iedere korte vraag onnodig een compleet documentarchief mee. Onze kostengids bevat een rekenvoorbeeld.

Controleer bovendien de API-privacy-instellingen afzonderlijk van Vibe. Mistral gebruikt daarvoor aparte schakelaars. Een keuze in de chatomgeving geldt dus niet automatisch voor je API-verkeer.

Een geslaagde eerste test bewijst dat de verbinding werkt. Pas een gecontroleerde proef met representatieve opdrachten laat zien of de toepassing ook bruikbaar is.

Robin HeesterOprichter

Robin Heester is mede-oprichter van AI Wereld en heeft door de jaren heen meerdere websites, nieuwsbrieven en magazines opgericht. Hij schrijft over technologie, innovatie en de maatschappelijke impact van nieuwe digitale ontwikkelingen.