「API 价值」到底是什么意思

一份本地的 AI 编码报告可以显示一个美元数字，同时并不知道用户实际付了多少

这句话就是 Agent Island 那个 API 价值 标签背后的记账规则。App 可以从 Claude Code 与 Codex 读取 token 记录、认出模型、套用一份带日期的 API 价目表。它没法从这些记录里重建订阅账单、代金券、超额条款、税、企业折扣，或者服务商内部的额度经济学

不加限定就把结果叫成 成本，会引出错误的结论；叫成 省下的钱 更糟。站得住的那个数是一个反事实：如果每一类 token 都按这张表上的 API 费率计价，记录下来的 token 活动值多少。本文讲的是 Agent Island v1.6.1 里发布的 macOS 实现

公式

每个归一化事件保留输入 token、输出 token、缓存创建 token 和缓存读取 token。单个事件的估算是：

API 价值 =
  输入 / 1,000,000 × 输入单价
  + 输出 / 1,000,000 × 输出单价
  + 缓存创建 / 1,000,000 × 缓存创建单价
  + 缓存读取 / 1,000,000 × 缓存读取单价

费率在把带日期的模型标识规范化之后，绑定到一个具名模型上。v1.6.1 内置的快照日期是 2026-07-13

假设一个事件有 200 万输入 token、50 万输出 token 和 1000 万缓存读取 token。按每百万 3 美元、15 美元和 0.30 美元的费率，它的 API 价值是：

2 × $3 + 0.5 × $15 + 10 × $0.30 = $16.50

那是一个价目表结果。它没有说用户付了 16.50 美元

缓存输入需要按服务商分别处理

Claude Code 把缓存创建和缓存读取记成两个独立的用量字段，它们可以直接流进归一化事件

Codex 的本地记录则把缓存输入算在总输入里。先按总输入计价、再把缓存输入加一遍，会让缓存那部分被收两次费。解析器先算：

非缓存输入 = 总输入 - 缓存输入

然后对非缓存部分套用普通输入费率，对缓存部分套用缓存读取费率。一个笼统的 输入 × 费率 函数，在文件这条边界上没有足够的上下文

API 价值和 token 体量回答的是不同问题

报告保留一个包含输入、输出、缓存创建和缓存读取的全量 token 总数，也保留一个不含缓存活动的输入／输出总数。这两个都不能和 API 价值互换

1000 万缓存读取 token 可以在体量上占绝对优势，但它带的美元估算，可能远低于一个昂贵模型的少量输出。按 token 数给模型行排序、再把结果标成价值，就是把两种度量混在了一起。周报按 API 价值估算给模型排序，同时把全量 token 作为活动的头条数字

这个估算为什么可能不完整

内置的费率表总有一条维护边界。新的具名模型可能先出现在日志里，表里还没有它。在 v1.6.1 里，一个没有价格的具名模型产出零估算价值，而不是继承一个猜出来的费率。聚合会记下这个模型未定价，好让界面提醒用户

价格也会变。快照日期必须跟着计算一起走，旧报告应当被理解成「用那次构建当时可用的费率做出的估算」。当前实现也没有套用 Anthropic 的长上下文特殊价格档，所以一个符合条件的请求可能与显示的估算有出入

API 价值可以意味着什么

API 价值可以支撑一些很窄的陈述：本地日志里的 token 活动，在某份具名价目快照下有一个 API 价值估算；某个模型在这个估算里的占比高于另一个；以及在有分项费率可用时，估算对不同 token 类别用了不同的费率

它支撑不了「用户花了、省了或赚了这么多」这类说法。实际花费来自收据、计费导出、代金券余额和合同条款，而一份本地 token 台账默认一样都没有

一个有用的数字需要一个看得见的定义

界面标签用了一个约等号加上 API 价值 这几个字。产品文档和分享出去的图，需要保持同样的区分

这个数字仍然有它的职责：它让重缓存的用量变得可见，给逐模型的活动一个共同单位，也让开发者可以在一份明确的费率快照下比较不同时期。它的价值来自一个稳定的定义，而不是来自听起来像一张账单

当一个估算可能被误认成付出去的钱时，那段解释就是这个功能的一部分。把它放在数字旁边、给费率标上日期、对未知模型给出警告，并把结论限制在本地记录能证明的范围之内

Agent Island 是面向 Claude Code、Codex、Antigravity、Grok 和 Cursor 的开源状态伴侣。在 GitHub 上读源码或点个 star