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 官方目錄列出的價格為每 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 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 驗證只能回答第二個問題,無法證明發票總額、地址或合約日期是否擷取正確。
供應商的 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 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 專屬請求參數前,請確認所選 endpoint 與模型的文件。
OneMux 的價格保證低 84.4% 嗎?
不保證。目錄快照所列的對應輸入與輸出費率,其價格比例為 0.156;依所列單位計算,算術差幅為 84.4%。級距、快取、重試、稅金及其他條件都可能改變實際成本。
相關文章
指南
GPT Image 2.6 Sunburst 結構化擷取 API 成本:規劃指南
根據明確的 token 假設、schema 驗證、重試次數與定價限制,估算影像轉 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 進行儲存庫程式碼變更及測試驗證迴圈的成本。