查询 API Key 额度余额
返回当前 API Key 的调用额度(与账户积分独立)。
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 的最大可消费额度,不单独充值。示例
最后修改于 2026年10月15日