令牌管理

令牌（API Key）是调用 API 的凭证。除在控制台界面管理外，也可通过 API 自动化管理。

控制台操作

查看用量：查看每个令牌的已用配额、剩余配额与调用统计。
复制 Key：令牌的 sk-xxxxxxxx 在创建时仅显示一次，请及时保存。

令牌 vs 用户额度

令牌额度从用户总额度里扣除。令牌额度上限用于细分控制（例如给某个应用单独限额），不影响用户总额度本身。

API 管理

令牌管理 API 直接用 sk- 令牌本身做 Bearer 鉴权（Authorization: Bearer sk-...），可在自动化脚本里管理自己的令牌。

管理旗标

创建 / 修改令牌需要管理令牌（开通管理旗标的 key）。普通调用 key 只能查询列表；没有管理旗标时操作会返回 403 not_management_key——管理令牌请联系平台获取。

获取令牌列表

GET /v1/keys?limit=50

limit：单页数量，1–200，默认 50。
返回 JSON 数组，每项含 id、name、remain_quota、unlimited_quota、expires_at、status、用量等字段。

新建令牌

POST /v1/keys
Content-Type: application/json

{
  "name": "my-token",
  "remain_quota": 500000,
  "unlimited_quota": false,
  "expires_at": -1,
  "allowed_models": [],
  "ip_rules": "",
  "max_concurrency": 0,
  "rpm": 0
}

remain_quota：额度上限（单位为配额，500000 = $1）；unlimited_quota 为 true 时不限。
expires_at：过期 Unix 时间戳（毫秒），-1 表示永不过期。
allowed_models：留空数组表示不限模型。
ip_rules：IP 管控规则（JSON 字符串），留空表示不限。
max_concurrency / rpm：并发与每分钟请求数上限，0 表示不限。

创建成功响应中包含完整的 sk-... 明文——仅此一次返回，请立即保存。

修改令牌

PATCH /v1/keys/{id}

请求体同新建（可只传需要修改的字段）。停用令牌通过将 status 设为禁用实现，暂不提供删除。

字段以接口返回为准

新建令牌的完整字段以控制台与接口实际返回为准。

令牌管理 ​

控制台操作 ​

API 管理 ​

获取令牌列表 ​

新建令牌 ​