AiHubMix CLIは、ウェブインターフェースを介さずに、AiHubMix APIキーの管理、アカウント情報の照会、AIサービスの利用を可能にするユーティリティ管理スクリプトの集合体です。本質的には、コマンドラインでの使用を容易にするためにAPI呼び出し（curlまたはPythonリクエスト）をカプセル化したものです。

​
準備

AiHubMix CLIを使用する前に、以下が必要です。

  1. AiHubMixアカウント
  2. AiHubMix設定ページから「システムアクセストークンを生成」をクリックしてアクセストークンを生成します。
  3. 必要なPython依存関係をインストールします。
pip install -U requests openai

aihubmix_cli.pyスクリプトはこちらから入手できます。

​
機能リスト

AiHubMix CLIは以下の主要機能を提供します。

​
APIエンドポイント一覧

エンドポイントHTTPメソッド説明
/api/user/selfGET現在のユーザー情報とアカウント残高を取得
/api/token/GETすべてのKEYリストを取得
/api/token/POST新しいAPI KEYを作成
/api/token/PUT既存のAPI KEYを更新
/api/token/{token_id}GET特定のKEYの詳細情報を取得
/api/token/{token_id}DELETE特定のKEYを削除
/api/token/searchGETKEYを検索 ( ?keyword=検索キーワードを使用)
/api/user/tokenGETユーザーKEYを取得
/api/modelsGETすべての利用可能なモデルリストを取得
/api/user/available_modelsGET現在のユーザーが利用可能なモデルリストを取得

​
アカウント管理

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

​
KEY管理

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

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

curl -X GET "https://aihubmix.com/api/token/search?keyword=検索キーワード" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

curl -X PUT "https://aihubmix.com/api/token/" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "KEY_ID",
    "name": "新しい名前",
    "expired_time": 86400,
    "remain_quota": 100000,
    "status": 1
  }'

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

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

​
モデル管理

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

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

​
JSON形式での出力

すべてのCLIコマンドは、プログラムによる処理を容易にするために、JSON形式で結果を出力することをサポートしています。

python aihubmix_cli.py --url "https://aihubmix.com" --token "YOUR_ACCESS_TOKEN" --action get_balance --json

​
トラブルシューティング

問題が発生した場合は、以下の解決策を試してください。

  1. 接続の問題：メインドメインへの接続が失敗した場合は、代替ドメインを使用してみてください。

    python aihubmix_cli.py --url "https://api.aihubmix.com" --token "YOUR_ACCESS_TOKEN" --action get_balance

  2. アクセストークンが無効：提供されたアクセストークンがAiHubMixウェブサイトから取得した有効なキーであることを確認してください。アクセストークンの形式は通常fd***のようになります。

  3. 権限不足：一部の操作には特定の権限が必要な場合があります。アカウントに十分な権限があることを確認してください。

  4. リクエスト失敗：ネットワーク接続を確認するか、しばらくしてから再試行してください。

​
注意事項

  • アクセストークンは、AIモデルにアクセスするための通常のAPI KEYとは異なります。
  • 各ユーザーは独自のシステムアクセストークンを持ち、そのアクセスレベルはユーザーの役割（一般ユーザー、管理者、またはルートユーザー）によって決定されます。