AI API 价格对比：以 LLM API Pricing 证据统一 Token、缓存与工具费

统一成本记录至少包含 provider、model、snapshot、endpoint、region、service tier、context band、modality、currency 和 price_version。用这些维度定位价格表，再分别记录 ordinary input、cache read、cache write、output、thinking/reasoning、tool calls、storage 与 retries。

统一不是抹平差异。Claude 缓存有写入与读取乘数，Gemini 显式缓存还涉及 token-hours 存储，OpenAI 处理层和上下文档位可能改变费率；账本为每个厂商保留 rule_id 与原始 usage，统一层只负责汇总。

证据边界：本节以 S1 支持“官方价格页按模型和处理层区分输入、缓存输入、缓存写入、输出及工具费用。”。

不同 tokenizer、系统渲染、工具 schema 和 thinking 机制会让同一文本产生不同 token。测试集必须固定输入、输出 schema、质量判定、工具集合和截止时间，分别记录实际 usage、延迟、重试与通过率。

核心指标是 cost_per_accepted_task＝全部尝试成本÷通过验收的唯一任务数。辅以 P50/P95 延迟、质量得分和失败率，才能判断低单价是否被更长输出、更多重试或更低通过率抵消。

证据边界：本节以 S2 支持“官方定价页列出模型输入输出、Prompt Caching、Message Batches、长上下文及工具费用规则。”。

通用公式可表示为 token buckets×对应费率＋cache storage＋tool usage＋retry attempts。Batch、地区或服务层不是一个全局折扣开关，而是价格查找条件或分桶乘数；每个厂商按官方规则实现独立 calculator。

页面展示不应写死会变化的模型美元值，可展示公式、价格核验日期和跳转官方页。后台保存当日价格快照，定期运行同一基准样本并生成差异，避免模型别名、促销或地区规则变化后继续输出旧结论。

证据边界：本节以 S3 支持“官方价格页按模型、模态、Standard/Batch、缓存读取与存储列出计费项。”。

决策表按实时交互、可等待离线、重复长前缀、长上下文、多模态和工具调用等工作负载分组。每组展示适用模型候选、任务成本区间、延迟、质量门槛、主要成本驱动和数据核验日。

结论使用“在本样本与本日期下”限定，不把某次基准写成永久排名。采购或路由策略还应设置重新核验触发器：价格页更新、模型快照变化、缓存命中率明显变化或重试率越过阈值。

工程落地时，为“AI API 价格对比”建立独立 article_run_id，并保存 selected_semrush_record、database、measured_on、source_snapshot_ids、content_hash、reviewer 与 gate_status。Semrush 字段只参与选词和意图决策，不进入价格公式，也不把 US 指标解释成中文或中国市场需求。

论点账本必须逐条可回放：S1 对应 C1：“OpenAI 官方价格表分别列出输入、缓存输入、输出和附加工具费用，比较账本不能把这些字段压成一个无口径单价。”；S2 对应 C2：“Claude 官方定价分别说明基础输入输出、Prompt Caching、Message Batches、长上下文和工具费用，统一模型必须保留这些修饰项。”。编辑器在段落层写入 evidenceRefs，构建检查确认引用 ID 存在；来源页面发生结构变化时，只把对应论点退回复核，不让整篇文章静默继承旧快照。

动态复核字段包括：模型 ID 与各价格桶单价、Claude/Gemini 的缓存、Batch、工具与模态费率。发布任务应读取当前页面、保留原始单位和地区、与上一快照做字段级 Diff，并记录核验日期 2026-08-29。缺失、受限或无法确认的值保持 null 或“待复核”，不使用 0、均值或相邻产品代填。

独立 SVG 采用“同一任务在三家 API 的成本桶分解”结构，输入维度为：输入 token、缓存写入/命中、输出 token、Batch、工具费。图表只绘制有来源的数据，缺失项显示空缺；alt、caption、图内标题与正文使用同一术语，并在图注标明动态字段核验日期。