OpenAI 兼容 API 手册

后台账本调整

具备 user.sensitive_write 且已完成 /api/verify 二次验证后，可给指定用户写入 CREDIT、REFUND 或 ADJUSTMENT ledger，用于人工加款、退款和补偿。每次操作都会记录 ADMIN_CREDIT 审计。

创建 API Key 返回中文文档

POST /api/admin/credit

Admin

curl https://api09.com/api/admin/credit \
  -H "Cookie: api09_session=..." \
  -H "Content-Type: application/json" \
  -d '{"userId":"user_id","kind":"CREDIT","credits":1000,"description":"manual top-up"}'

请求字段

字段	类型	说明
session	cookie	具备 user.sensitive_write 的登录会话，且需完成 /api/verify。
userId	string	目标用户 ID。
kind	string	CREDIT / REFUND / ADJUSTMENT，默认 CREDIT。
credits	number	正整数积分，最高 10,000,000。
description	string	账本说明，建议写明工单或运营原因。

响应与计费

字段	类型	说明
ok	boolean	操作成功标记。
ledgerEntry.id	string	新写入 ledger ID。
ledgerEntry.kind	string	账本类型。
ledgerEntry.balanceAfter	number	调整后的目标用户余额。
audit	side effect	写入 ADMIN_CREDIT，包含 adminUserId、kind、credits 和 description。

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

生产检查

接口必须要求 user.sensitive_write 与 5 分钟二次验证

后台调整只追加 ledger，不直接改余额字段

退款和补偿也必须保留 createdById

后台运营查询用户余额