Anleitung: Mistral-Account anlegen und API-Key erhalten

Ziel: Einen Mistral-Account anlegen und einen API-Key erzeuge. Grundlage für alle anderen Setup-Anleitungen.

Schritt 1: Account anlegen

  1. console.mistral.ai im Browser öffnen und Registrierung durchführen:
    • E-Mail-Adresse benötigt.
    • Passwort wählen.
    • Vor- und Nachname muss nicht angegeben werden.
    • Alternativ: Registrierung über einen bestehenden Google-, GitHub- oder Microsoft-Account (SSO).
  2. E-Mail-Verifizierung: Mistral schickt einen Bestätigungscode mit -link → anklicken oder alternativ Code eingeben und damit den Account aktivieren.
  3. Danach landest man in der Mistral Console (dem Verwaltungs-Dashboard).

Schritt 2: API-Key erzeugen

TODOS Vibe key?!

  1. In der Console links im Menü: **API Schlüssel (unter Platform → API Keys).
  2. Button Create new key klicken.
  3. Name vergeben, z.B. ki-agent-lokal (wichtig, wenn du später mehrere Keys für verschiedene Zwecke verwalten willst).
  4. Optional: Arbeitsbereich wählen – für den Einstieg „Default Workspace“ lassen.
  5. Der Key wird einmalig im Klartext angezeigt (Format: ein langer zufälliger String, beginnt typischerweise mit einem 32-Zeichen-Token).

Key sofort kopieren und sicher speichern

Nach dem Schließen des Dialogs kannst du den Key nie wieder einsehen – nur löschen oder neu erstellen . Kopiere ihn direkt in einen Passwort-Manager (Bitwarden, KeePass, 1Password o.ä.) oder dein Passwort-System; notfalls in eine .txt auf die Festplatte.

Niemals den Key weitergeben. Also insbesondere nicht:

  • in Chats, Screenshots oder Dokumente kopieren.
  • direkt mit dem KI-Agenten teilen, nicht in Dateien, im Chat oder im geteilten Agent-Ordner (~/agent).
  • als Klartext in Skripte schreiben, die du weitergibst.

Schritt 3: Datenschutzeinstellungen vornehmen

TODOS Vibe: https://admin.mistral.ai/vibe/privacy API: https://admin.mistral.ai/plateforme/privacy

Optional/Info 1: Key sicher aufbewahren und Anwendungen bereitstellen

Der Key gehört auf das Gerät, auf dem der KI-Agent installiert wird, nicht in den Agent-Containern (siehe später in den Anleitungen/Workshop. Er kann verschiedenen Anwendungen, die die Dienste von Mistral nutzen wollen zur Verfügung gestellt werden.

Beispiele für die lokale „Shell“, als Vorbereitung der weiteren Abschnitte.

Linux / WSL:

# In ~/.profile (nicht in Dateien unter ~/agent!)
echo 'export MISTRAL_API_KEY="dein-key"' >> ~/.profile
source ~/.profile

Windows PowerShell (falls ein Tool direkt auf dem Host läuft):

# nur für die aktuelle Session
$env:MISTRAL_API_KEY = "dein-key"

Alternativ: Manche Tools (z.B. das Vibe CLI selbst mit vibe --setup oder eine ~/.vibe/.env mit VIBE_HOME-Trennung) verwalten den Key selbst – die Container-Varianten in unseren Anleitungen nutzen aber bewusst die Env-Variable vom Host.

Optional/Info 2: Key testen

Zuerst Optional/Info 1 lesen und durchführen.

Schneller Funktionstest mit curl (von der Shell, in der die Variable gesetzt ist; siehe Optional/Info 1):

curl https://api.mistral.ai/v1/models \
  -H "Authorization: Bearer $MISTRAL_API_KEY"

Erwartung: eine JSON-Liste mit verfügbaren Modellen (Status 200). Kommt 401 Unauthorized, ist der Key falsch kopiert, abgelaufen oder rotiert worden.

Optional/Info 3: Kosten und Limits im Blick behalten

  • Übersicht zum Verbrauch: Im Web-Interface von Mistral Admin kann man sich unter API / Nutzung den Verbrauch pro Key und Zeitraum anzeigen lassen; direkter Link: https://admin.mistral.ai/organization/usage
  • Kontostand: Eine neues Konto läuft erstmal im kostenfreien Modus (“Free Tier”), in dem man Test-Guthaben bekommt. Den aktuellen Kostenstand findet man in Mistral Admin unter Abonnement / Abonnement; direkter Link: https://admin.mistral.ai/subscription
  • Empfehlung für Agenten-Experimente: Setze dir in der Console (falls verfügbar) ein Spending-Limit pro Key, bevor du autonome Agenten längere Zeit laufen lässt. Agenten-Sessions können je nach Task viele API-Calls verursachen.
  • Key-Rotation: Verdächtigst du einen Leak (Key in einem Commit, Screenshot, Log), sofort in der Console löschen (Delete) und einen neuen erzeugen – die betroffenen Konfigurationen dann überall aktualisieren.

Typische Fehler und Lösungen

ProblemUrsache / Lösung
401 Unauthorized beim API-CallKey falsch kopiert (Leerzeichen/Zeilenbruch) oder gelöscht – neuen erzeugen
Key funktioniert lokal, aber nicht im ContainerEnv-Variable wurde beim docker run nicht übergeben (-e MISTRAL_API_KEY)
vibe fragt trotzdem nach dem KeyVariable nicht exportiert oder falsche Shell-Konfiguration (~/.profile vs. Login-Shell)
Ungewohnt hoher VerbrauchUsage-Seite in der Console prüfen, ggf. Key rotieren und Limits setzen

Ausblick

Mit funktionierendem Key geht es weiter mit: