Gemini API Pricing：模态、上下文、缓存、Batch 与工具费

Gemini Developer API 价格页按模型列出输入、输出、Context Caching、存储和 Batch 等项目；多模态模型还可能按文本、音频、图片或视频使用不同单位。比较前必须锁定 model、tier、modality 和 region。

账本不要只留 total_tokens。建议将 text_input、audio_input、cached_content、output、thinking、storage_token_hours 和 tool_usage 分列，再由费率快照计算；这样模型或模态变化不会污染历史趋势。

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

Gemini 文档将缓存分为隐式和显式两种。隐式缓存对支持的模型自动启用，但不保证命中；显式缓存由应用创建 cached content 资源并在后续请求引用，适合稳定的大型前缀和可控复用周期。

显式缓存总成本由缓存内容读取费、缓存存储费、未缓存输入费和输出费组成。存储项可表示为 cached_tokens×实际存储小时数×每百万 token 每小时价格；实际存储时长取创建到删除或到期的区间。

证据边界：本节以 S2 支持“官方指南区分 count_tokens 的请求前估算与 usage_metadata 的输入、缓存、输出和 thinking 用量。”。

Gemini Batch API 支持把较小请求列表直接内联，也支持通过 JSONL 文件提交较大任务。官方文档截至 2026-08-29 将 Inline 描述为适合总请求体低于 20 MB 的小批次，较大请求则推荐文件方式。

Gemini 官方最佳实践明确提醒，重复发送相同创建请求会生成两个独立 Batch Job。网络超时后直接重试 create 可能造成重复执行与重复计费，因此调用前要写入本地 submission_intent，并在不确定状态下先查询已知作业。

证据边界：本节以 S3 支持“官方指南区分隐式缓存和显式缓存资源，并说明 TTL 与 token-hours 存储成本。”。

请求前使用 count_tokens 做上下文检查和成本预算，请求后读取 usage_metadata 的 prompt、cached、candidates 与 thoughts 等字段。两者职责不同，估计值不应覆盖结算值。

规则核验于 2026-08-29。价格页更新后，应保留旧费率版本并只对新请求应用新快照；重算历史报表时根据请求时间选择费率，避免把涨跌幅错误归因于业务 token 变化。

证据边界：本节以 S4 支持“官方指南说明 Batch 的折扣、24 小时目标、Inline/JSONL 输入、独立限额与非幂等创建。”。

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

论点账本必须逐条可回放：S1 对应 C1：“Gemini 价格表必须同时按模型、模态、免费或付费层、Standard/Batch、缓存和工具费用读取。”；S2 对应 C2：“真实成本应从 usage_metadata 的输入、缓存、输出与 thinking 用量回填，而不是只依赖预估。”。编辑器在段落层写入 evidenceRefs，构建检查确认引用 ID 存在；来源页面发生结构变化时，只把对应论点退回复核，不让整篇文章静默继承旧快照。

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

独立 SVG 采用“Gemini 模型 × 模态 × 处理层 × 缓存成本矩阵”结构，输入维度为：model、modality、tier、context band、Batch、cache、tools。图表只绘制有来源的数据，缺失项显示空缺；alt、caption、图内标题与正文使用同一术语，并在图注标明动态字段核验日期。