Passer au contenu principal

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.

L’AiHubMix CLI est un ensemble de scripts utilitaires qui vous permet de gérer vos clés API AiHubMix, d’interroger les informations de compte et d’utiliser les services d’IA sans passer par une interface web. Il encapsule essentiellement des appels d’API (avec curl ou Python requests) pour plus de commodité en ligne de commande.

Prérequis

Avant d’utiliser l’AiHubMix CLI, vous devez :
  1. Disposer d’un compte AIHubMix
  2. Générer un Access Token en cliquant sur « Generate System Access Token » sur la page Paramètres d’AIHubMix ;
  3. Installer les dépendances Python nécessaires :
pip install -U requests openai
Le script aihubmix_cli.py peut être téléchargé ici

Aperçu des fonctionnalités

L’AIHubMix CLI offre les fonctionnalités clés suivantes :

Aperçu des endpoints API

EndpointMéthode HTTPDescription
/api/user/selfGETRécupère les informations de l’utilisateur courant et le solde du compte
/api/token/GETRécupère la liste de toutes les clés
/api/token/POSTCrée une nouvelle clé API
/api/token/PUTMet à jour une clé API existante
/api/token/{token_id}GETRécupère les informations détaillées d’une clé spécifique
/api/token/{token_id}DELETESupprime une clé spécifique
/api/token/searchGETRecherche des clés (utiliser ?keyword=search_term)
/api/user/tokenGETRécupère les clés utilisateur
/api/user/available_modelsGETRécupère la liste des modèles disponibles pour l’utilisateur courant

Récupérer les informations de solde

# Using curl to retrieve balance, balance is quota / 500000
curl -X GET "https://aihubmix.com/api/user/self" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

Gestion des clés

Créer une nouvelle clé

curl -X POST "https://aihubmix.com/api/token/" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "New Key Name",
    "expired_time": -1,
    "remain_quota": 500000,
    "unlimited_quota": false,
    "subnet": ""
  }'

Récupérer la liste des clés

curl -X GET "https://aihubmix.com/api/token/?num=20" \ # Adjust num parameter to change the number of output data.
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

Rechercher une clé

curl -X GET "https://aihubmix.com/api/token/search?keyword=search_term" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

Mettre à jour une clé

curl -X PUT "https://aihubmix.com/api/token/" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "Key_ID",
    "name": "New Name",
    "expired_time": 86400,
    "remain_quota": 100000,
    "status": 1
  }'

Supprimer une clé

curl -X DELETE "https://aihubmix.com/api/token/Key_ID" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

Récupérer la clé utilisateur

curl -X GET "https://aihubmix.com/api/user/token" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

Gestion des modèles

Récupérer les modèles disponibles de l’utilisateur

curl -X GET "https://aihubmix.com/api/user/available_models" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

Sortie au format JSON

Toutes les commandes de la CLI prennent en charge la sortie des résultats au format JSON, ce qui facilite le traitement programmatique :
python aihubmix_cli.py --url "https://aihubmix.com" --token "YOUR_ACCESS_TOKEN" --action get_balance --json

Dépannage

Si vous rencontrez des problèmes, vous pouvez essayer les solutions suivantes :
  1. Problèmes de connexion : si le domaine principal échoue à se connecter, essayez d’utiliser un autre domaine :
    python aihubmix_cli.py --url "https://api.aihubmix.com" --token "YOUR_ACCESS_TOKEN" --action get_balance
    
  2. Access Token invalide : assurez-vous que l’access token fourni est une clé valide obtenue depuis le site AIHubMix. Le format de l’access token est généralement de type fd***.
  3. Permissions insuffisantes : certaines opérations peuvent nécessiter des permissions spécifiques, vérifiez que votre compte dispose des permissions adéquates.
  4. Échec de la requête : vérifiez votre connexion réseau ou réessayez ultérieurement.

Remarques

  • L’access token est différent de la clé API normale utilisée pour accéder aux modèles d’IA.
  • Chaque utilisateur dispose de son propre access token système, et le niveau d’accès est déterminé par le rôle de l’utilisateur (utilisateur régulier, administrateur ou utilisateur root).

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