CodeGateway 真实成本与可靠性数据：可复现的延迟、成功率、计费对账

CodeGateway 真实成本与可靠性数据：可复现的延迟、成功率、计费对账

本文所有数字来自可复现脚本，不是市场部估读。延迟/成功率探针：`scripts/probe-gateway-metrics.py`；计费对账：`docs/pricing/reconcile-vs-direct.mjs`。未测维度显式标「未测」。 本页不构成任何 SLA 承诺。 正式 SLA/状态页见独立状态页项目。

TL;DR

一、计费对账：你到底付多少

1.1 三层费用（代码级事实源）

对外只说「1.07×」会低估你的全口径成本约 10 个百分点。 我们选择把充值侧也算给你看。

1.2 $10 充值示例

credit        $10.00   （你拿到的额度）
platformFee   $ 0.20   （2% 面额）
stripeFee     $ 0.73   （ceil((1020+30)/0.961) − 1020）
─────────────────────
卡上实付      $10.93   ⇒ 每 $1 额度实付 1.0930

复算：node docs/pricing/reconcile-vs-direct.mjs（脚本内置断言，数字不符即 exit 1）。

1.3 三个代表 workload 的全口径倍数

算式（以 W1 为例）：

• 官方 = 0.6M×$2 + 4.0M×$0.10(cacheRead) + 1.2M×$2.50(cacheWrite) + 0.03M×$10 = $4.90

• CG 基准价与官方一致（2026-10-15 修价后实测对齐）；×1.07 = $5.24

• 全口径 = 1.07 × 1.093（$10 充值摊销）= 1.1695

批量任务注意：CG 目前没有 batch 档。若你本来就会走官方 Batch API（5 折），W3 对比官方 Batch 直连的全口径约为 2.34×——交互式（W1/W2）不适用该对比。 微额脚注：若「恰好充够一次 workload」，固定 $0.30 Stripe 费在极小金额上占主导。现实中用户用 $10 档或免费额度覆盖，主表用摊销口径。

1.4 历史偏差（已修复，留档）

claude-sonnet-5-5 cacheRead 曾按 $0.20/MTok 计，官方现价 $0.10 ⇒ 缓存重场景全口径一度 +26.5%。2026-10-14 已修价并上生产（对照生产 GET /v1/pricing：cache_read_per_mtok=0.1），现全部 workload 统一 +17.0%。

二、可靠性实测：成功率先行，延迟慎读

2.1 测量口径（必须先看）

• 环境：https://api-test.codegateway.dev（test）

• 时间窗：2026-10-14T08:17:21Z → 08:22:40Z（5 分 19 秒）

• 口径：客户端可见端到端毫秒，冷连接（每请求新建 TLS），含本机链路

• 复跑：见 `docs/agent-cli-integration/metrics/README.md`

2.2 怎么读延迟（诚实声明）

同一次测量里的网络地板：

本机到外网的地板就有 1.4–5 秒量级，下表网关延迟主要由客户端链路主导，不能当作网关服务端性能。

因此本页不引用延迟绝对值做性能宣传。测量脚本与地板校正方法已入库；待网络正常的出口在 prod 复测后，再发布可对比的延迟数字。在此之前，任何「我们更快」的说法都不该出现——包括我们自己的营销。

2.3 成功率（可用）

成功定义 = HTTP 2xx 且响应体可解析（非流式需 choices[0]；流式需 ≥1 个非空 SSE delta）。

样本量与时间窗如上，不是长期 SLA，是我们能在公开文档里展示的可复现读数。

2.4 流式 TTFT（读数留档，不作结论）

TTFT = 首个非空 SSE data: 分片（content 或 reasoning_content）。同样受网络地板污染，不作性能结论。

三、Agent CLI 兼容性

兼容性矩阵与各 CLI 配置步骤：`docs/agent-cli-integration/`（含 Cursor / Codex / Gemini CLI 等草稿与工具）。

四、可复现集成示例

4.1 一键探测（验证你的链路）

# 需要 API key（见 4.2）
export ANTHROPIC_BASE_URL=https://api.codegateway.dev
export ANTHROPIC_AUTH_TOKEN=<你的 CodeGateway key>

# 协议级自检
curl -sS "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-6","max_tokens":16,"messages":[{"role":"user","content":"ok"}]}'

4.2 没有官方 key / 不想绑外卡？

直接在 CodeGateway 注册拿一个 key，支持支付宝等本地支付（不要求国际信用卡）。免费起步额度（具体金额以注册/定价页实时展示为准）够你把上面的探针跑通。

4.3 故障排查交叉链接

• 连接超时：Claude Code 连接超时解决方案

• 计费/额度疑问：以 GET /v1/pricing + 本页 §1 算式为准，不要用第三方缓存价

• CLI 配置：`docs/agent-cli-integration/`

五、我们没测什么（显式清单）

六、结论

1. 成本：token 侧平坦 1.07×；把充值与支付费算全，用户实付约 1.17× 官方牌价。$10 充值到手 $10.00 额度、卡上扣 $10.93。我们把算式和脚本都给你。

2. 可靠性：短窗口成功率 15/15；延迟数字因客户端网络地板暂不作结论——方法论已公开，复测后再更新。

3. 兼容：Claude Code 实测通过；Codex CLI 未测不宣称；Cursor 不支持。

4. 下一步：正常网络出口的 prod 复测、Codex CLI /v1/responses 形状核实、生产 token mix 实测。

数字有更新时本文同步改，脚本在 git 历史里可回溯。