跳转到主要内容
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 获取余额，余额为 quota /500000
curl -X GET "https://aihubmix.com/api/user/self" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

​
Key 管理

​
创建新 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": ""
  }'

​
获取 Key 列表

curl -X GET "https://aihubmix.com/api/token/?num=20" \ #修改num参数可以调整输出的数据数量。
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

​
搜索 Key

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

​
更新 Key

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
  }'

​
删除 Key

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

​
获取用户 Key

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