v1.1.5 更新说明

更新日期：2026-08-26

一句话概览

v1.1.5 新增 Codex Credits CDK 兑换能力。接口路径和请求字段保持不变，5 个现有兑换接口扩展 Credits 商品类型、充值数量和账号购买资格等响应信息。

变化级别

级别	结论	说明
新增接口	否	继续使用现有 5 个兑换接口。
接口路径	不变	`verifyCdk`、`precheckAccount`、`redeem`、`redeemResult`、`queryOrder` 路径不变。
请求字段	不变	Credits 兑换复用现有请求结构。
响应字段	扩展	新增 `product_type`、`credit_quantity`、`credit_purchase_eligible`。
兼容性	向后兼容	普通订阅响应省略 Credits 专属商品字段。

商品类型

字段	值	说明
`product_type`	`codex_credits`	表示当前 CDK 或订单为 Codex Credits 商品。
`credit_quantity`	大于 0 的整数	本次兑换的 Credits 数量，例如 `250`。

product_type 和 credit_quantity 仅在 Codex Credits 响应中返回。普通订阅商品省略这两个字段，现有调用方可以保持原逻辑。

接口变化

接口	新增响应字段	返回位置
`verifyCdk`	`product_type`、`credit_quantity`	成功响应顶层。
`precheckAccount`	`credit_purchase_eligible`	响应顶层。
`redeem`	`product_type`、`credit_quantity`	成功响应顶层。
`redeemResult`	`product_type`、`credit_quantity`	响应顶层和 `order` 对象。
`queryOrder`	`product_type`、`credit_quantity`	单个结果、`results[]` 和内部 `order` 对象。

CDK 校验

Codex Credits CDK 校验成功示例：

{
  "code": 200,
  "error": "",
  "activation_token": "7f2b4c6d8e...",
  "expires_in": 180,
  "expires_at": "2026-08-26T14:10:00Z",
  "provider": "openai",
  "product_name": "Codex Credits 250",
  "plan": "credits-250",
  "product_type": "codex_credits",
  "credit_quantity": 250
}

调用方看到 product_type=codex_credits 后，应将商品按 Credits 充值展示，而不是按订阅方案展示。

账号预检

Codex Credits 当前仅支持 OpenAI 个人付费账号。账号必须同时满足：

存在有效个人订阅，即 has_active_subscription=true。

套餐类型为 Plus、Go、Pro 5x 或 Pro 20x。

已开放 Credits 购买，即 credit_purchase_eligible=true。

预检成功示例：

{
  "code": 200,
  "error": "",
  "provider": "openai",
  "email": "user@example.com",
  "plan_type": "plus",
  "has_active_subscription": true,
  "credit_purchase_eligible": true,
  "eligible": true
}

新增或明确的失败提示：

场景	`error`
账号不是支持的个人付费账号	`当前账号是 xxx，仅支持个人付费账号购买 Credits`
账号未开放 Credits 购买	`当前账号暂未开放 Credits 购买`

提交兑换

请求字段保持不变：

{
  "token": "zstd64:KLUv/QBY...",
  "cdk": "AUTO-SUB-CREDITS250",
  "activation_token": "7f2b4c6d8e..."
}

提交成功响应新增 Credits 字段：

{
  "code": 200,
  "error": "",
  "provider": "openai",
  "plan": "credits-250",
  "product_name": "Codex Credits 250",
  "order_no": "SO202608260001",
  "status": "processing",
  "product_type": "codex_credits",
  "credit_quantity": 250,
  "order_query_token": "eyJvcmRlcl9ubyI6IlNPMjAyNjA4MjYwMDAxIiwiZXhwIjox..."
}

同一账号已有 Credits 订单处理中时返回：

{
  "code": 0,
  "error": "该账号已有 Credits 订单正在处理中，请等待完成后再兑换"
}

订单轮询和查询

redeemResult 和 queryOrder 的 Credits 订单会同时在结果顶层和 order 对象中返回 product_type 与 credit_quantity。

{
  "code": 200,
  "error": "",
  "cdk_status": "activated",
  "provider": "openai",
  "product_type": "codex_credits",
  "credit_quantity": 250,
  "order": {
    "order_no": "SO202608260001",
    "account": "user@example.com",
    "status": "success",
    "product_type": "codex_credits",
    "credit_quantity": 250,
    "amount_minor": 49900,
    "currency": "PHP"
  }
}

Credits 订单完成支付确认后，amount_minor 和 currency 表示实际支付金额与币种。

调用方升级建议

verifyCdk 成功后检查 product_type。

当 product_type=codex_credits 时保存并展示 credit_quantity。

调用 precheckAccount 后确认 eligible=true；Credits 商品同时关注 credit_purchase_eligible。

使用原有 redeem 请求结构提交任务。

使用 order_query_token 调用 redeemResult 轮询结果。

对重复 Credits 订单错误停止再次提交，并继续查询原订单。

兼容性说明

本次变更向后兼容。现有普通订阅调用方不会收到 product_type 和 credit_quantity；新调用方应把字段缺失视为普通订阅商品。credit_purchase_eligible 为布尔字段，普通订阅流程不依赖其值。

v1.1.5 更新说明（2026-08-26）

v1.1.5 更新说明#

一句话概览#

变化级别#

商品类型#

接口变化#

CDK 校验#

账号预检#

提交兑换#

订单轮询和查询#

调用方升级建议#

兼容性说明#