Zum Hauptinhalt springen
AIHubMix CLI ist das offizielle Kommandozeilen-Tool von AIHubMix (ausführbare Datei aihubmix). Nach der Installation können Sie ohne Öffnen der Web-Konsole direkt im Terminal das Kontoguthaben abfragen, API-Keys verwalten und verfügbare Modelle anzeigen. Es ist eine einzelne Binärdatei – ohne Installation von Python, Node oder Go mit einem einzigen Befehl einsatzbereit; alle Befehle unterstützen JSON-Ausgabe und lassen sich direkt in Skripte, CI und AI Agents (wie Claude Code) integrieren. Was es kann:
  • Guthaben abfragen: Kontoguthaben und verbrauchtes Kontingent in Echtzeit abfragen
  • Keys verwalten: API-Keys erstellen, anzeigen, suchen, ändern, löschen
  • Modelle anzeigen: Die für das aktuelle Token verfügbaren Modelle auflisten
  • Skriptfähig: JSON-Ausgabe + stabile Exit-Codes, von Natur aus geeignet für Automatisierung und AI Agents
Verwechseln Sie die beiden Anmeldedaten nicht: Die CLI meldet sich mit dem „System-Zugriffstoken“ (Manage Key, Format fd***) an. Diesen erhalten Sie in der Konsole unter console.aihubmix.com/setting per Klick auf „System-Zugriffstoken generieren“. Er dient der Kontoverwaltung und ist nicht derselbe wie der API-Key (sk-***), den Sie für Modellaufrufe verwenden.
Suchen Sie das alte Python-Skript (aihubmix_cli.py)? Siehe Kontoinformationen per API abrufen. Diese Seite beschreibt dessen Nachfolger der nächsten Generation – einfacher und schneller.

​
Installation

​
Schnellinstallation (empfohlen)

Kopieren Sie den Befehl für Ihr System, fügen Sie ihn im Terminal ein und führen Sie ihn aus. Damit wird die Binärdatei heruntergeladen und automatisch zum PATH hinzugefügt: 
curl -fsSL https://raw.githubusercontent.com/AIhubmix/platfrom-cli/main/install.sh | sh
Nach der Installation öffnen Sie ein neues Terminal und führen aihubmix login aus, um loszulegen.
Sie können die passende Binärdatei für Ihre Plattform auch manuell von Releases herunterladen (für Windows aihubmix_windows_amd64.exe) und in ein PATH-Verzeichnis legen; unter Unix-ähnlichen Systemen ist chmod +x erforderlich.
Bei Bedarf können Sie das Installationsverhalten über Umgebungsvariablen anpassen:
VariableBeschreibungStandard
AIHUBMIX_VERSIONBestimmte Version installieren (z. B. v0.2.0)latest
AIHUBMIX_BIN_DIRBenutzerdefiniertes InstallationsverzeichnisUnix: /usr/local/bin oder ~/.local/bin; Windows: %LOCALAPPDATA%\aihubmix\bin

​
Schnellstart

Nach der Anmeldung stehen Ihnen alle Befehle zur Verfügung: 
# 1. Anmelden: öffnet automatisch den Browser zur Token-Generierungsseite, Manage Key einfügen (Eingabe wird nicht angezeigt)
aihubmix login

# 2. Aktuelle Identität und Kontostand anzeigen
aihubmix whoami

# 3. Vollständige Kontoinformationen anzeigen
aihubmix me

# 4. Ihre API-Keys auflisten
aihubmix keys list

​
Befehlsübersicht

BefehlFunktion
aihubmix loginAnmelden (Manage Key einfügen)
aihubmix logoutAbmelden, lokale Anmeldedaten löschen
aihubmix whoamiAktuelle Anmeldeidentität und Kontostand anzeigen
aihubmix meVollständige Kontoinformationen und Kontostand anzeigen
aihubmix models listAktuell verfügbare Modelle anzeigen
aihubmix keys list [--num N]API-Keys auflisten
aihubmix keys search <Schlüsselwort>Keys per Schlüsselwort suchen
aihubmix keys get <id>Details eines bestimmten Keys anzeigen
aihubmix keys create [Parameter]Neuen Key erstellen
aihubmix keys update <id> [Parameter]Key ändern
aihubmix keys delete <id>Key löschen
Fügen Sie einem beliebigen Befehl --help hinzu, um alle Parameter anzuzeigen, z. B. aihubmix keys create --help.

​
Häufige Operationen

​
API-Keys verwalten

