Skip to main content
GET https://geekapis.com/v1/balance 接口用于查询当前 API Key（令牌）的剩余余额和已使用余额，监控单个令牌的消耗情况。同时返回积分字段，固定按 1 USD = 200 积分 换算，不受余额展示单位配置影响。
该接口支持两个等价端点，功能完全相同，可任选其一：
GET https://geekapis.com/v1/balance
GET https://geekapis.com/balance

​
鉴权

​
Authorization
string
required
Bearer Token 认证。在请求头中添加：
Authorization: Bearer YOUR_API_KEY
前往 API Key 管理页面 获取您的 API Key。

​
响应字段

​
success
boolean
请求是否成功。
​
message
string
错误信息，仅在请求失败时返回。
​
remain_balance
float
令牌剩余余额。当 unlimited_quota 为 true 时，该值返回 -1。余额单位取决于系统配置（USD / CNY / Tokens）。
​
used_balance
float
令牌已使用余额。
​
remain_credits
float
令牌剩余积分，固定按 1 USD = 200 积分 换算。推荐优先使用此字段进行余额监控。
​
used_credits
float
令牌已使用积分，固定按 1 USD = 200 积分 换算。
​
credits_per_usd
float
积分换算比例，当前固定返回 200。
​
unlimited_quota
boolean
是否为无限额度令牌。true 表示无限额度，此时 remain_balance 返回 -1。

​
代码示例

curl --request GET \
  --url 'https://geekapis.com/v1/balance' \
  --header 'Authorization: Bearer YOUR_API_KEY'

​
响应示例

200 - 查询成功（有限额度令牌）
{
  "success": true,
  "remain_balance": 10.5,
  "used_balance": 2.3,
  "remain_credits": 2100,
  "used_credits": 460,
  "credits_per_usd": 200,
  "unlimited_quota": false
}
200 - 无限额度令牌
{
  "success": true,
  "remain_balance": -1,
  "used_balance": 0,
  "remain_credits": -1,
  "used_credits": 0,
  "credits_per_usd": 200,
  "unlimited_quota": true
}
余额单位说明remain_balance 和 used_balance 的单位取决于系统配置，可能为 USD、CNY 或 Token 数量。如需稳定的跨配置读取，请优先使用 remain_credits 和 used_credits，这两个字段始终固定按 1 USD = 200 积分 换算。
无限额度令牌行为当 unlimited_quota 为 true 时，remain_balance 将返回 -1，这是正常行为，表示该令牌不受额度限制，并非错误。

​
错误码

HTTP 状态码错误信息原因解决方案
200获取令牌信息失败令牌不存在或已删除检查 Authorization 头中的 API Key 是否正确
401无 Authorization 头未提供认证请求头添加 Authorization: Bearer sk-xxxxx 请求头
429请求过于频繁触发限流降低请求频率后重试
安全提示 — API Key 相当于账户密码，请妥善保管，不要在客户端代码或公开仓库中明文暴露。生产环境请务必使用 HTTPS。