生活分享

API 額度與錯誤:費用、重試與成本控制

Gemini API 的費用取決於模型、輸入輸出、服務模式及使用的工具;速率限制則決定你的專案在一段時間內能送出多少工作。本篇教你找到真正對應的用量頁面、估算一次檔案處理成本、分類錯誤,並設計有限重試與停止條件,避免把每個失敗都當成多按一次就能解決。

更新日期: 閱讀時間約 5 分鐘

LINE 分享
API 成本與重試界線的原創插畫,以文件、裝置與流程等物件呼應費用、重試與成本控制;非產品介面。
圖片:Mokaair (© Mokaair)
本篇目錄
  1. 1. 開始前:先確認計費物件
  2. 2. 讀價格表:先找模型與服務模式
  3. 3. 查額度:速率、每日限制與預算分開看
  4. 4. 錯誤分類:先修正原因,再決定是否重試
  5. 5. 成本控制:先減少不必要的工作
  6. 6. 常見問題與檢查清單
  7. 7. 完成後的檢核

Gemini API 的費用取決於模型、輸入輸出、服務模式及使用的工具;速率限制則決定你的專案在一段時間內能送出多少工作。本篇教你找到真正對應的用量頁面、估算一次檔案處理成本、分類錯誤,並設計有限重試與停止條件,避免把每個失敗都當成多按一次就能解決。

估算成本:區分輸入與輸出;查看用量:核對實際計費資料;錯誤處理:限定重試與等待
API 成本與重試界線。此為原創教學圖解,並非產品畫面或實測輸出。 · 圖片:Mokaair (© Mokaair)

開始前:先確認計費物件

先完成,記下金鑰所屬專案與模型識別字。Gemini 消費者方案的月費不等於 API 儲值或用量,CLI 也會因使用不同服務。你應在 Studio 的專案與用量頁核對,而不是從 Gemini 網頁的訂閱圖示推論程式已包含免費使用。

本文於二〇二六年九月十四日核對官方價格、額度與錯誤文件。Python 範例使用 google- 2.23.0;計算器是本地算術,沒有呼叫模型。正式支出仍以 Google 計費記錄為準,因為額外工具、快取、服務模式與適用期間都可能改變結果。

讀價格表:先找模型與服務模式

以 Gemini 3.8 Flash 的 Standard 為例,官方當前標示到二〇二六年十二月三十一日,付費輸入每百萬 token 為美元 0.75,輸出每百萬 token 為美元 3.75,輸出包含思考 token。頁面也列出二〇二七年起的不同價格,因此紀錄單價時必須同時儲存生效日期,不能只抄一個數字長期沿用。

假設一次處理使用兩千個輸入 token、五百個計費輸出 token,在上述單價且沒有其他費用時,估算為美元 0.003375。這是教學算例,不是每篇檔案的固定價格;繁體中文一個字也不等於一個 token。你需要讀取實際用量,再把它代入價格表。

estimate_cost.py · python
from decimal import Decimal


def estimate(input_tokens: int, output_tokens: int, input_usd: str, output_usd: str) -> Decimal:
    """Rates are USD per million tokens; pass the current model's pricing."""
    if min(input_tokens, output_tokens) < 0:
        raise ValueError("token 數不能是負數")
    return (Decimal(input_tokens) * Decimal(input_usd) + Decimal(output_tokens) * Decimal(output_usd)) / Decimal(1_000_000)


if __name__ == "__main__":
    # 2026-09-14:Gemini 3.8 Flash Standard,未含其他工具或儲存費。
    print(estimate(2000, 500, "0.75", "3.75"))

執行計算器應得到 0.003375。先用這種小例子驗證單位,再估算一批檔案。若價格表寫每百萬 token,卻把每千 token 的數字直接代入,結果會差很多。保留原始用量、幣別與模型,比只儲存四捨五入後的總價更方便回查。

查額度:速率、每日限制與預算分開看

官方說明速率限制會依專案層級、模型與帳號狀態變動,實際限制應在 AI Studio 檢視。每分鐘請求數、每分鐘 token 與每日使用限制不是同一件事;小請求很多次和大檔案少量呼叫,可能碰到不同限制。換一把同專案金鑰,也不應被當成繞過專案限制的方法。

  1. 到 AI Studio 選擇正確專案,檢視目前模型的可用限制。
  2. 在用量頁確認時間範圍、模型與請求量,對照自己的執行紀錄。
  3. 在計費頁確認是否已啟用付費、可用餘額及通知設定。
  4. 在應用程式設定每批檔案數、單份大小與同時執行數,先用小批次觀察。
  5. 為預算或錯誤率達門檻時設計停止機制,確認真的不再送出新請求。

帳單通知與程式停止是兩種不同機制。你的程式應有自己的操作上限,例如每次只處理指定清單、輸出已存在就先核對、錯誤超過門檻就停止。這些限制要能在測試中觸發,不能只寫在專案說明檔案裡。

錯誤分類:先修正原因,再決定是否重試

無效請求通常應檢查模型名稱、引數與檔案格式;認證或權限錯誤要檢查金鑰與專案資格;找不到資源則檢查檔案識別與儲存期限。這些情況不能靠快速重送相同內容修好。保留 HTTP 狀態與服務錯誤碼,不在記錄中輸出金鑰或整份私人檔案。

暫時性服務錯誤或速率限制,可依官方建議採指數退避並加入隨機延遲,但要有最大次數與總等待上限。SDK 本身可能已經自動重試,你再包一層重試會增加總次數;先確認目前 SDK 的行為,再決定應用層是否需要額外處理。對有外部副作用的動作,也要防止重複提交。

重試流程範例:設計規則,不是 CLI 指令 · text
取得錯誤碼與請求編號
若為無效輸入、認證或權限問題:停止並回報
若為暫時性錯誤:先確認 SDK 已重試幾次
尚在總次數與等待上限內:等待後重試
超出上限:儲存失敗狀態,不產生成功結果

這份流程的預期結果是:錯誤不會被轉成空白摘要,重試用完也不會無限等待。你可以用模擬服務依序回傳暫時錯誤與成功,確認程式只建立一次正式結果;另用權限拒絕測試,確認它立即停止,而不是持續消耗請求。

成本控制:先減少不必要的工作

對檔案摘要而言,先排除重複資料,限制輸出長度,使用能達成品質要求的模型,再衡量快取或 Batch 是否適合。不同 API 路線的功能不一定完全一致;目前官方 Interactions 說明仍列有與 generateContent 的功能差異,不要直接把 Batch 範例的引數塞進 Interactions 呼叫。

每次模型或提示詞更新,都以固定檔案比較正確率、缺漏判斷與實際用量。最便宜的一次呼叫若常需要人工重做,未必是整體成本最低的流程。用降低不合格結果流入後續工作的機會,通常比只追求短回覆更有意義。

常見問題與檢查清單

「有免費層為什麼還會失敗」免費可用不表示無限制,也不表示每個模型與工具都支援。先看目前專案限制及錯誤碼,確認是否已用盡、功能不支援或資格不符,再決定下一步。

「我只看到很短的回答,為什麼輸出用量較多」部分模型的思考 token 也列入計費輸出;工具、歷史內容與檔案輸入也可能增加用量。以回傳使用統計與官方計費定義為準,不以畫面上看得到的字數估算全部工作。

「發生逾時代表沒有計費嗎」不能這樣推論。客戶端沒收到完整回覆時,服務端可能已處理部分或全部工作。記下請求時間與識別資訊,核對用量,再判斷是否重送。會保留模型與來源指紋,讓結果更容易追蹤。

完成後的檢核

完成實作後逐項確認。
檢查項目通過條件
操作能依正文重做一次,說明每一步使用的輸入。
結果能用原始資料或可重現測試核對輸出,而非只看語氣。
延伸知道下一篇教學解決的問題,以及什麼時候需要它。

接著可以閱讀 、,把本篇的操作接到下一個工作流程。

覺得這篇整理實用嗎?分享給需要的朋友

LINE 分享
  • 生活分享

    完整實作:文件摘要與資料擷取工具

    這篇把前面學過的提示詞、API 呼叫與 JSON 驗證串成一個可執行的檔案工具。輸入一份 UTF-8 活動公告,程式產生摘要、五個固定欄位、原文引用與待確認問題,再存成待審 JSON。你會練習把模型當作資料處理的一個步驟,讓驗證與儲存仍由程式明確控制。

  • 生活分享

    API 檔案與 JSON:結構化輸出及驗證

    Gemini API 可以讀取 PDF,再把結果整理成指定的 JSON 結構。本篇用虛構活動公告示範檔案輸入、欄位設計與本地驗證。學完後,你會知道「收到合法 JSON」與「內容確實來自檔案」是兩件需要分別檢查的事,並能保留缺漏資訊而不讓模型自行補齊。

  • 生活分享

    CLI 疑難排解:登入、PATH 與設定失效

    Gemini CLI 發生問題時,先找出失敗層級,通常比重新安裝所有工具更有效。本篇建立一條可重複使用的排查路線:從找不到命令、登入失敗,到檔案權限、額度及設定未載入。你會得到能儲存的診斷紀錄,並知道修正後要重跑哪個最小測試。

資料來源

本文依據上方所列參考來源與標示之核對日期整理;票價、時刻、功能規格或服務條款可能變動,出發、預訂或購買前請至相關官方網站確認最新資訊。

生活分享