OpenAI 兼容 API 手册

查询用户余额

登录态控制台查询用户余额、积分流水和最近扣费记录。用户间数据按 user_id 严格隔离。

GET /api/balance
账户
curl https://api09.com/api/balance \
  -H "Cookie: api09_session=..."

请求字段

字段类型说明
sessioncookie登录后的控制台会话。
includeLedgerquery可选,传 1 或 true 返回最近 20 条 ledger 明细。

响应与计费

字段类型说明
credits / balancenumber当前用户积分余额。
usd / usdEquivalentnumber按 200 积分 / USD 换算。
ledgerarray可选返回的最近 20 条充值、扣费、退款、补偿明细。

积分统一换算:1 USD = 200 积分。

生产检查

所有查询带 user_id
后台加款写审计日志
异常扣费保留回滚能力