跳轉到主要內容
AiHubMix CLI 是一個實用管理腳本集合，無需透過網頁介面，就可以管理你的 AiHubMix API 密鑰、查詢帳戶資訊以及使用 AI 服務。它本質上是封裝了 API 呼叫（curl或Python請求）以便於命令列使用。

​
準備工作

在開始使用 AiHubMix CLI 前，你需要：
  1. 一個 AiHubMix 帳號
  2. 從 AiHubMix 設定頁面 點擊「生成系統訪問令牌」生成訪問令牌 (Access Token)；
  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/searchGET搜索 KEY (使用 ?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 不同
  • 每個用戶擁有自己的系統訪問令牌，其訪問級別由用戶角色決定（普通用戶、管理員或根用戶）
⌘I