Codex 与 CC Switch 余额查询

Codex 自动显示的口径

Codex 和部分 OpenAI 兼容客户端会自动请求 billing 兼容接口。SudoCode 会保留这些接口里的 USD 字段名，但在人民币计费模式下返回人民币数值，避免客户端把余额再次按美元汇率换算。

• Codex 自动余额会显示当前 API Key 可用额度，并计入有效套餐剩余额度
• 字段名包含 USD 时，数值仍按人民币余额返回
• 如果客户端不展示余额，可以使用下面的专用接口手动查询

余额查询接口

接口只需要 SudoCode API Key，不需要网页登录。它支持 Authorization Bearer 和 x-api-key 两种传法，返回钱包余额、当前 Key 额度、有效套餐剩余额度，以及 CC Switch 直接可读的汇总字段。

• 接口地址：GET https://api.sudocode.cyou/api/account/balance
• disabled 的 Key 会被拒绝
• expired 或 exhausted 的 Key 仍可查询余额
• 如果 Key 设置了 IP 白名单，查询接口同样会检查白名单

curl https://api.sudocode.cyou/api/account/balance \
  -H "Authorization: Bearer sk-你的 SudoCode API Key"

返回字段怎么读

主余额 remaining 按钱包剩余余额加有效套餐剩余额度计算。wallet 是账户钱包，token 是当前 API Key，subscriptions 是有效套餐聚合，ccswitch 是给 CC Switch 展示用的简化结果。

• data.remaining = wallet.remaining + subscriptions.remaining
• data.token.remaining 是当前 API Key 自身剩余额度
• data.ccswitch.remaining 适合作为 CC Switch 卡片主余额
• data.ccswitch.extra 会展示 Key 可用、Key 已用和套餐剩余

CC Switch 自定义查询

在 CC Switch 中开启用量或余额查询后，选择自定义查询模板，把请求地址指向 SudoCode 余额接口。API Key 使用平时调用模型的 SudoCode Key。

({
  request: {
    url: "https://api.sudocode.cyou/api/account/balance",
    method: "GET",
    headers: {
      "Authorization": "Bearer {{apiKey}}",
      "User-Agent": "cc-switch/1.0"
    }
  },
  extractor: function(response) {
    if (response.success && response.data && response.data.ccswitch) {
      return {
        planName: "SudoCode",
        remaining: response.data.ccswitch.remaining,
        used: response.data.ccswitch.used,
        total: response.data.ccswitch.total,
        unit: response.data.ccswitch.unit || "CNY",
        extra: response.data.ccswitch.extra
      };
    }
    return {
      isValid: false,
      invalidMessage: response.message || "查询失败"
    };
  }
})

排查顺序

如果查询失败，先确认 Key 是否完整，再检查 Key 状态、IP 白名单和 Base URL。这个接口不会返回邮箱、真实 Key、发票或支付记录。

• 401 通常是 Key 缺失或无效
• 403 通常是 Key 已禁用、用户被禁用或 IP 白名单不匹配
• Codex 有余额但 CC Switch 为空时，优先检查 CC Switch 的自定义模板是否保存
• 接口域名使用 https://api.sudocode.cyou，不要加 /v1