指南OneMux

Gemini 4 Carbon API 成本估算:JSON Schema 结构化提取

介绍一种可复现的 Gemini 4 Carbon 结构化提取成本估算方法,涵盖明确的 token 假设、价格比较、JSON Schema 验证和失败场景。

AI

摘要 · 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 tokens0.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 验证流程

可靠的提取流程应分别判断三个问题:

  1. 模型是否返回了可解析的 JSON?
  2. JSON 是否符合所需的 schema?
  3. 提取出的值在语义上是否正确?

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 Carbon210$0.312$1.560.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%。阶梯价格、缓存、重试、税费和其他条件都可能改变实际成本。

相关文章