OpenAI 兼容 API 手册

兑换码充值

登录用户使用兑换码给自己的账户充值。兑换成功会在同一事务中增加 RedeemCode usedCount、写入 REDEEM ledger,并记录 REDEEM_CODE 审计。

POST /api/redeem
账户
curl https://api09.com/api/redeem \
  -H "Cookie: api09_session=..." \
  -H "Content-Type: application/json" \
  -d '{"code":"API09-LOCAL-1215"}'

请求字段

字段类型说明
sessioncookie登录后的控制台会话。
codestring兑换码原文,长度 4-80。
rate limitserver按用户限制兑换尝试频率,超限返回 429 与 Retry-After。

响应与计费

字段类型说明
okboolean兑换成功标记。
creditsnumber本次兑换增加的积分。
balanceAfternumber兑换后的账户积分余额。
ledgerside effect写入 kind=REDEEM 的 LedgerEntry。
auditside effect写入 REDEEM_CODE 审计元数据。

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

生产检查

停用或过期兑换码必须拒绝
兑换与余额更新必须同事务完成
重复兑换不能绕过 maxUses