> ## 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.

# AIHubMix CLI (outil en ligne de commande)

> AIHubMix CLI est l'outil en ligne de commande officiel d'AIHubMix : binaire unique, zéro dépendance. Depuis le terminal, consultez le solde du compte, gérez les clés API et listez les modèles disponibles, avec une prise en charge des scripts et des agents IA.

**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

<Info>
  **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](https://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.
</Info>

<Tip>
  Vous cherchez l'ancien script Python (`aihubmix_cli.py`) ? Consultez [Récupérer les informations de compte via l'API](/fr/api/Cli). Cette page présente son successeur nouvelle génération : plus simple et plus rapide.
</Tip>

## 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` :

<CodeGroup>
  ```bash macOS / Linux theme={null}
  curl -fsSL https://raw.githubusercontent.com/AIhubmix/platfrom-cli/main/install.sh | sh
  ```

  ```powershell Windows PowerShell theme={null}
  irm https://raw.githubusercontent.com/AIhubmix/platfrom-cli/main/install.ps1 | iex
  ```
</CodeGroup>

Après l'installation, **rouvrez un terminal**, puis exécutez `aihubmix login` pour commencer.

<Info>
  Vous pouvez aussi télécharger manuellement le binaire de votre plateforme depuis les [Releases](https://github.com/AIhubmix/platfrom-cli/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`.
</Info>

Au besoin, des variables d'environnement permettent d'ajuster le comportement d'installation :

| 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 :

```bash theme={null}
# 1. Connexion : ouvre automatiquement le navigateur vers la page de génération du jeton, collez le Manage Key (saisie masquée)
aihubmix login

# 2. Afficher l'identité courante et le solde
aihubmix whoami

# 3. Afficher les informations complètes du compte
aihubmix me

# 4. Lister vos clés API
aihubmix keys list
```

## 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é                                         |

<Tip>
  Ajoutez `--help` à n'importe quelle commande pour voir tous ses paramètres, par exemple `aihubmix keys create --help`.
</Tip>

## Opérations courantes

### Gérer les clés API

```bash theme={null}
# Créer une clé avec un quota de $10, limitée à certains modèles
aihubmix keys create -n prod-key -q 10 -m "gpt-4o,claude-3.5-sonnet"

# Créer une clé sans limite de quota et sans expiration
aihubmix keys create -n ci-key -u

# Renommer une clé (les autres paramètres restent inchangés)
aihubmix keys update 123 -n new-name

# Désactiver une clé
aihubmix keys update 123 --status 0

# Supprimer une clé
aihubmix keys delete 123
```

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.

```bash theme={null}
# Piloté par variable d'environnement, extraire les noms de toutes les clés
AIHUBMIX_TOKEN=fd*** aihubmix keys list --json | jq '.data[].name'

# Consulter le solde
AIHUBMIX_TOKEN=fd*** aihubmix whoami --json | jq -r '.balance'
```

Signification des codes de sortie :

| 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.

<Warning>
  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é.
</Warning>

## 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](https://console.aihubmix.com/setting) ; l'ancien jeton devient alors invalide.

***

*Documentation connexe : [API de la plateforme · CliEndpoints](/fr/api/CliEndpoints/get-self) · [Ancien script Python](/fr/api/Cli) · [Console AIHubMix](https://console.aihubmix.com)*

***

Dernière mise à jour : 2026-06-22