Skip to main content
AIHubMix CLI est l’outil en ligne de commande officiel d’AIHubMix (exécutable 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.
Vous cherchez l’ancien script Python (aihubmix_cli.py) ? Consultez Récupérer les informations de compte via l’API. Cette page présente son successeur nouvelle génération : plus simple et plus rapide.

​
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 au PATH :
Après l’installation, rouvrez un terminal, puis exécutez 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.
Au besoin, des variables d’environnement permettent d’ajuster le comportement d’installation :

​
Démarrage rapide

Une fois connecté, toutes les commandes sont disponibles :

​
Référence des commandes

Ajoutez --help à n’importe quelle commande pour voir tous ses paramètres, par exemple aihubmix keys create --help.

​
Opérations courantes

​
Gérer les clés API

Ici, -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_TOKEN ou via --token pour 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 avec jq.
  • Codes de sortie stables : les scripts peuvent s’en servir pour déterminer le succès ou l’échec.
Signification des codes de sortie :

​
Flags globaux

Les paramètres suivants s’appliquent à toutes les commandes :

​
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.
Ne commitez jamais le Manage Key dans un dépôt de code et ne le partagez avec personne. En cas de fuite, régénérez-le depuis la console ; l’ancien jeton est immédiatement invalidé.

​
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