# Einen Key mit $10 Limit erstellen, beschränkt auf bestimmte Modelle
aihubmix keys create -n prod-key -q 10 -m "gpt-4o,claude-3.5-sonnet"

# Einen Key ohne Limit und ohne Ablaufdatum erstellen
aihubmix keys create -n ci-key -u

# Key umbenennen (alle anderen Einstellungen bleiben unverändert)
aihubmix keys update 123 -n new-name

# Einen Key deaktivieren
aihubmix keys update 123 --status 0

# Key löschen
aihubmix keys delete 123
Dabei bedeutet -q 10, dass der Key auf $10 limitiert ist, und -u bedeutet kein Limit. Beim Löschen wird standardmäßig eine Bestätigung verlangt; im CI-Szenario kann diese mit --yes übersprungen werden.

​
Verwendung in Skripten / AI Agents

Die CLI ist sehr automatisierungsfreundlich und kann von CI, Skripten oder AI Agents (wie Claude Code) direkt gesteuert werden:
  • Anmeldefrei: Manage Key über die Umgebungsvariable AIHUBMIX_TOKEN oder --token übergeben, um die interaktive Anmeldung zu überspringen (Priorität: --token > AIHUBMIX_TOKEN > Konfigurationsdatei).
  • JSON-Ausgabe: Fügen Sie einem beliebigen Befehl --json (-j) hinzu; reguläre Ergebnisse gehen an stdout, Fehler an stderr – praktisch für die Auswertung mit jq.
  • Stabile Exit-Codes: Skripte können daran Erfolg oder Misserfolg erkennen.
# Per Umgebungsvariable steuern, alle Key-Namen extrahieren
AIHUBMIX_TOKEN=fd*** aihubmix keys list --json | jq '.data[].name'

# Kontostand abfragen
AIHUBMIX_TOKEN=fd*** aihubmix whoami --json | jq -r '.balance'
Bedeutung der Exit-Codes:
Exit-CodeBedeutung
0Erfolg
1Allgemeiner Fehler (Parameterfehler, Business-Fehler usw.)
2Authentifizierungsfehler (nicht angemeldet / Token ungültig)
3Netzwerk-/Verbindungsfehler

​
Globale Parameter

Die folgenden Parameter gelten für alle Befehle:
ParameterKurzformBeschreibung
--token <token>-tManage Key direkt übergeben (CI-/Skript-Szenario)
--json-jAusgabe im JSON-Format
--base-url <url>-bBenutzerdefinierte API-Adresse (Standard https://aihubmix.com)
--no-colorFarbige Ausgabe deaktivieren
--config <path>Pfad zur Konfigurationsdatei angeben
--versionVersion anzeigen

​
Konfigurationsdatei

Die Anmeldedaten werden in ~/.aihubmix/config.json gespeichert (Windows: %USERPROFILE%\.aihubmix\config.json), mit auf nur für den aktuellen Benutzer les- und schreibbar eingeschränkten Berechtigungen. Bei der Anmeldung wird der Manage Key nicht angezeigt und nicht protokolliert.
Übergeben Sie den Manage Key niemals an ein Code-Repository und teilen Sie ihn nicht mit anderen. Sollte er offengelegt werden, generieren Sie ihn in der Konsole neu – das alte Token wird sofort ungültig.

​
Häufige Fragen

Muss ich Python / Node / Go installieren? Nein. Die CLI ist eine einzelne Binärdatei, herunterladen und sofort verwenden. Was ist der Unterschied zwischen Manage Key und API Key? Der Manage Key (fd***) dient der Kontoverwaltung (Guthaben abfragen, Keys verwalten) und wird von der CLI verwendet; der API Key (sk-***) dient Modellaufrufen. Beide werden an unterschiedlichen Stellen in der Konsole generiert und dürfen nicht verwechselt werden. Wird Windows unterstützt? Ja. Für Windows, macOS und Linux werden native Binärdateien bereitgestellt. Wie verwende ich die CLI interaktionsfrei in CI / Skripten? Übergeben Sie den Manage Key über die Umgebungsvariable AIHUBMIX_TOKEN und kombinieren Sie ihn mit --json und Exit-Codes – aihubmix login ist dann nicht erforderlich. Was tun, wenn der Manage Key vergessen oder offengelegt wurde? Generieren Sie ihn unter console.aihubmix.com/setting neu – das alte Token wird damit ungültig.
Verwandte Dokumentation: Plattform-API · CliEndpoints · Altes Python-Skript · AIHubMix-Konsole
Zuletzt aktualisiert: 2026-06-22