API 令牌管理

用户管理 API 适合自动化脚本或内部控制台集成。日常创建和删除 API 令牌，优先使用 AIOHub API 令牌管理。

管理 API 与模型调用 API 分开鉴权。通过控制台调用时可使用当前登录会话；脚本调用时使用管理访问令牌，并带上对应的 New-Api-User 请求头。模型调用使用的 sk- API 令牌不能作为管理凭证。

获取 API 令牌列表

GET /api/token/

返回当前用户可管理的 API 令牌列表。列表中的 key 字段可能是脱敏值。

创建 API 令牌

POST /api/token/

{
  "name": "codex",
  "remain_quota": 0,
  "expired_time": -1,
  "unlimited_quota": true,
  "model_limits_enabled": false,
  "model_limits": "",
  "group": "auto",
  "cross_group_retry": true,
  "allow_ips": ""
}

string

必填

API 令牌名称。建议按用途命名，例如 claude-code、codex、cherry-studio。

integer

API 令牌可用额度。设置 unlimited_quota 为 true 时，此字段不限制 API 令牌。

integer

Unix 时间戳。-1 表示不过期。

boolean

是否不限制 API 令牌额度。账户总余额仍会正常扣费。

boolean

是否启用模型白名单限制。

string

模型白名单。启用模型限制时填写。

string

API 令牌所属分组。多个分组用逗号分隔，例如 codex,codex-passthrough。

boolean

是否允许跨分组重试。通常与 auto 或多分组 API 令牌一起使用。

string

允许使用该 API 令牌的来源 IP 列表。留空表示不限制。

查询 API 令牌

GET /api/token/{id}

integer

必填

API 令牌 ID。

复制完整 API 令牌

POST /api/token/{id}/key

返回你自己的完整 API 令牌值。只在受信任环境中调用，不要把结果暴露给页面脚本、日志或其他不可信环境。

更新 API 令牌

PUT /api/token/

请求体使用与创建 API 令牌相同的字段，并包含目标 API 令牌 ID。只切换启用/禁用状态时，可使用 status_only。

删除 API 令牌

DELETE /api/token/{id}

删除后，该 API 令牌无法继续调用模型 API。已经发出的请求不一定会被立即中断。

搜索 API 令牌

GET /api/token/search?keyword=claude

string

按 API 令牌名称搜索。

使用边界

只记录和操作你自己的 API 令牌。
不要用管理 API 文档推断管理员接口；管理员能力不属于公开文档范围。
自动化脚本应先处理登录态过期、403 权限不足和 429 频率限制。

概览

模型

对话

图片

管理 API

获取 API 令牌列表

创建 API 令牌

查询 API 令牌

复制完整 API 令牌

更新 API 令牌

删除 API 令牌

搜索 API 令牌

使用边界

​获取 API 令牌列表

​创建 API 令牌

​查询 API 令牌

​复制完整 API 令牌

​更新 API 令牌

​删除 API 令牌

​搜索 API 令牌

​使用边界

获取 API 令牌列表

创建 API 令牌

查询 API 令牌

复制完整 API 令牌

更新 API 令牌

删除 API 令牌

搜索 API 令牌

使用边界