获取余额
查询当前 API 账户可用余额或额度状态，适合调用前做额度检测。
这个接口用于查询当前 API 账户余额或额度状态。
GET /v1/user/balance接口概览
| 项 | 说明 |
|---|---|
| 路由 | GET /v1/user/balance |
| 鉴权 | Authorization: Bearer sk_yeehoo_xxx |
| 请求体 | 无 |
| 返回 | 200 OK + 余额对象 |
适用场景
- 控制台额度页
- 调用前额度检查
- 运营监控或预警
Authorizations
Authorization: Bearer sk_yeehoo_your_api_keyResponse
成功时通常返回余额或额度信息。
{
"available_credits": 1000,
"authorized_credits": 1200
}响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
available_credits | integer | 当前可用额度 |
authorized_credits | integer | 当前授权总额度 |
接入建议
- 对余额敏感的业务，建议在调用前先检查一次
- 如果你有多条异步任务并发提交，最好在业务层也做额度预估
- 余额页适合作为控制台、告警或自动化调度的辅助接口