LLM API Ledger

LLM API 领域的可信数据账本 — 集齐主流厂商的真实用量与性能

📊 看完整榜单 → ｜ 🔧 装探针自用核账 → ｜ 💬 TG 群交流 →

为什么做这个

国内 Coding Plan 市场正在变成耍猴大赛。

你以为买的是"每月 1000 次"——结果：

• 🔥 动态倍率：同一句话，账单扣多少全看实时负载和模型路由，你以为跑 1 次，实际扣 100 倍额度也说不准——倍率表藏得越深越有鬼
• 🙈 不标承诺用量：只写"日常额度""澎湃额度"这种词，绝口不提具体多少 token
• 💰 积分通胀：某家给你一个月 820 亿——积分！ 听着是不是要上天？但计费倍率几百起步，缓存命中 2.5 积分/token、未命中 300 积分/token，算下来实际能跑的 token 远没有数字唬人。积分看着涨了 50 倍，计费系数也偷偷跟着调
• 🚫 整天 429：有限流没额度，有额度跑不出来——钱付了，token 没跑成

结果就是：你抢到的套餐到底能跑多少，没人说得清。厂商自己说的，你敢信吗？

所以我们做了这个：把厂商说的、用户实测的、官方 monitor 公布的，三方摆一起。 不卖货、不返佣、不经手 token、不经手资金——榜单存在的唯一理由，就是让你在掏钱之前看清楚自己买的是什么。

📊 榜单数据仍在补全中，我们刚起步。你用的套餐没上榜？把数据报上来，下一个就是你。

反馈与交流

• 数据有误 / 想加厂商或套餐？ 提 Issue（标 data-correction 或 vendor-request）
• 交流大模型套餐 / 上报自己的真实使用量： Telegram 群

汇集主流 LLM API 厂商的真实用量和性能数据。

不靠厂商宣传，靠用户本地装探针核账 + 众包上报脱敏数据。同套餐多用户真实流量汇聚，三方交叉验证（本地计数 vs 厂商 monitor API vs 套餐标称）。

这是什么

一个本地探针 + 厂商套餐横评榜单。你装探针自用核账（查自己被吞了多少 Token），脱敏数据可上传/提 PR 汇聚成套餐画像，平台按厂商×套餐交叉验证后公开榜单。

• 横向对比对象：厂商 × 套餐（如「智谱 GLM Coding Plan Pro」「某中转站 Claude 9.9 元套餐」），不是用户、不是性能跑分
• 数据来源：本地透传探针 + 厂商官方 monitor API（三方交叉验证）
• 不经手 Token、不经手资金

当前状态：阶段 0（零号用户自验证）

探针 PoC 已完成代码骨架（v0.1.0-alpha）。当前只在仓库维护者本人环境验证，未开放给群友。

• ✅ 透传代理 + 本地核账
• ✅ WebUI 配置页（token 走系统 keychain，不写明文）
• ✅ 智谱 monitor API 三周期额度展示（5h / weekly / 30d MCP）
• ✅ 指标补齐 6 类（用量/性能/稳定性/真伪/成本/时序）
• ✅ 一键 PR 包导出（脱敏 + token 后 4 位）
• ✅ PyInstaller 打包成单二进制
• 🚧 零号用户 3-7 天真实流量验证中
• 🚧 VitePress 榜单 / Cloudflare Workers 接收端（后续阶段）

使用

1. 下载二进制

从 Releases 下载对应平台的二进制：

2. 启动

双击运行（或 ./ledger-probe-*）。控制台会显示：

INFO probe ready — dashboard at /__ledger__

浏览器会自动打开 http://127.0.0.1:8080/__ledger__/settings（首次启动未配置 token 时）。

3. 配置

在配置页填：

• API Token（智谱就是 Claude Code 里那个 ANTHROPIC_AUTH_TOKEN）
• 厂商（智谱 GLM / DeepSeek / OpenAI / Anthropic / 中转站）
• 套餐（如智谱 Pro/Max/Lite）

