通过接口直接管理后台

通过PoloAPI实用管理脚本在命令行中管理密钥、查看账户和可用模型列表等

PoloAPI 是一个实用管理脚本集合，无需通过网页界面，就可以管理你的PoloAPI API 密钥、查询账户信息以及使用 AI 服务。它本质上是封装了 API 调用（curl或Python请求）以便于命令行使用。

准备工作在开始使用 PoloAPI前，你需要：

一个PoloAPI账户
从 PoloAPI设置页面点击「生成系统访问令牌」生成访问令牌 (Access Token)；
安装必要的 Python 依赖项：

Copy

pip install -U requests openai

PoloAPI_cli.py 脚本可以PoloAPIAiHubMix CLI 提供以下主要功能：

API 端点一览表

端点	HTTP 方法	描述
`/api/user/self`	GET	获取当前用户信息和账户余额
`/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/search`	GET	搜索 KEY (使用 `?keyword=搜索关键词`)
`/api/user/token`	GET	获取用户 KEY
`/api/models`	GET	获取所有可用模型列表
`/api/user/available_models`	GET	获取当前用户可用的模型列表

账户管理

Curl 获取账户余额

Python 获取账户余额

CLI 获取账户余额

Copy

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

KEY 管理

Curl 创建新 KEY

Python 创建新 KEY

CLI 创建新 KEY

Copy

curl -X POST "https://.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 获取 KEY 列表

Python 获取 KEY 列表

CLI 获取 KEY 列表

Copy

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

Curl 搜索 KEY

Python 搜索 KEY

CLI 搜索 KEY

Copy

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

Curl 更新 KEY

Python 更新 KEY

CLI 更新 KEY

Copy

curl -X PUT "https://.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 删除 KEY

Python 删除 KEY

CLI 删除 KEY

Copy

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

Curl 获取用户 KEY

Python 获取用户 KEY

CLI 获取用户 KEY

Copy

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

模型管理

Curl 获取所有可用模型

Python 获取所有可用模型

CLI 获取所有可用模型

Copy

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

Curl 获取用户可用模型

Python 获取用户可用模型

CLI 获取用户可用模型

Copy

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

使用 JSON 格式输出所有 CLI 命令都支持以 JSON 格式输出结果，方便进行程序化处理：

Copy

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

故障排除如果遇到问题，可以尝试以下解决方案：

连接问题：如果主域名连接失败，尝试使用备用域名：

Copy

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

访问令牌无效：确保提供的访问令牌是从 PoloAPI 网站获取的有效密钥。访问令牌格式通常是 fd*** 这样的形式。
权限不足：某些操作可能需要特定的权限，请确保您的账户有足够的权限。
请求失败：检查网络连接，或尝试稍后再试。

注意事项

访问令牌与用于访问 AI 模型的普通 API KEY 不同
每个用户拥有自己的系统访问令牌，其访问级别由用户角色决定（普通用户、管理员或根用户）