跳转到主要内容
GET
获取当前用户账户的剩余余额和已使用余额。此接口返回用户级别的余额信息,与具体令牌无关,用于查看用户账户的总体余额。

认证

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

接口端点

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

响应

success
boolean
请求是否成功
message
string
错误信息(仅失败时返回)
remain_balance
float
用户剩余余额(成功时返回)。
remain_credits
integer
用户剩余积分(成功时返回)。
used_balance
float
用户已使用余额(成功时返回)
used_credits
float
用户已使用积分(成功时返回)

令牌余额 vs 用户余额

使用场景

  • 查看用户账户的总体余额
  • 用于充值提醒和余额告警
  • 在用户控制面板显示账户余额
余额单位说明余额数值的单位取决于系统配置:
  • USD - 美元
  • Credits - 积分

常见错误

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