跳转到主要内容
GET
查询用户余额
实时查询你的用户账户当前积分余额。

使用场景

仪表盘展示

在你的应用仪表盘中展示实时账户余额

余额提醒

积分低于阈值时发送通知

充值提醒

在积分用完前提示用户充值

用量追踪

监控积分消耗并追踪消费模式

注意事项

实时余额:返回的余额反映请求时刻的当前积分数量。
频率控制:避免过度轮询。缓存余额,仅在必要时刷新(例如完成一个生成任务之后)。
积分扣除:只有生成任务成功完成时才会扣除积分。失败的任务不消耗积分。

授权

Authorization
string
header
必填

所有 API 接口都需要 Bearer Token 认证

获取 API Key:

进入 仪表盘 → API 密钥(API Key 管理页面)获取 API Key

在请求头中添加:

响应

余额获取成功

code
integer
必填

HTTP 状态码

示例:

200

data
object
必填