Skip to Content

账户管理 API

AcceleAI 提供一组 RESTful API 用于程序化管理账户信息，包括余额查询、API Key 管理和模型列表获取等操作。

前置条件

  • 已注册的 AcceleAI 账户
  • 在 设置页面  生成的系统访问令牌（System Access Token）
  • 安装依赖：pip install -U requests openai

注意： 系统访问令牌（格式如 fd***）与用于调用 AI 模型的 API Key 不同，请勿混淆。

API 端点总览

功能方法端点
获取用户信息与余额GET/api/user/self
获取 Token 列表GET/api/token/
创建 TokenPOST/api/token/
更新 TokenPUT/api/token/
获取 Token 详情GET/api/token/{token_id}
删除 TokenDELETE/api/token/{token_id}
搜索 TokenGET/api/token/search?keyword=
获取用户 TokenGET/api/user/token
获取全部模型GET/api/models
获取可用模型GET/api/user/available_models

基础地址： https://api.acceleai.cn

请求头：

Authorization: Bearer <SYSTEM_ACCESS_TOKEN>
Content-Type: application/json

余额查询

获取当前账户的用户信息和余额：

import requests
 
headers = {
    "Authorization": "Bearer <SYSTEM_ACCESS_TOKEN>"
}
 
response = requests.get(
    "https://api.acceleai.cn/api/user/self",
    headers=headers
)
 
data = response.json()["data"]
balance_usd = data["quota"] / 500000
print(f"用户名: {data['username']}")
print(f"账户余额: ${balance_usd:.2f}")

换算关系： 1 美元 = 500,000 quota 单位。余额 = quota / 500000。

cURL 示例

curl https://api.acceleai.cn/api/user/self \
  -H "Authorization: Bearer <SYSTEM_ACCESS_TOKEN>"

API Key 管理

获取 Key 列表

response = requests.get(
    "https://api.acceleai.cn/api/token/",
    headers=headers,
    params={"num": 10}  # 分页参数
)
 
tokens = response.json()["data"]
for token in tokens:
    print(f"名称: {token['name']}, 状态: {'启用' if token['status'] == 1 else '禁用'}")

创建新 Key

response = requests.post(
    "https://api.acceleai.cn/api/token/",
    headers=headers,
    json={
        "name": "production-key",
        "expired_time": -1,           # -1 表示永不过期
        "remain_quota": 100000000,     # 额度上限
        "subnet": ""                   # IP 限制（留空表示不限制）
    }
)
 
new_token = response.json()["data"]
print(f"新 Key: {new_token['key']}")

更新 Key

response = requests.put(
    "https://api.acceleai.cn/api/token/",
    headers=headers,
    json={
        "id": 12345,                   # Token ID
        "name": "updated-key-name",
        "expired_time": -1,
        "remain_quota": 200000000,
        "status": 1                    # 1=启用, 0=禁用
    }
)

删除 Key

response = requests.delete(
    "https://api.acceleai.cn/api/token/12345",
    headers=headers
)

搜索 Key

response = requests.get(
    "https://api.acceleai.cn/api/token/search",
    headers=headers,
    params={"keyword": "production"}
)

模型列表

获取全部模型

返回平台聚合的所有模型列表：

response = requests.get(
    "https://api.acceleai.cn/api/models",
    headers=headers
)
 
models = response.json()["data"]
for model in models:
    print(model["id"])

获取当前账户可用模型

返回当前用户权限范围内可调用的模型：

response = requests.get(
    "https://api.acceleai.cn/api/user/available_models",
    headers=headers
)
 
available = response.json()["data"]
print(f"可用模型数量: {len(available)}")

cURL 示例

# 全部模型
curl https://api.acceleai.cn/api/models \
  -H "Authorization: Bearer <SYSTEM_ACCESS_TOKEN>"
 
# 可用模型
curl https://api.acceleai.cn/api/user/available_models \
  -H "Authorization: Bearer <SYSTEM_ACCESS_TOKEN>"

常见用途

  • 余额监控： 定时查询余额，低于阈值时自动告警
  • Key 轮换： 程序化创建和删除 Key，实现定期轮换
  • 用量审计： 结合 Key 信息和余额变化，追踪 API 用量
  • 模型发现： 获取最新可用模型列表，动态选择最优模型
内容审查ChatWise