API 接口
积分余额 API
GET /open/v1/balance 查询 API 密钥所属账户的当前积分余额。API 与网页端共用同一个积分余额，可用于提交前检查或余额告警。
本页目录
查询余额
http
GET /open/v1/balance返回 API 密钥所属账户的当前可用积分。API 和网页端共用同一个积分余额。
curl https://api.zroimg.com/open/v1/balance \
-H "Authorization: Bearer zk-xxxxxxxxxxxxxxxxxxxxxxxx"响应
json
{
"points": 1280
}| 字段 | 类型 | 说明 |
|---|---|---|
points | integer | 当前可用积分 |
使用建议
- 批量提交前先查询余额，避免中途出现
402 insufficient_points。 - 可以定时查询余额，低于阈值时提醒自己 购买积分。
- 余额也是验证 API 密钥是否有效的最简单方式：密钥无效时返回
401 invalid_api_key。