Skip to main content
GET
Get API key quota balance
查询当前 API Key 的调用额度(与账户积分余额独立)。若在控制台为该 Key 设置了 total_quota,则按额度限制;未设置时视为不限额。

响应字段

used_quota 说明

used_quota 表示当前这把 API Key 已累计消耗的调用额度,单位与 total_quota 一致(积分)。
  • 统计范围:仅包含通过本 Key 发起、且已成功扣费的 OpenAPI 调用,不含同账户下其他 Key。
  • 累加时机:任务提交成功并完成扣费时,将该次任务的 cost 累加到 used_quota。
  • 额度校验:当 total_quota > 0 且 used_quota >= total_quota 时,该 Key 将无法继续发起新的计费请求。
  • 与账户 used_coin 的区别:/user/balance 中的 used_coin 是用户账户维度的历史净消费;used_quota 是单 Key 维度的额度计数。
实际扣费仍从用户积分账户余额中扣除;total_quota / used_quota 仅用于限制单 Key 的最大可消费额度,不单独充值。

示例

授权

Authorization
string
header
必填

控制台创建的 API Key,格式:Bearer sk_xxx

响应

200 - application/json

Key quota

code
integer
示例:

20000

msg
string
data
object
最后修改于 2026年10月15日