AIHubMix Skill ist eine lokale Erweiterung für AI-Coding-Agents. Nach der Installation kannst du in Codex, Claude Code, Cursor, Cline und anderen Skills-fähigen Agents per natürlicher Sprache AIHubMix integrieren, Modelle abfragen, nach Fähigkeiten auswählen, Beispiele generieren und Fehler untersuchen.
Dieser Skill enthält keine feste Modellliste. Bei Bedarf liest er Modelle, Preise, Kontextfenster, Protokollverträge und weitere Echtzeitinformationen aus offiziellen AIHubMix-APIs, damit der Agent nicht auf veraltetes Wissen zurückgreift.
Anwendungsfälle
| Szenario | Du kannst sagen | Was der Skill macht |
|---|
| AIHubMix integrieren | “Verbinde dieses Projekt mit AIHubMix” | Erkennt den Projekt-Stack, wählt das passende Protokoll und liefert eine minimale ausführbare Integration |
| Modelle abfragen | “Prüfe die neuesten verfügbaren gemini-Modelle” | Fragt die Echtzeit-Modell-API von AIHubMix ab und fasst die Ergebnisse zusammen |
| Nach Fähigkeit auswählen | “Welche Bild-Eingabemodelle sind verfügbar?” | Filtert Kandidaten nach Vision, Bildgenerierung, Video, TTS, STT, Embedding, Rerank und weiteren Fähigkeiten |
| Beispiele generieren | “Gib mir ein Anthropic-messages-Beispiel” | Erzeugt ausführbare Beispiele für OpenAI-, Anthropic-, Gemini- und weitere Protokolle |
| Key prüfen | “Hilf mir zu bestätigen, ob dieses Modell aufrufbar ist” | Prüft API Key und Modellverfügbarkeit mit einem echten Minimalaufruf |
| Fehler untersuchen | “Warum bekomme ich diesen 401 / 400?” | Analysiert Endpoint, Modell, Fehlerkörper und Request ID und schlägt eine Lösung vor |
Voraussetzungen
- Mindestens ein Skills-fähiger AI Agent ist installiert, z. B. Codex, Claude Code, Cursor, Cline, Gemini CLI oder OpenCode.
- Python 3.8 oder höher ist lokal verfügbar.
- Für echte Modellaufrufe benötigst du einen AIHubMix API Key.
- Um Guthaben, Key-Listen oder die vom aktuellen Konto aufrufbaren Modelle abzufragen, installiere zusätzlich die offizielle
aihubmix CLI und melde dich an.
Installation
Option 1: Vom Agent installieren lassen
Gib diese Anweisung an deinen aktuellen AI Agent:
Installiere AIHubMix Skill von https://github.com/AIhubmix/skills und lege es im Skills-Verzeichnis des aktuellen Tools ab.
Claude Code kann ~/.claude/skills verwenden,
Codex kann ~/.codex/skills verwenden.
Führe nach der Installation python <skill>/scripts/AiHubMixAPI.py --help aus, um sie zu prüfen.
Option 2: Manuelle Installation
# Claude Code
cp -r AiHubMixAPI ~/.claude/skills/
# Codex
cp -r AiHubMixAPI ~/.codex/skills/
Verschiedene Agents können unterschiedliche Skills-Verzeichnisse nutzen. Wenn dein Tool ein gemeinsames Verzeichnis verwendet, prüfe zuerst die Skills-Dokumentation dieses Agents oder lass den Agent den Installationsort bestimmen.
Optional: AIHubMix CLI installieren
Das Skript AiHubMixAPI kann öffentliche Modell- und Protokollinformationen lesen. Kontoguthaben, Key-Verwaltung und tatsächlich vom aktuellen Konto aufrufbare Modelle erfordern die Anmeldung über die offizielle CLI.
# Windows
irm https://raw.githubusercontent.com/AIhubmix/platfrom-cli/main/install.ps1 | iex
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/AIhubmix/platfrom-cli/main/install.sh | sh
Nach der Installation ausführen:
aihubmix login
aihubmix whoami
aihubmix models list
Verwendung
Nach der Installation musst du dir normalerweise keine Befehle merken. Beschreibe dem Agent direkt die Aufgabe:
Verbinde dieses Next.js-Projekt mit AIHubMix und führe einen Smoke Test mit einem aufrufbaren Textmodell aus.
Prüfe die neuesten Claude-Modelle und Preise auf AIHubMix.
Welche Bildgenerierungsmodelle kann ich verwenden? Zeige nur Modelle, die mein aktuelles Konto aufrufen kann.
Dieser Endpoint gibt 401 zurück. Hilf mir herauszufinden, ob es am Key, an der Base URL oder an Modellberechtigungen liegt.
Wenn der Agent den Skill nicht automatisch auslöst, rufe ihn explizit auf:
/AiHubMixAPI neueste gemini-Modelle abfragen
/AiHubMixAPI diesen 400-Fehler untersuchen
Kommandozeilennutzung
Du kannst das Skript auch direkt im Skill-Verzeichnis ausführen:
# Modelle abfragen
python scripts/AiHubMixAPI.py list --limit 20
python scripts/AiHubMixAPI.py report gemini
python scripts/AiHubMixAPI.py compare <model-a> <model-b>
# Kandidaten nach Fähigkeit finden
python scripts/AiHubMixAPI.py candidates --capability vision
python scripts/AiHubMixAPI.py candidates --capability image-gen
python scripts/AiHubMixAPI.py candidates --capability rerank
# Nur Kandidaten anzeigen, die vom aktuellen Konto aufrufbar sind; erfordert eingeloggte aihubmix CLI
python scripts/AiHubMixAPI.py candidates --capability vision --mine
Für chinesische Ausgabe füge --lang zh hinzu oder setze:
Kurzreferenz
| Fähigkeit | Empfohlener Befehl |
|---|
| Modellliste anzeigen | list |
| Modell oder Modellfamilie abfragen | get <model-id> / report <query> |
| Modelle vergleichen | compare <model-a> <model-b> ... |
| Nach Fähigkeit auswählen | candidates --capability <capability> |
| Nur aufrufbare Modelle anzeigen | candidates --capability <capability> --mine |
| API Key prüfen | doctor --model <model-id> |
| Bildeingabe prüfen | doctor --model <model-id> --image |
| OpenAI-kompatibles Beispiel erzeugen | example chat --model <model-id> |
| Anthropic-kompatibles Beispiel erzeugen | example messages --model <model-id> |
| Fehler untersuchen | troubleshoot --status <code> --endpoint <path> --model <model-id> |
FAQ
Der Agent löst den Skill nicht automatisch aus
Agents unterscheiden sich darin, wann sie Skills auslösen. Rufe zunächst /AiHubMixAPI explizit auf oder formuliere die Aufgabe direkter mit Begriffen wie “AIHubMix”, “Modell”, “Base URL”, “API Key” oder “Fehlercode”.
Ein Modell steht in der öffentlichen Liste, aber mein Key kann es nicht aufrufen
Die öffentliche Modellliste zeigt nur, dass das Modell auf der Plattform existiert. Sie garantiert nicht, dass das aktuelle Konto Berechtigung oder Guthaben dafür hat. Nutze aihubmix models list oder candidates --mine, um den tatsächlich aufrufbaren Bereich des Kontos zu prüfen, und bestätige ihn mit doctor --model <model-id>.
Wann brauche ich die aihubmix CLI
Für öffentliche Informationen ist sie nicht nötig. Für kontobezogene Funktionen wie Guthaben, Key-Verwaltung, aufrufbare Modelle und --mine-Filter musst du die CLI installieren und dich anmelden.
Wird der API Key offengelegt
Das Skill-Skript maskiert Secrets. Schreibe echte Keys trotzdem nicht in Repository-Dateien, Issues, PR-Beschreibungen oder Chat-Logs. Verwende für lokales Debugging Umgebungsvariablen.
Weitere Ressourcen