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 不同
  • 每个用户拥有自己的系统访问令牌，其访问级别由用户角色决定（普通用户、管理员或根用户）