AIHubMix Skill est une extension locale pour les agents de codage IA. Après installation, vous pouvez utiliser le langage naturel dans Codex, Claude Code, Cursor, Cline et d’autres agents compatibles Skills pour intégrer AIHubMix, interroger les modèles, choisir par capacité, générer des exemples et diagnostiquer les erreurs.
Ce Skill n’intègre pas de liste fixe de modèles. Il lit au besoin les modèles, prix, fenêtres de contexte, contrats de protocole et autres informations en temps réel depuis les API officielles d’AIHubMix, afin d’éviter que l’agent s’appuie sur des connaissances périmées.
Cas d’usage
| Cas | Vous pouvez dire | Ce que fait le Skill |
|---|
| Intégrer AIHubMix | “Connecte ce projet à AIHubMix” | Détecte la pile technique, choisit le bon protocole et fournit une intégration minimale exécutable |
| Interroger les modèles | “Vérifie les derniers modèles gemini disponibles” | Interroge l’API de modèles en temps réel d’AIHubMix et résume les résultats |
| Choisir par capacité | “Quels modèles avec entrée image sont disponibles ?” | Filtre les candidats par vision, génération d’images, vidéo, TTS, STT, embedding, rerank, etc. |
| Générer des exemples | “Donne-moi un exemple Anthropic messages” | Génère des exemples exécutables pour OpenAI, Anthropic, Gemini et d’autres protocoles |
| Vérifier une Key | “Aide-moi à confirmer si ce modèle est appelable” | Vérifie l’API Key et la disponibilité du modèle avec un appel réel minimal |
| Diagnostiquer une erreur | “Pourquoi ai-je ce 401 / 400 ?” | Analyse l’endpoint, le modèle, le corps d’erreur et l’ID de requête pour proposer une solution |
Prérequis
- Installer au moins un AI Agent compatible Skills, par exemple Codex, Claude Code, Cursor, Cline, Gemini CLI ou OpenCode.
- Disposer de Python 3.8 ou version ultérieure en local.
- Pour appeler réellement un modèle, préparer une AIHubMix API Key.
- Pour consulter le solde, la liste des Keys ou les modèles appelables par le compte actuel, installer et connecter le CLI officiel
aihubmix.
Installation
Option 1 : laisser l’agent l’installer
Donnez cette instruction à votre AI Agent :
Installe AIHubMix Skill depuis https://github.com/AIhubmix/skills et place-le dans le répertoire Skills de l'outil actuel.
Claude Code peut utiliser ~/.claude/skills,
Codex peut utiliser ~/.codex/skills.
Après installation, exécute python <skill>/scripts/AiHubMixAPI.py --help pour vérifier.
Option 2 : installation manuelle
# Claude Code
cp -r AiHubMixAPI ~/.claude/skills/
# Codex
cp -r AiHubMixAPI ~/.codex/skills/
Les répertoires Skills peuvent varier selon les agents. Si votre outil utilise un répertoire partagé, consultez d’abord la documentation Skills de cet agent ou laissez l’agent déterminer l’emplacement d’installation.
Facultatif : installer AIHubMix CLI
Le script AiHubMixAPI peut lire les informations publiques de modèles et de protocoles. Le solde du compte, la gestion des Keys et les modèles réellement appelables par le compte actuel nécessitent une connexion au CLI officiel.
# 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
aihubmix login
aihubmix whoami
aihubmix models list
Utilisation
Après installation, il n’est généralement pas nécessaire de mémoriser les commandes. Décrivez directement la tâche à l’agent :
Connecte ce projet Next.js à AIHubMix et lance un smoke test avec un modèle texte appelable.
Vérifie les derniers modèles de la famille Claude et leurs prix sur AIHubMix.
Quels modèles de génération d'images puis-je utiliser ? Affiche uniquement ceux que mon compte actuel peut appeler.
Cet endpoint renvoie 401. Aide-moi à déterminer si le problème vient de la Key, de la Base URL ou des permissions du modèle.
/AiHubMixAPI rechercher les derniers modèles gemini
/AiHubMixAPI diagnostiquer cette erreur 400
Utilisation en ligne de commande
Vous pouvez aussi exécuter directement le script depuis le répertoire du Skill :
# Rechercher des modèles
python scripts/AiHubMixAPI.py list --limit 20
python scripts/AiHubMixAPI.py report gemini
python scripts/AiHubMixAPI.py compare <model-a> <model-b>
# Trouver des modèles candidats par capacité
python scripts/AiHubMixAPI.py candidates --capability vision
python scripts/AiHubMixAPI.py candidates --capability image-gen
python scripts/AiHubMixAPI.py candidates --capability rerank
# Afficher uniquement les candidats appelables par le compte actuel ; nécessite le CLI aihubmix connecté
python scripts/AiHubMixAPI.py candidates --capability vision --mine
--lang zh ou définissez :
Référence rapide
| Capacité | Commande recommandée |
|---|
| Voir la liste des modèles | list |
| Rechercher un modèle ou une famille | get <model-id> / report <query> |
| Comparer plusieurs modèles | compare <model-a> <model-b> ... |
| Choisir par capacité | candidates --capability <capability> |
| Afficher seulement les modèles appelables | candidates --capability <capability> --mine |
| Vérifier l’API Key | doctor --model <model-id> |
| Vérifier l’entrée image | doctor --model <model-id> --image |
| Générer un exemple compatible OpenAI | example chat --model <model-id> |
| Générer un exemple compatible Anthropic | example messages --model <model-id> |
| Diagnostiquer les erreurs | troubleshoot --status <code> --endpoint <path> --model <model-id> |
FAQ
L’agent ne déclenche pas automatiquement le Skill
Les stratégies de déclenchement varient selon les agents. Vous pouvez d’abord appeler /AiHubMixAPI explicitement, ou décrire la demande plus clairement avec des mots-clés comme “AIHubMix”, “modèle”, “Base URL”, “API Key” ou “code d’erreur”.
Un modèle apparaît dans la liste publique, mais ma Key ne peut pas l’appeler
La liste publique indique seulement que le modèle existe sur la plateforme. Elle ne garantit pas que le compte actuel ait les permissions ou le solde nécessaires. Utilisez aihubmix models list ou candidates --mine pour vérifier la plage réellement appelable par le compte, puis doctor --model <model-id> pour une vérification réelle.
Quand faut-il installer le CLI aihubmix
Il n’est pas nécessaire pour les informations publiques. Il faut l’installer et se connecter pour les capacités liées au compte : solde, gestion des Keys, modèles appelables et filtre --mine.
L’API Key peut-elle être exposée
Le script du Skill masque les secrets. Évitez toutefois d’écrire de vraies Keys dans les fichiers du dépôt, les issues, les descriptions de PR ou les journaux de conversation. Utilisez des variables d’environnement pour le débogage local.
Ressources associées
