- 监控单个令牌的使用情况
- 支持 CORS 跨域请求
- 实时余额监控
获取当前 API Key（令牌）的剩余余额和已使用余额。此接口用于监控单个令牌的使用情况。
curl --request GET \
--url 'https://claw.dualseason.com/v1/balance' \
--header 'Authorization: Bearer <token>'
{
"success": true,
"remain_balance": 10.5,
"used_balance": 2.3,
"unlimited_quota": false
}
所有接口均需要使用 Bearer Token 进行认证获取 API Key：访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加：Authorization: Bearer YOUR_API_KEY
接口端点
GET /v1/balance
GET /balance
令牌剩余余额（成功时返回）。当 unlimited_quota 为 true 时，该值为 -1
是否为无限额度令牌。true 表示无限额度，false 表示有限额度
使用场景
- 监控单个 API Key 的消耗情况
- 在应用中显示当前令牌的余额
- 设置余额告警，当余额低于阈值时通知
余额单位说明余额数值的单位取决于系统配置：
- USD - 美元
- CNY - 人民币
- Tokens - Token 数量
无限额度令牌当令牌被设置为无限额度时：
unlimited_quota 字段返回 trueremain_balance 字段返回 -1- 该令牌不受额度限制，可无限使用
常见错误
| 错误信息 | 原因 | 解决方案 |
|---|
| 无 Authorization 头 | 未提供 Authorization 请求头 | 添加 Authorization: Bearer sk-xxxxx 请求头 |
| 获取令牌信息失败 | 令牌不存在或已删除 | 检查令牌 key 是否正确 |
安全提示API Key 相当于密码，请妥善保管，不要泄露给他人。生产环境请务必使用 HTTPS。