Token 存在系统 keychain，绝不写明文到磁盘/日志/上传。

4. 改 IDE base_url

在 Claude Code / Cursor / 其他 IDE 里把 base_url 从厂商官方地址改成探针：

# 智谱原配置
ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic

# 改成走探针（加 /zhipu/ 前缀）
ANTHROPIC_BASE_URL=http://127.0.0.1:8080/zhipu

然后正常写代码。探针透明转发 + 采集指标，你不会感知到任何差异。

5. 看账单

打开 http://127.0.0.1:8080/__ledger__ 看：

• 今日/30 天 token 用量
• 缓存命中率
• TTFT / TPS 分布
• 状态码分布
• 超时类型分布（四分法：connect/read/ttft/stream_stall）
• 厂商声称额度（5h/weekly/30d MCP 三周期，来自 monitor API）

6. 导出数据包（提 PR / 发给维护者）

打开 http://127.0.0.1:8080/__ledger__/export：

• 选时间窗（默认最近 7 天）
• 点击「生成数据包」
• 下载 JSON 或复制 Markdown PR 描述

导出包含：聚合指标（TTFT/TPS 分布、状态码统计、超时率、缓存命中率、厂商 monitor 快照）
导出不包含：Prompt 内容、代码上下文、API key、完整 token（只保留后 4 位）

⚠ Token 安全（必读）

Token 只存在你的系统 keychain，永远不要贴到任何聊天/截图/GitHub issue/PR 里。

• ✅ 探针配置页用密码框输入，直接存 keychain
• ✅ 日志里 token 永远是 ***后 4 位
• ✅ 导出 PR 包只保留 token 后 4 位（provenance 用）
• ❌ 不要在 TG 群发完整 token
• ❌ 不要在 GitHub issue 截图带 token
• ❌ 不要把 ~/.claude.json / 环境变量直接 cat 出来

如果意外泄漏，立刻去厂商控制台吊销并重新生成：

• 智谱：https://open.bigmodel.cn → API Keys
• Z.ai：https://z.ai/manage-apikey/coding-plan/personal/apikey

指标体系（6 类）

关键护城河：D 类（真伪识别）是物理级硬证据。假中转物理上伪造不了 Prompt Caching 的毫秒级二次返回 + 计费减半。

关键反差信号：「报错率低 + 超时率高」= 阴险限流实锤（表上漂亮但实际坑人）。

状态码语义（统一）

部署架构（探针本身）

• 本地：Python + FastAPI + SQLite + HTML-in-Python（参考 api-meter）
• 打包：PyInstaller 单二进制（50-100MB，含 Python 运行时）
• 无 Docker 依赖、无外部数据库、无网络要求（除调用上游厂商）

项目路线

• 阶段 0：探针 PoC + 零号用户自验证（当前）
• 阶段 1：5-10 个群友内测（7 天数据积累）
• 阶段 2：500 人群公测
• 阶段 3：上线榜单（Cloudflare Workers + GitHub Pages + 多镜像 + 防炸架构）

后续阶段的设计文档见 EventSys eventsys.知识.技术.ai.AI算力大盘.*。

贡献

PR 通道是项目的高信任数据层。提 PR 流程：

1. 装探针跑 7 天
2. 在 /__ledger__/export 生成脱敏数据包
3. fork 本仓库，把 JSON 放到 data/reports/<vendor>/<plan>/<user-hash>-<date>.json
4. 提 PR，描述用导出页生成的 Markdown 模板

5+ 有效 PR 的贡献者可申请升 reviewer。

License

• 代码（探针、Worker、聚合脚本、前端）：GPL-3.0
• 数据（data/aggregated/，未来开放）：CC BY 4.0
• 文档（本 README、docs/）：CC BY-SA 4.0

商用闭源 fork 本项目代码将被 GPL-3.0 条款强制要求开源。

安全 / 漏洞披露

发现安全漏洞请不要开公开 issue，邮件联系维护者（见 GitHub profile）。