Mistral aus deiner Anwendung aufrufen

Vor Ihrer ersten Anfrage

Erstellen Sie einen Anbieter-API-Schlüssel in Mistral Studio. Bewahren Sie ihn auf Ihrem Server auf, niemals in einem öffentlichen Repository oder Browser-Bundle. Prüfen Sie den Modellzugriff und die aktuellen Tarife Ihres Kontos. Die Anmeldedaten dieser Website sind vom Anbieter getrennt.

cURL-Schnellstart

curl https://api.mistral.ai/v1/chat/completions \
  -H "Authorization: Bearer $MISTRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mistral-large-4",
    "messages": [{"role": "user", "content": "Explain idempotent retries."}],
    "max_tokens": 1024
  }'

Python-Beispiel

Installieren Sie das offizielle mistralai SDK aus Ihrer Paketquelle und verwenden Sie eine Umgebungsvariable für den Schlüssel.

import os
from mistralai import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
reply = client.chat.complete(
    model="mistral-large-4",
    messages=[{"role": "user", "content": "Explain idempotent retries."}],
    max_tokens=1024,
)
print(reply.choices[0].message.content)

TypeScript-Beispiel

Verwenden Sie das offizielle @mistralai/mistralai SDK auf dem Server. Behandeln Sie fehlende Auswahlmöglichkeiten und Anbieterfehler, bevor Sie ein Ergebnis rendern.

import { Mistral } from "@mistralai/mistralai";

const client = new Mistral({ apiKey: process.env.MISTRAL_API_KEY });
const reply = await client.chat.complete({
  model: "mistral-large-4",
  messages: [{ role: "user", content: "Explain idempotent retries." }],
  maxTokens: 1024,
});
console.log(reply.choices?.[0]?.message.content);

Streaming-Antworten

Fordern Sie für die HTTP-API Streaming an und parsen Sie Server-Sent Events schrittweise. Gehen Sie nicht davon aus, dass jedes Netzwerkpaket ein vollständiges Ereignis enthält. Bewahren Sie Teiltexte, unterstützen Sie Abbruch und unterscheiden Sie eine abgeschlossene Antwort von einer abgebrochenen Verbindung. Wiederholen Sie nur, wenn Ihre Anwendung dies ohne doppelte Nebenwirkungen tun kann.

Bilder und Dokumente

Folgen Sie der aktuellen API-Referenz für multimodale Inhaltsblöcke. Verwenden Sie autorisierte Bilder und validieren Sie öffentliche URLs. Bei Dokumentfragen fügen Sie Quellpassagen bei und bitten Sie um explizite Zitate. Teilen Sie große Eingaben auf, wenn das Anfragelimit des Anbieters niedriger ist als der dokumentierte Kontext des Modells.

Strukturierte Ausgaben und Tools

Verwenden Sie unterstützte Schemas für strukturierte Ausgaben, anstatt nach unvalidiertem JSON zu fragen. Validieren Sie Argumente vor der Ausführung von Tool-Aufrufen, erzwingen Sie Autorisierung auf Ihrem Server und begrenzen Sie Tool-Schleifen. Ein modellgenerierter Funktionsaufruf ist ein vorgeschlagener Input, keine Erlaubnis zur Ausführung einer Aktion.

Produktions-Checkliste

Legen Sie Ausgabelimits, Zeitlimits und Nebenläufigkeitsgrenzen fest. Erfassen Sie Modellkennungen, Nutzung und Fehler, ohne Geheimnisse oder unnötige Benutzerinhalte zu protokollieren. Testen Sie Ratenlimits, Teil-Streams, Abbruch und fehlerhafte Tool-Argumente. Halten Sie eine Anbieter-Alternative und einen kleinen Regressions-Evaluationsdatensatz bereit.

Verfügbarkeit in diesem Workspace

Die obige Integration richtet sich direkt an den offiziellen Anbieter. Verwenden Sie das Workspace-Konto für Browser-Chat und Guthabenverwaltung. Direkte API-Beispiele erfordern Ihr eigenes Anbieterkonto und werden nicht aus diesem Artikel ausgeführt.