OpenAI 兼容 API 手册

后台兑换码

具备 redemption.read 可查看兑换码；具备 redemption.sensitive_write 且已完成 /api/verify 可生成或停用兑换码。兑换码原文只在创建响应中返回一次，服务端仅保存 hash；停用接口会阻止后续兑换。

创建 API Key 返回中文文档

POST /api/admin/redeem-codes

Admin

curl https://api09.com/api/admin/redeem-codes \
  -H "Cookie: api09_session=..." \
  -H "Content-Type: application/json" \
  -d '{"label":"launch credits","credits":1215,"maxUses":100}'

curl -X PATCH https://api09.com/api/admin/redeem-codes/redeem_code_id \
  -H "Cookie: api09_session=..."

请求字段

字段	类型	说明
session	cookie	查看需要 redemption.read；创建/停用需要 redemption.sensitive_write 与 /api/verify。
label	string	兑换码批次标签。
credits	number	每次兑换增加的积分。
maxUses	number	最大可使用次数，默认 1。
expiresAt	string	可选 ISO datetime。
PATCH /api/admin/redeem-codes/:id	path	停用指定兑换码。

响应与计费

字段	类型	说明
data.code	string	创建时唯一返回的兑换码原文。
data.codeHash	server	不会返回给普通用户，服务端保存 hash。
data.usedCount / maxUses	number	兑换次数与上限。
data.disabledAt	datetime	停用时间。
audit	side effect	创建写 CREATE_REDEEM_CODE，停用写 DISABLE_REDEEM_CODE。

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

生产检查

兑换码原文只展示一次

停用后 /api/redeem 必须拒绝

创建和停用都必须写审计日志

后台运营兑换码充值