aihubmix). Une fois installé, vous pouvez consulter le solde du compte, gérer les clés API et lister les modèles disponibles directement depuis le terminal, sans ouvrir la console web. C’est un binaire unique, sans besoin d’installer Python, Node ou Go, qui s’installe en une seule commande ; toutes les commandes prennent en charge la sortie JSON et s’intègrent directement aux scripts, à la CI et aux agents IA (comme Claude Code).
Ce qu’il permet de faire :
- Consulter le solde : interroger en temps réel le solde du compte et le quota déjà utilisé
- Gérer les clés : créer, consulter, rechercher, modifier et supprimer des clés API
- Voir les modèles : lister les modèles disponibles pour le jeton courant
- Scriptable : sortie JSON + codes de sortie stables, naturellement adapté à l’automatisation et aux agents IA
Ne confondez pas les deux identifiants : le CLI se connecte avec le « jeton d’accès système » (Manage Key, format
fd***), à récupérer sur la console console.aihubmix.com/setting en cliquant sur « Générer un jeton d’accès système ». Il sert à gérer le compte et n’est pas la même chose que la clé API (sk-***) utilisée pour appeler les modèles.Installation
Installation en une commande (recommandée)
Copiez la commande correspondant à votre système et collez-la dans le terminal pour télécharger le binaire et l’ajouter automatiquement auPATH :
aihubmix login pour commencer.
Vous pouvez aussi télécharger manuellement le binaire de votre plateforme depuis les Releases (sous Windows :
aihubmix_windows_amd64.exe) et le placer dans un répertoire du PATH ; sur les systèmes de type Unix, exécutez chmod +x.| Variable | Description | Par défaut |
|---|---|---|
AIHUBMIX_VERSION | Installe une version spécifique (ex. v0.2.0) | latest |
AIHUBMIX_BIN_DIR | Répertoire d’installation personnalisé | Unix : /usr/local/bin ou ~/.local/bin ; Windows : %LOCALAPPDATA%\aihubmix\bin |
Démarrage rapide
Une fois connecté, toutes les commandes sont disponibles :Référence des commandes
| Commande | Rôle |
|---|---|
aihubmix login | Connexion (coller le Manage Key) |
aihubmix logout | Déconnexion, suppression des identifiants locaux |
aihubmix whoami | Affiche l’identité de connexion courante et le solde |
aihubmix me | Affiche les informations complètes du compte et le solde |
aihubmix models list | Liste les modèles actuellement disponibles |
aihubmix keys list [--num N] | Liste les clés API |
aihubmix keys search <mot-clé> | Recherche une clé par mot-clé |
aihubmix keys get <id> | Affiche les détails d’une clé spécifique |
aihubmix keys create [paramètres] | Crée une nouvelle clé |
aihubmix keys update <id> [paramètres] | Modifie une clé |
aihubmix keys delete <id> | Supprime une clé |
Opérations courantes
Gérer les clés API
-q 10 signifie que la clé a un quota de $10, et -u qu’elle n’a pas de limite de quota. La suppression demande une confirmation par défaut ; en contexte CI, ajoutez --yes pour l’ignorer.
Utilisation dans un script / un agent IA
Le CLI est très adapté à l’automatisation et peut être piloté directement par la CI, un script ou un agent IA (comme Claude Code) :- Sans connexion préalable : passez le Manage Key via la variable d’environnement
AIHUBMIX_TOKENou via--tokenpour contourner la connexion interactive (priorité :--token>AIHUBMIX_TOKEN> fichier de configuration). - Sortie JSON : ajoutez
--json(-j) à n’importe quelle commande ; les résultats normaux vont sur stdout et les erreurs sur stderr, ce qui facilite l’analyse avecjq. - Codes de sortie stables : les scripts peuvent s’en servir pour déterminer le succès ou l’échec.
| Code de sortie | Signification |
|---|---|
0 | Succès |
1 | Erreur générique (erreur de paramètre, échec métier, etc.) |
2 | Échec d’authentification (non connecté / jeton invalide) |
3 | Erreur réseau / de connexion |
Flags globaux
Les paramètres suivants s’appliquent à toutes les commandes :| Paramètre | Abréviation | Description |
|---|---|---|
--token <token> | -t | Passe directement le Manage Key (scénarios CI / script) |
--json | -j | Affiche le résultat au format JSON |
--base-url <url> | -b | URL de base de l’API personnalisée (par défaut https://aihubmix.com) |
--no-color | Désactive la sortie colorée | |
--config <path> | Spécifie le chemin du fichier de configuration | |
--version | Affiche la version |
Fichier de configuration
Les informations de connexion sont enregistrées dans~/.aihubmix/config.json (Windows : %USERPROFILE%\.aihubmix\config.json), avec des permissions restreintes à la lecture / écriture par l’utilisateur courant uniquement. Lors de la connexion, la saisie du Manage Key est masquée et n’est pas écrite dans les journaux.
Questions fréquentes
Faut-il installer Python / Node / Go ? Non. Le CLI est un binaire unique, prêt à l’emploi dès le téléchargement. Quelle est la différence entre le Manage Key et la clé API ? Le Manage Key (fd***) sert à gérer le compte (consulter le solde, gérer les clés) et est utilisé par le CLI ; la clé API (sk-***) sert à appeler les modèles. Les deux se génèrent à des endroits différents de la console et ne sont pas interchangeables.
Windows est-il pris en charge ?
Oui. Des binaires natifs sont fournis pour Windows, macOS et Linux.
Comment l’utiliser sans interaction en CI / dans un script ?
Passez le Manage Key via la variable d’environnement AIHUBMIX_TOKEN, combinée avec --json et les codes de sortie ; il n’est pas nécessaire d’exécuter aihubmix login.
Que faire si j’ai oublié ou divulgué mon Manage Key ?
Régénérez-le sur console.aihubmix.com/setting ; l’ancien jeton devient alors invalide.
Documentation connexe : API de la plateforme · CliEndpoints · Ancien script Python · Console AIHubMix
Dernière mise à jour : 2026-06-22