Op 28 oktober 2026 kondigde Mistral Responses API aan als publieke preview voor het bouwen van AI-agents. De API gebruikt de Responses-indeling van OpenAI, maar de applicatie moet zelf de gespreksgeschiedenis bewaren en functieaanroepen uitvoeren.
Een preview voor apps met Mistral-modellen
Mistral positioneert Responses API als interface voor applicaties die agents bouwen met gehoste Mistral-modellen. Het bedrijf zegt dat de API werkt met alle chatmodellen die het host, waaronder Mistral Large 4. De voorbeelden in de documentatie gebruiken dat model ook. NeoTeo schreef eerder over de publieke API-preview van Mistral Large 4.
De API gebruikt de OpenAI Responses-indeling en is bedoeld voor nieuwe toepassingen en bestaande integraties die al met die indeling werken. Een gedeelde indeling garandeert niet dat elke bestaande integratie zonder aanpassingen overstapt.
De applicatie beheert gesprekken en functieaanroepen
Responses API is stateless: Mistral bewaart de gesprekstoestand niet voor de volgende aanvraag. De applicatie moet de relevante gespreksgeschiedenis, inclusief eerdere uitvoeritems, opslaan en opnieuw meesturen.
Wanneer het model een functie wil aanroepen, verloopt de lus als volgt:
- Het model retourneert een functienaam met argumenten.
- De applicatie controleert de argumenten en voert de functie zelf uit.
- De applicatie stuurt het resultaat terug als functie-uitvoer met de bijbehorende
call_id, samen met de eerdere uitvoeritems in een volgende aanvraag.
De functie draait dus in de code van de applicatie, niet in een serveromgeving die Mistral voor de gebruiker beheert. Dat geeft de ontwikkelaar controle over de uitvoering, maar maakt argumentvalidatie en het bijhouden van de gespreksgeschiedenis onderdeel van de integratie.
Invoer, uitvoer en streaming
De preview ondersteunt tekst, afbeeldingen en bestanden. Afbeeldingsinvoer vereist een model met vision-ondersteuning. Bestanden kunnen worden aangeleverd via een HTTPS-URL, een base64-data-URL of een geüploade bestands-ID.
Voor gestructureerde uitvoer ondersteunt de API JSON-modus en JSON Schema via text.format. Welke vision- en redeneermogelijkheden beschikbaar zijn, hangt af van het gekozen model. Streaming levert gebeurtenissen voor tekst en functieargumenten; de applicatie moet ook voltooide, mislukte of onvolledige antwoorden en foutmeldingen afhandelen.
Aanvragen gaan naar POST /v1/responses. Het aparte endpoint POST /v1/responses/input_tokens telt de invoertokens van een aanvraag, waaronder meegestuurde geschiedenis, instructies en tooldefinities. Mistral geeft Python- en TypeScript-SDK-voorbeelden en gebruikt MISTRAL_API_KEY als omgevingsvariabele. De Responses API-documentatie en API-referentie beschrijven de interface en aanvraagvelden.
De API-referentie vermeldt usage.input_tokens_details.cached_tokens voor het aantal gecachte invoertokens. Mistral documenteert ook prompt_cache_key: die sleutel vergroot de kans op een cachetreffer, maar garandeert die niet.
