Skip to main content
GET
  • 查询当前用户账户的总体余额
  • 监控用户级别的使用情况
  • 支持 CORS 跨域请求
  • 实时余额监控
获取当前用户账户的剩余余额和已使用余额。此接口返回用户级别的余额信息,与具体令牌无关,用于查看用户账户的总体余额,同时会返回积分字段,固定按 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 表示有限额度

令牌余额 vs 用户余额

使用场景

  • 查看用户账户的总体余额
  • 用于充值提醒和余额告警
  • 在用户控制面板显示账户余额
余额单位说明余额数值的单位取决于系统配置:
  • USD - 美元
  • CNY - 人民币
  • Tokens - Token 数量
如果需要稳定读取积分,请优先使用 remain_creditsused_credits。这两个字段固定按 1 USD = 200 积分 换算,不受余额展示配置影响。
无限额度用户当用户被设置为无限额度时:
  • unlimited_quota 字段返回 true
  • remain_balance 字段返回 -1
  • 该用户不受额度限制,可无限使用

常见错误

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