指南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 官方目錄列出的價格為每 100 萬個輸入 token $2、每 100 萬個輸出 token $10。
  • OneMux 目錄列出的價格為每 100 萬個輸入 token $0.312、每 100 萬個輸出 token $1.56,公開價格比例為 0.156。
  • 除非所選 endpoint 明確支援受 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 公開的目錄。本計算中的目錄數值,輸入與輸出均以每 100 萬個 token 表示。正式部署前,請確認目前的模型頁面,因為分級、快取或時間相關的計費方式可能不同。

價格來源輸入價格輸出價格公開價格比例
官方目錄$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 驗證只能回答第二個問題,無法證明發票總額、地址或合約日期是否擷取正確。

供應商的 endpoint 可能提供結構化輸出或 JSON Schema 參數,但必須確認所選 endpoint 與模型是否相容。所提供的基準來源並未記載 Gemini 4 Carbon 是否支援強制符合 schema 的輸出。因此,以下僅是與 OpenAI 相容的請求模式範例,並非宣稱已在 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)

採用此模式前,請確認文件中記載的模型識別碼、endpoint 格式、驗證方式,以及對 response_format 和 JSON Schema 的支援情況。若不支援受約束的輸出,請要求回傳一般 JSON,進行解析與本機驗證,並只將失敗的紀錄送往重試或審查佇列。每次重試都會增加實際工作負載成本。

會改變估算結果的失敗情境

長文件

大型來源文件可能超過 endpoint 可用的上下文範圍,或需要切分。切分會改變輸入 token 用量,也可能產生多個輸出。所提供的比較沒有完整記載上下文視窗的比較,因此不要假設僅憑列出的 1M 上下文,就能界定實際擷取限制。

無效或不完整的 JSON

格式錯誤的 JSON 可能需要重試。符合 schema 的物件仍可能包含缺漏、虛構或正規化錯誤的值。追蹤解析失敗與語意審查時,應將它們與 token 成本分開記錄。

快取提示

如果重複使用指令或 schema,快取輸入定價可能影響結果。公開的 Gemini 4 Carbon 目錄快照未列出快取價格,因此本估算將所有輸入視為一般輸入。未列出的價格不代表零;在為大量使用快取的流程建模前,請確認快取的計費處理方式。

文件大小不均

單一平均值可能掩蓋成本尖峰。請測量輸入 token 的 p50、p90 和最大值,再分別估算各區間。也應明確設定輸出限制,因為冗長的 JSON、解釋或重複欄位都會增加輸出費用。

實務決策檢查清單

  • 記錄代表性文件的輸入與輸出 token 數。
  • 將官方與中介服務商的價格統一為相同單位:本文使用每 100 萬個 token 的美元價格。
  • 說明是否納入快取、級距、重試與驗證呼叫。
  • 實作前確認 endpoint 與 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 專屬請求參數前,請確認所選 endpoint 與模型的文件。

OneMux 的價格保證低 84.4% 嗎?

不保證。目錄快照所列的對應輸入與輸出費率,其價格比例為 0.156;依所列單位計算,算術差幅為 84.4%。級距、快取、重試、稅金及其他條件都可能改變實際成本。

相關文章