OpenAI 兼容 API 手册

查询 Token 余额

使用 Bearer Token 查询当前 Key 所属账户余额，也可通过 NewAPI 兼容的 token_usage 结构读取 Token 总额度、已用、剩余、每日预算、模型范围和过期时间。计费口径按目标站：1 USD = 200 积分。

创建 API Key 返回中文文档

GET /v1/balance 或 GET /api/usage/token

账户

curl "https://api09.com/v1/balance?includeLedger=1" \
  -H "Authorization: Bearer sk-api09_xxx"

curl "https://api09.com/api/usage/token" \
  -H "Authorization: Bearer sk-api09_xxx"

请求字段

字段	类型	说明
Authorization	header	Bearer sk-api09_xxx。
includeLedger	query	可选，传 1 或 true 返回当前 Key 所属账户最近 20 条 ledger 明细。
/api/usage/token	alias	兼容 NewAPI token_usage 返回结构。
/v1/dashboard/billing/usage	alias	兼容 dashboard billing usage 调用路径。

响应与计费

字段	类型	说明
credits	number	当前可用积分。
balance / usdEquivalent	number	按 200 积分 / USD 换算的余额等值。
data.object	string	token_usage。
data.total_granted / total_used / total_available	number	Token 总额度、已用额度与可用额度。
data.daily_limit / daily_used	number	每日预算与今日已用积分。
data.model_limits / expires_at	object / number	模型范围与 Unix 过期时间。
exchange_rate	number	积分 / USD 汇率。
ledger	array	可选返回的最近 20 条 ledger 明细；DEBIT 为负数，queued worker 扣费的 externalRef 必须等于 TaskLog.id。

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

生产检查

余额不足时返回 402

扣费和退款必须写 ledger

Token 用量查询写 TOKEN_USAGE_QUERY 审计

queued worker 成功后写正数 UsageLog 和负数 DEBIT ledger

不要只更新用户余额字段

查看价格页充值与兑换码