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
- 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).
- E-Mail-Verifizierung: Mistral schickt einen Bestätigungscode mit -link → anklicken oder alternativ Code eingeben und damit den Account aktivieren.
- Danach landest man in der Mistral Console (dem Verwaltungs-Dashboard).
Schritt 2: API-Key erzeugen
TODOS Vibe key?!
- In der Console links im Menü: **API Schlüssel (unter Platform → API Keys).
- Button Create new key klicken.
- Name vergeben, z.B.
ki-agent-lokal(wichtig, wenn du später mehrere Keys für verschiedene Zwecke verwalten willst). - Optional: Arbeitsbereich wählen – für den Einstieg „Default Workspace“ lassen.
- 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 ~/.profileWindows 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
| Problem | Ursache / Lösung |
|---|---|
401 Unauthorized beim API-Call | Key falsch kopiert (Leerzeichen/Zeilenbruch) oder gelöscht – neuen erzeugen |
| Key funktioniert lokal, aber nicht im Container | Env-Variable wurde beim docker run nicht übergeben (-e MISTRAL_API_KEY) |
vibe fragt trotzdem nach dem Key | Variable nicht exportiert oder falsche Shell-Konfiguration (~/.profile vs. Login-Shell) |
| Ungewohnt hoher Verbrauch | Usage-Seite in der Console prüfen, ggf. Key rotieren und Limits setzen |
Ausblick
Mit funktionierendem Key geht es weiter mit:
- Konzeptioneller Aufbau - OpenHands und Agent Canvas – Begriffe und Architektur vor dem Installieren
- Anleitung OpenHands auf Windows-Laptop – Multi-Session mit Web-UI