跳转到主要内容
GET
/
v1
/
balance
curl --request GET \
  --url 'https://api.apimart.ai/v1/balance' \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "remain_balance": 10.5,
  "used_balance": 2.3,
  "unlimited_quota": false
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

获取当前 API Key（令牌）的剩余余额和已使用余额。此接口用于监控单个令牌的使用情况。 
curl --request GET \
  --url 'https://api.apimart.ai/v1/balance' \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "remain_balance": 10.5,
  "used_balance": 2.3,
  "unlimited_quota": false
}

​
认证

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

​
接口端点

GET /v1/balance
GET /balance
两个端点功能相同，可以任选其一使用。

​
响应

​
success
boolean
请求是否成功
​
message
string
错误信息（仅失败时返回）
​
remain_balance
float
令牌剩余余额（成功时返回）。当 unlimited_quota 为 true 时，该值为 -1
​
used_balance
float
令牌已使用余额（成功时返回）
​
unlimited_quota
boolean
是否为无限额度令牌。true 表示无限额度，false 表示有限额度

​
使用场景

  • 监控单个 API Key 的消耗情况
  • 在应用中显示当前令牌的余额
  • 设置余额告警，当余额低于阈值时通知
余额单位说明余额数值的单位取决于系统配置：
  • USD - 美元
  • CNY - 人民币
  • Tokens - Token 数量
无限额度令牌当令牌被设置为无限额度时：
  • unlimited_quota 字段返回 true
  • remain_balance 字段返回 -1
  • 该令牌不受额度限制，可无限使用

​
常见错误

错误信息原因解决方案
无 Authorization 头未提供 Authorization 请求头添加 Authorization: Bearer sk-xxxxx 请求头
获取令牌信息失败令牌不存在或已删除检查令牌 key 是否正确
安全提示API Key 相当于密码，请妥善保管，不要泄露给他人。生产环境请务必使用 HTTPS。