Claude API Pricing：输入输出、Prompt Caching、Batch 与长上下文

Claude API 的成本不只有输入和输出。工程账本还应记录普通输入、不同 TTL 的缓存创建、缓存读取、Message Batches 修饰、长上下文与可能的工具费用；每个桶绑定模型和费率生效日期。

统一公式可写为输入各桶 token×对应倍率或单价，再加输出与工具项。具体货币单价不写入业务代码，而从核验于 2026-08-29 的官方定价快照读取，避免模型更新后旧值继续结算。

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

截至 2026-08-29，Anthropic 官方定价说明 5 分钟缓存写入按基础输入价的 1.25 倍、1 小时写入按 2 倍、命中读取按 0.1 倍计费。对稳定前缀 B 和 N 次总调用，无缓存成本是 N×B×输入价；缓存成本是首次写入加后续读取。

Claude usage 将 input_tokens、cache_read_input_tokens 与 cache_creation_input_tokens 分开；混用 TTL 时还可看到 5 分钟和 1 小时写入的细分。真实缓存成本要逐桶乘价，不能用 total input 统一乘基础输入价。

证据边界：本节以 S2 支持“官方 token counting endpoint 接受与 Messages 相同的结构化输入并返回估计输入 token。”。

Message Batches 将多条 Messages 请求装入一个异步作业，但每条请求独立处理。官方文档截至 2026-08-29 说明，单批最多受 100,000 条请求或 256 MB 两者中先达到的限制约束，并在完成或 24 小时到期后提供结果。

Anthropic 官方定价说明 Batch 对输入和输出 token 提供 50% 折扣，Prompt Caching 的写入与读取乘数还能与 Batch 修饰符叠加。计算时保留 input_tokens、cache_creation_input_tokens、cache_read_input_tokens 和 output_tokens 四个桶。

证据边界：本节以 S3 支持“官方指南解释 cache_control、缓存写入与读取 usage、TTL 及前缀失效条件。”。

Claude token counting endpoint 接受与 Messages 相同的 system、messages、tools 等结构，可在排队前估计输入规模。估计适合做预算、模型路由和 Batch 分片，最终账单仍应使用实际响应或批次结果中的 usage。

对账表至少保留 model、input_tokens、cache_creation_input_tokens、cache_read_input_tokens、output_tokens、batch 标志和费率版本。重试必须关联原请求，避免把重复消耗误算成模型单价上涨。

证据边界：本节以 S4 支持“官方指南说明 Message Batches 的折扣、异步窗口、请求规模、custom_id 与逐项结果。”。

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

论点账本必须逐条可回放：S1 对应 C1：“Claude API 价格由基础输入输出、Prompt Caching、Batch、长上下文与工具费等可组合部分构成。”；S2 对应 C2：“token counting 只用于请求前估算，最终成本仍应依据实际 Messages usage 与缓存字段。”。编辑器在段落层写入 evidenceRefs，构建检查确认引用 ID 存在；来源页面发生结构变化时，只把对应论点退回复核，不让整篇文章静默继承旧快照。

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

独立 SVG 采用“Claude 基础费率、缓存、Batch 与长上下文叠加关系”结构，输入维度为：base input、cache write、cache read、output、Batch、long context。图表只绘制有来源的数据，缺失项显示空缺；alt、caption、图内标题与正文使用同一术语，并在图注标明动态字段核验日期。