Gemini 4 Carbon API 成本估算:JSON Schema 结构化提取
介绍一种可复现的 Gemini 4 Carbon 结构化提取成本估算方法,涵盖明确的 token 假设、价格比较、JSON Schema 验证和失败场景。
摘要 · TL;DR
对于一个具有代表性的结构化提取请求,假设输入为 10,000 个 token、输出为 800 个 token,按照公布的目录费率计算,官方价格下的估算成本为 $0.028,OneMux 公布价格下为 $0.004368。该估算假设按 token 计费、无缓存折扣、无阶梯价格,且验证成功无需再次调用模型。
核心要点
- 比较不同服务商时,应使用相同的 token 数量和计费单位。
- 在公布的价格快照中,Gemini 4 Carbon 的官方目录价格为每 1 million input tokens $2、每 1 million output tokens $10。
- OneMux 目录列出的价格为每 1 million input tokens $0.312、每 1 million output tokens $1.56,公布的价格比为 0.156。
- 除非所选端点明确支持受 schema 约束的输出,否则 JSON Schema 验证是独立的应用步骤。
- 所提供的基准比较不能证明 Gemini 4 Carbon 的结构化提取准确率或 JSON Schema 合规性;应使用自己的代表性文档进行测量。
文章目录 (12)
简要结论
估算 Gemini 4 Carbon 的结构化提取成本,需要两个数字:发送给模型的输入 token 数量和模型返回的输出 token 数量。以10,000 个输入 token和800 个输出 token的示例工作负载为例,计算如下:
- 官方目录费率:
(10,000 × $2 / 1,000,000) + (800 × $10 / 1,000,000) = $0.028 - OneMux 公布费率:
(10,000 × $0.312 / 1,000,000) + (800 × $1.56 / 1,000,000) = $0.004368
这些是工作负载估算值,并非实测账单。不包含重试、验证失败后的调用、税费、阶梯变化,以及任何单独计费的缓存输入处理。
OneMux 是本比较的发布方,并通过统一 API 提供对 Gemini 4 Carbon 的访问。模型页面见 OneMux 上的 Gemini 4 Carbon。
价格快照与统一计费单位
以下价格采集自 OneMux 于 2026-11-12 公布的目录。本计算中的目录输入和输出价格均以每 1 million tokens 表示。生产部署前请确认当前模型页面,因为阶梯、缓存或基于时间的计费可能有所不同。
| 价格来源 | 输入价格 | 输出价格 | 公布的价格比 |
|---|---|---|---|
| 官方目录 | $2 per 1M tokens | $10 per 1M tokens | — |
| OneMux 目录 | $0.312 per 1M tokens | $1.56 per 1M tokens | 0.156 |
0.156 的价格比意味着,所列 OneMux 费率是对应官方目录费率的 15.6%。两者的算术差值为 84.4%,但不应将其视为有保证的节省幅度:最终成本可能随用量阶梯、缓存、重试、路由条件、税费或这些 token 费率之外单独计费的功能而变化。
所提供的比较页面使用所列标准 API 费率,给出了 Gemini 4 Carbon 的工作负载估算:1,000 个非缓存输入 token 加 500 个输出 token 为 $0.007,50,000 个输入 token 加 3,000 个输出 token 为 $0.13,缓存密集型工作负载为 $0.16。这些数字可作为参考,但该页面称 Gemini 4 Carbon 在这些场景下的适配状态不可用,也未公布完整的上下文比较。参见 Gemini 4 Carbon vs GPT-6 Luna,更新于 2026 年 10 月 29 日。
可复现的提取成本估算
假设将一份文档转换为包含以下内容的提示词:
- 10,000 个输入 token:指令、源文本和字段定义
- 800 个输出 token:提取出的 JSON 对象
- 不使用缓存输入费率
- 无阶梯价格
- 一次请求成功,无重试
- 在本地进行验证,不再调用模型
通用计算公式为:
cost = (input_tokens / 1,000,000 × input_price) + (output_tokens / 1,000,000 × output_price)
按官方费率计算:
- 输入:
10,000 / 1,000,000 × $2 = $0.020 - 输出:
800 / 1,000,000 × $10 = $0.008 - 合计:$0.028 per document
按 OneMux 公布费率计算:
- 输入:
10,000 / 1,000,000 × $0.312 = $0.00312 - 输出:
800 / 1,000,000 × $1.56 = $0.001248 - 合计:$0.004368 per document
对于 10,000 份文档,在相同假设下,按官方费率计算为 $280,按 OneMux 公布费率计算为 $43.68。这种乘法估算有助于规划,但没有考虑文档长度或输出大小的差异。
JSON Schema 验证流程
可靠的提取流程应分别判断三个问题:
- 模型是否返回了可解析的 JSON?
- JSON 是否符合所需的 schema?
- 提取出的值在语义上是否正确?
Schema 验证只能回答第二个问题,无法证明发票总额、地址或合同日期是否提取正确。
服务商端点可能提供结构化输出或 JSON Schema 参数,但必须确认所选端点和模型的兼容性。所提供的基准测试来源并未说明 Gemini 4 Carbon 是否支持强制遵循 schema 的输出。因此,以下仅是一个 OpenAI-compatible 请求模式示例,并不表示它已通过 OneMux 或该模型的测试:
import json
import requests
from jsonschema import validate
schema = {
"type": "object",
"properties": {
"invoice_number": {"type": "string"},
"total": {"type": "number"},
"currency": {"type": "string"}
},
"required": ["invoice_number", "total", "currency"],
"additionalProperties": False
}
payload = {
"model": "Gemini 4 Carbon",
"messages": [
{"role": "system", "content": "Extract the requested fields as JSON."},
{"role": "user", "content": invoice_text}
],
"response_format": {
"type": "json_schema",
"json_schema": {"name": "invoice", "schema": schema}
}
}
response = requests.post(API_URL, headers=AUTH_HEADERS, json=payload, timeout=60)
response.raise_for_status()
result = response.json()
content = result["choices"][0]["message"]["content"]
record = json.loads(content)
validate(instance=record, schema=schema)
采用这一模式前,请核实文档中规定的模型标识符、端点格式、身份验证方式,以及对 response_format 和 JSON Schema 的支持情况。如果不支持受约束输出,可请求普通 JSON,解析后在本地验证,并仅将失败记录送入重试或人工审核队列。每次重试都会增加实际工作负载成本。
会改变估算结果的失败场景
长文档
较大的源文档可能超出端点的可用上下文,或需要分块处理。分块会改变输入 token 总量,也可能产生多个输出。所提供的比较未给出完整且有文档依据的上下文窗口比较,因此不要仅凭列出的 1M 上下文就假定实际提取限制。
JSON 无效或不完整
格式错误的 JSON 可能需要重试。符合 schema 的对象仍可能包含缺失、幻觉生成或规范化错误的值。应将解析失败和语义审核与 token 成本分开跟踪。
缓存提示词
如果重复使用指令或 schema,缓存输入价格可能影响结果。公布的 Gemini 4 Carbon 目录快照未列出缓存价格,因此本估算将所有输入视为普通输入。未列出的价格不等于零;为缓存密集型流程建模前,请确认缓存计费方式。
文档大小不均
单一平均值可能掩盖成本峰值。应测量输入 token 的 p50、p90 和最大值,再分别估算各区间。输出限制也应明确,因为冗长的 JSON、解释文字或重复字段都会增加输出费用。
实用决策清单
- 记录代表性文档的输入和输出 token 数量。
- 统一官方与中间服务商的价格单位:本文使用每 1 million tokens 的美元价格。
- 说明估算是否包含缓存、阶梯价格、重试和验证调用。
- 实施前确认端点和 JSON Schema 参数的兼容性。
- 在本地验证每个响应,包括
additionalProperties和必填字段。 - 使用带标注的样本比较提取质量;所提供的基准测试页面不能证明这项能力。
- OneMux 价格页面或模型页面发生变化时,重新计算。
结论
对于上述 10,000 个输入 token、800 个输出 token 的示例,按官方目录费率计算,Gemini 4 Carbon 成本为 $0.028;按 OneMux 公布费率计算为 $0.004368。有用的比较不应只看醒目的数字,还应考虑完整假设,包括 token 数量、缓存处理、重试、schema 支持和验证方式。可将这些计算作为规划基准,再用自己提取语料库的实测数据替换示例中的 token 组合。
公布的价格快照
于 2026-11-12T08:00:05.707Z 从 OneMux 公布的目录采集。价格保留网站计费单位;这不是实时基准测试。阶梯、缓存或基于时间的计费可能有所不同。未知值不等于零。
| 模型 | 官方输入 | 官方输出 | OneMux 输入 | OneMux 输出 | 公布的价格比 |
|---|---|---|---|---|---|
| Gemini 4 Carbon | 2 | 10 | $0.312 | $1.56 | 0.156 |
当前 OneMux 价格。只有输入、输出和计费单位一致时,才应比较工作负载成本;阶梯条件请参阅各模型页面。
常见问题
一次 Gemini 4 Carbon JSON 提取请求需要多少费用?
在输入为 10,000 个 token、输出为 800 个 token 的示例假设下,按官方目录费率估算为 $0.028,按 OneMux 公布费率估算为 $0.004368。实际成本取决于 token 数量、重试、阶梯价格、缓存及其他计费条件。
JSON Schema 验证会增加 token 费用吗?
本地验证不会增加模型 token 费用。验证失败后的重试、修复请求或第二次模型调用会增加用量,应计入工作负载估算。
Gemini 4 Carbon 支持结构化 JSON 输出吗?
所提供的比较来源未说明 Gemini 4 Carbon 是否支持受 JSON Schema 约束的输出。使用针对 schema 的请求参数前,请确认所选端点和模型的文档。
OneMux 价格保证低 84.4% 吗?
不保证。目录快照列出的对应输入和输出费率价格比为 0.156,在所列单位下,算术差值为 84.4%。阶梯价格、缓存、重试、税费和其他条件都可能改变实际成本。
相关文章
指南
GPT Image 2.6 Sunburst API 结构化提取成本:规划指南
通过明确的 token 假设、模式验证、重试和定价限制,估算图像转 JSON 工作负载的成本。
指南
Gemini 4 Carbon API 成本:可复算的客服分流费用估算
根据明确的 token 假设、缓存计费、人工审批、重试和 OneMux 公布的价格,估算 Gemini 4 Carbon 客服分流任务的费用。
指南
GPT Image 2.6 Flare API 成本估算:通过 Schema 验证的结构化提取
为结构化提取建立可复现的 API 预算,区分已有文档的图像 token 费率与尚不明确的提取成本和 OneMux 价格。
指南
Gemini 4 Carbon API 用于代码仓库变更的成本:可复现估算
基于明确的 token、缓存和流量假设,估算 Gemini 4 Carbon 用于代码仓库变更及测试验证循环的成本。