Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt

Use this file to discover all available pages before exploring further.

Die AiHubMix CLI ist eine Sammlung von Hilfsskripten, mit denen Sie Ihre AiHubMix-API-Schlüssel verwalten, Kontoinformationen abfragen und KI-Dienste nutzen können, ohne über die Weboberfläche gehen zu müssen. Sie kapselt im Wesentlichen API-Aufrufe (per curl oder Python requests) für die bequeme Nutzung in der Kommandozeile.

Voraussetzungen

Bevor Sie die AiHubMix CLI verwenden, benötigen Sie:
  1. Ein AIHubMix-Konto
  2. Einen Access Token, den Sie auf der AIHubMix-Einstellungsseite per Klick auf „Generate System Access Token” erstellen können.
  3. Die erforderlichen Python-Abhängigkeiten:
pip install -U requests openai
Das Skript aihubmix_cli.py kann hier heruntergeladen werden.

Funktionsübersicht

Die AIHubMix CLI bietet folgende Kernfunktionen:

Übersicht der API-Endpoints

EndpointHTTP-MethodeBeschreibung
/api/user/selfGETAktuelle Benutzerinformationen und Kontoguthaben abrufen
/api/token/GETListe aller Keys abrufen
/api/token/POSTEinen neuen API Key erstellen
/api/token/PUTEinen vorhandenen API Key aktualisieren
/api/token/{token_id}GETDetailinformationen eines bestimmten Keys abrufen
/api/token/{token_id}DELETEEinen bestimmten Key löschen
/api/token/searchGETNach Keys suchen (?keyword=search_term)
/api/user/tokenGETBenutzer-Keys abrufen
/api/user/available_modelsGETListe der für den aktuellen Benutzer verfügbaren Modelle abrufen

Kontostand abrufen

# Mit curl den Kontostand abrufen, Saldo = quota / 500000
curl -X GET "https://aihubmix.com/api/user/self" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

Schlüsselverwaltung

Neuen Schlüssel erstellen

curl -X POST "https://aihubmix.com/api/token/" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "New Key Name",
    "expired_time": -1,
    "remain_quota": 500000,
    "unlimited_quota": false,
    "subnet": ""
  }'

Schlüsselliste abrufen

curl -X GET "https://aihubmix.com/api/token/?num=20" \ # Adjust num parameter to change the number of output data.
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

Nach Schlüssel suchen

curl -X GET "https://aihubmix.com/api/token/search?keyword=search_term" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

Schlüssel aktualisieren

curl -X PUT "https://aihubmix.com/api/token/" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "Key_ID",
    "name": "New Name",
    "expired_time": 86400,
    "remain_quota": 100000,
    "status": 1
  }'

Schlüssel löschen

curl -X DELETE "https://aihubmix.com/api/token/Key_ID" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

Benutzer-Key abrufen

curl -X GET "https://aihubmix.com/api/user/token" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

Modellverwaltung

Verfügbare Modelle des Benutzers abrufen

curl -X GET "https://aihubmix.com/api/user/available_models" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

Ausgabe im JSON-Format

Alle CLI-Befehle unterstützen die Ausgabe im JSON-Format, was die programmatische Weiterverarbeitung erleichtert:
python aihubmix_cli.py --url "https://aihubmix.com" --token "YOUR_ACCESS_TOKEN" --action get_balance --json

Fehlerbehebung

Bei Problemen können Sie Folgendes versuchen:
  1. Verbindungsprobleme: Wenn die Hauptdomain nicht erreichbar ist, versuchen Sie eine alternative Domain:
    python aihubmix_cli.py --url "https://api.aihubmix.com" --token "YOUR_ACCESS_TOKEN" --action get_balance
    
  2. Ungültiger Access Token: Stellen Sie sicher, dass der angegebene Access Token ein gültiger Schlüssel von der AIHubMix-Website ist. Das Format eines Access Tokens lautet üblicherweise z. B. fd***.
  3. Unzureichende Berechtigungen: Manche Operationen erfordern bestimmte Berechtigungen; stellen Sie sicher, dass Ihr Konto über die nötigen Rechte verfügt.
  4. Fehlgeschlagener Request: Prüfen Sie Ihre Netzwerkverbindung oder versuchen Sie es später erneut.

Hinweise

  • Der Access Token ist nicht identisch mit dem regulären API-Schlüssel, der für den Zugriff auf KI-Modelle verwendet wird.
  • Jeder Benutzer hat seinen eigenen System-Access-Token; die Zugriffsebene wird durch die Benutzerrolle (regulärer Benutzer, Administrator oder Root-Benutzer) bestimmt.

Zuletzt aktualisiert: 2026-06-01