Skip to main content
GET
  • 查询当前 API Key 的剩余额度和已使用额度
  • 监控单个令牌的使用情况
  • 支持 CORS 跨域请求
  • 实时余额监控
获取当前 API Key(令牌)的剩余余额和已使用余额。此接口用于监控单个令牌的使用情况,同时会返回积分字段,固定按 1 USD = 200 积分 换算。

Authorizations

string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

接口端点

两个端点功能相同,可以任选其一使用。

Response

boolean
请求是否成功
string
错误信息(仅失败时返回)
float
令牌剩余余额(成功时返回)。当 unlimited_quotatrue 时,该值为 -1
float
令牌已使用余额(成功时返回)
float
令牌剩余积分(成功时返回),固定按 1 USD = 200 积分 换算
float
令牌已使用积分(成功时返回)
float
积分换算比例,当前返回 200
boolean
是否为无限额度令牌。true 表示无限额度,false 表示有限额度

使用场景

  • 监控单个 API Key 的消耗情况
  • 在应用中显示当前令牌的余额
  • 设置余额告警,当余额低于阈值时通知
余额单位说明余额数值的单位取决于系统配置:
  • USD - 美元
  • CNY - 人民币
  • Tokens - Token 数量
如果需要稳定读取积分,请优先使用 remain_creditsused_credits。这两个字段固定按 1 USD = 200 积分 换算,不受余额展示配置影响。
无限额度令牌当令牌被设置为无限额度时:
  • unlimited_quota 字段返回 true
  • remain_balance 字段返回 -1
  • 该令牌不受额度限制,可无限使用

常见错误

安全提示API Key 相当于密码,请妥善保管,不要泄露给他人。生产环境请务必使用 HTTPS。