Gemini API Batch Mode 批量請求怎麼用:50% 價格折扣、JSONL 與內聯提交寫法、適用場景

需要離線跑幾萬條翻譯、分類、摘要或評測數據,想把 Gemini API 帳單直接砍半?本文按官方文檔詳解 Batch API 的 50% 折扣計費、內聯列表與 JSONL 文件兩種提交代碼、狀態輪詢與結果取回。

NNathaniel bigo··原創首發·AI 輔助撰寫
10 分鐘讀完
資料核對於 2026-11-18 · 依據官方文檔與公開資料整理 其他 帳號

結論先說

  1. 價格直接打五折:官方 Batch API 的輸入與輸出 token 單價均為標準實時調用價格的 50%,不要求毫秒級響應的離線任務都值得切過來。
  2. 目標完成時間在 24 小時 以內:任務提交後進入後台異步隊列,大多數中小型批次幾分鐘到幾十分鐘就能跑完,但不承諾實時返回,不能拿來接在線聊天框。
  3. 小批量用內聯列表,大批量傳 JSONL 文件:總請求體小於 20 MB 的幾百條數據可直接傳數組;幾萬條規模的大任務先用 Files API 上載 .jsonl(最大 2 GB),跑完下載結果文件按 key 對齊。
  4. 文本生成與 Embeddings 向量都支持批處理:除了 generateContent 批任務,官方文檔也提供了批量生成向量的異步接口。
  5. 谷歌帳號準備與多工具訂閱入口:使用 Gemini、Google AI Studio 與 Antigravity 需具備符合地區與年齡要求的個人谷歌帳號,缺號可查看本站 谷歌帳號購買說明(含帶 2FA 的 谷歌電郵成品號),跨平台付費訂閱總覽見 AI 會員充值中心。

Gemini API 同步調用與 Batch 批量模式對比

圖:本站根據 Gemini API 官方文檔:Batch API 整理的示意圖

本文根據 Google AI for Developers 官方文檔《Batch API》《Gemini Developer API pricing》整理,資料核對於 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 Google 官方網站。

適用於誰

  • 要批量處理幾千到幾十萬條商品打標、文本翻譯、情感分類、數據集蒸餾或離線評測的開發者;
  • 經常在並發跑腳本時撞上同步接口 429 RESOURCE_EXHAUSTED 速率限制,想改成異步隊列穩妥跑完的人;
  • 搜「gemini api batch 批量請求」,想對比內聯請求(Inline)與 .jsonl 文件兩種寫法怎麼選的人。

一、什麼時候該用 Batch Mode,兩種提交方式怎麼選

在實時接口裏開多線程硬刷大批量數據,既容易觸發每分鐘請求數(RPM)限流,又要付全價。只要業務符合「結果晚幾十分鐘甚至幾小時出來也不影響」的特徵——例如夜間定時清洗評論庫、給全站舊文章補摘要、跑模型提示詞基準評測——就應該改走 client.batches。

官方 SDK 提供兩種入參方式,選型標準很明確:

對比項內聯提交(Inline Requests)JSONL 文件提交(File Input)
傳入方式代碼裏直接傳請求字典列表先拼 .jsonl 文件,經 Files API 上載後傳文件引用
體積邊界適合總載荷 小於 20 MB 的輕量批次單文件支持最大 2 GB,適合生產級海量數據
結果對齊按返回數組順序一一對應每行自帶唯一 key,輸出亂序也能精準還原
結果獲取直接讀 batch_job.dest.inlined_responses調用 client.files.download 下載輸出 .jsonl

如果你同時也在評估其他大模型的離線批處理接口,可以橫向對照本站整理過的 OpenAI Batch API 批量請求教學 與 Claude API Message Batches 教學。

二、寫法一:幾百條小任務直接用內聯請求

還沒配置好運行環境的開發者,請先完成 Gemini API Python SDK 安裝與密鑰配置。數據量不大時,不用落盤寫臨時文件,直接把多條請求塞進 src 列表創建任務即可:

python
import time
from google import genai

client = genai.Client()

inline_requests = [
    {"contents": [{"parts": [{"text": "把這段評價歸類為正面或負面:發貨很快,包裝嚴實。"}]}]},
    {"contents": [{"parts": [{"text": "把這段評價歸類為正面或負面:用了兩天就充不進電了。"}]}]},
]

batch_job = client.batches.create(
    model="gemini-2.5-flash",
    src=inline_requests,
    config={"display_name": "review-sentiment-demo"},
)
print("已創建批任務:", batch_job.name)

completed_states = {"JOB_STATE_SUCCEEDED", "JOB_STATE_FAILED", "JOB_STATE_CANCELLED", "JOB_STATE_EXPIRED"}
while batch_job.state.name not in completed_states:
    time.sleep(15)
    batch_job = client.batches.get(name=batch_job.name)

if batch_job.state.name == "JOB_STATE_SUCCEEDED":
    for idx, resp in enumerate(batch_job.dest.inlined_responses):
        print(f"第 {idx + 1} 條結果:", resp.response.text)
谷歌開發帳號與主力編程訂閱提示:若當前帳號卡在地區不支持、手機核驗或工作空間限制,可在本站選購已配置兩步驗證的 谷歌帳號成品號(即時發貨,質保首登,到手請按指引先登後改密);日常搭配主力模型開發,也可同步了解免境外卡自助兌換的 ChatGPT Plus 與 Claude Pro。

三、寫法二:生產級大批量用 JSONL 文件提交與取回

JSONL 批量任務四步標準流程

圖:本站根據 Gemini API 官方文檔:Batch API 整理的示意圖

跑成千上萬條記錄時,建議用 JSON Lines(.jsonl)格式:一行一個獨立 JSON 對象,包含自定義業務主鍵 key(如訂單號)和標準 request 體。注意同一批次所有行共用創建作業時指定的模型:

json
{"key": "item-1001", "request": {"contents": [{"parts": [{"text": "提取關鍵詞:無線降噪藍牙耳機續航40小時"}]}]}}
{"key": "item-1002", "request": {"contents": [{"parts": [{"text": "提取關鍵詞:機械鍵盤紅軸熱插拔三模連接"}]}]}}

上載文件、啟動批處理並在完成後下載解析結果的完整代碼:

python
import json, time
from google import genai
from google.genai import types

client = genai.Client()

uploaded_input = client.files.upload(
    file="batch_input.jsonl",
    config=types.UploadFileConfig(display_name="product-kw-input", mime_type="jsonl"),
)

job = client.batches.create(
    model="gemini-2.5-flash",
    src=uploaded_input.name,
    config={"display_name": "product-kw-job"},
)

done_states = {"JOB_STATE_SUCCEEDED", "JOB_STATE_FAILED", "JOB_STATE_CANCELLED", "JOB_STATE_EXPIRED"}
while job.state.name not in done_states:
    time.sleep(30)
    job = client.batches.get(name=job.name)

if job.state.name == "JOB_STATE_SUCCEEDED":
    raw_bytes = client.files.download(file=job.dest.file_name)
    for line in raw_bytes.decode("utf-8").splitlines():
        if not line.strip():
            continue
        row = json.loads(line)
        if "response" in row:
            text = row["response"]["candidates"][0]["content"]["parts"][0]["text"]
            print(row.get("key"), "=>", text.strip())
        else:
            print(row.get("key"), "單條失敗:", row.get("error"))

由於後台分佈式並發執行,輸出文件行順序不一定與輸入一致,解析時請按每行的 key 字段回寫數據庫。

四、任務管理、計費前提與注意事項

  • 計費層級與預付費準備:Batch API 面向開啟結算的項目提供高吞吐配額與五折單價;開通計費、預充值(Prepay)與設預算上限見 Gemini API 計費與預付費設定教學,各模型價格見 Gemini API 價格速查。需要準備獨立谷歌帳號綁定項目時,可參考本站 谷歌帳號購買頁。
  • 取消與清理:任務還在排隊時可調用 client.batches.cancel(name=job.name) 取消;跑完後用 client.batches.delete(name=job.name) 清理記錄。
  • 及時下載結果文件:Files API 託管文件預設保留期有限(通常 48 小時),任務變為 JOB_STATE_SUCCEEDED 後請及時把結果下載落盤。

常見問題

問:一批 JSONL 裏如果混進了幾條異常數據,會導致整批全部失敗嗎?

答:不會整批作廢。只要輸入 JSONL 語法合法成功入隊,單條請求失敗會在輸出對應行返回 error 對象,其餘正常行照常返回 response。

問:Batch Mode 裏能用結構化 JSON 輸出(response_schema)和系統指令嗎?

答:可以。在每行 request 對象的配置與 system_instruction 字段裏按標準結構寫入即可,批量抽取字段建議加上 JSON Schema。

問:為什麼提交後一直顯示 JOB_STATE_PENDING?

答:這代表作業正在異步資源池排隊。官方目標週轉窗口是 24 小時內,高峰期排隊數十分鐘至數小時均屬正常;若超 24 小時未完成則會過期且不對未完成部分扣費。

問:沒有可用的個人谷歌帳號,或者同時想開其他主流 AI 會員怎麼辦?

答:本站提供即買即發的 谷歌電郵成品號(登入方法見 谷歌帳號購買頁),同時支持支付寶、微信支付與 AlipayHK 自助充值 ChatGPT Plus、Claude Code 等主流服務,實時價格與質保細則以各商品頁說明為準。

相關教學

參考資料

  • Gemini API 官方文檔:Batch API — https://ai.google.dev/gemini-api/docs/batch-api
  • Gemini Developer API pricing — https://ai.google.dev/gemini-api/docs/pricing

Nathaniel 的更多內容

  1. 01

    獨立開發者用 ChatGPT + Codex 跑通產品全流程:市場驗證、PRD、原型到代碼上線覆盤清單

    單人做獨立產品最容易陷入「閉門寫兩個月代碼上線零用戶」或「AI 寫到一半目錄越改越崩」。本文整理「ChatGPT 負責市場驗證、PRD 與覆盤 + Codex 負責工程實現與測試」的五階段雙軌流程,附起手提示詞與 7 項上線覆盤清單。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成規範文件命名規則、整理混亂目錄樹與合併零散發票抬頭清單腳本

    面對滿桌面的「新建文件夾」「最終版2」和上百張零散電子發票,手工改名抄台帳耗時又容易漏重。本文分享先脫敏取樣、再用 ChatGPT 生成帶預演和回滾日誌的本地 Python 腳本,離線安全完成目錄整理與發票抬頭合併去重的實戰流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外電郵營銷(EDM)受眾分層文案、A/B 主題行測試與防進垃圾箱自檢

    做海外獨立站或出海 SaaS 電郵營銷(EDM),最怕千人一面群發被直接送進垃圾箱。本文結合 Gmail/Yahoo 批量發件人規範,梳理用 ChatGPT 設計受眾分層文案、批量生成 A/B 主題行矩陣並開展發前垃圾詞與合規自檢的實戰提示詞。

    ChatGPT0
  4. 04

    用 ChatGPT 寫 Notion Formula 2.0 公式、Obsidian Dataview 查詢與 Airtable 自動化腳本

    給 Notion 數據庫寫多條件 Formula 2.0 公式、給 Obsidian 寫 Dataview 動態看板,或在 Airtable 裏寫自動化腳本,經常因為一個小括號或類型不匹配報錯半天。本文整理三大工具的通用上下文喂料規範與三套直接可複製的生成提示詞。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 處理複雜 JSON / YAML / XML 字段映射、格式轉換與校驗規則編寫實戰

    對接第三方 API、遷移 Kubernetes 配置或解析政企 XML 報文時,手工對照幾百行嵌套字段既慢又容易漏掉空值與類型邊界。本文整理用 ChatGPT 完成字段映射表梳理、生成確定性轉換腳本以及編寫 JSON Schema / Pydantic / XSD 校驗規則的實戰流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 準備本科/碩士畢業論文答辯:提煉答辯 PPT 結構、模擬導師犀利追問與 3 分鐘自述稿

    畢業論文寫完後,要在 3–5 分鐘內講清研究價值並頂住答辯評委的連環追問並不輕鬆。本文整理在嚴格遵守高校學術規範的前提下,用 ChatGPT 提煉答辯 PPT 結構、打磨 3 分鐘口語自述稿並開展模擬導師犀利追問的排練流程與提示詞。

    ChatGPT0

同模型

  1. 01

    用 Google Takeout 單獨備份導出 NotebookLM 筆記本與 Gemini 記錄:只勾選指定服務不下載整個雲端硬碟的步驟

    想把 NotebookLM 裏的幾十個研究筆記本、來源副本與音頻概覽,連同 Gemini 聊天記錄一起備份到本地,又怕 Google Takeout 把整個雲端硬碟和相冊全打包?本文講清先取消全選、精準勾選兩項服務、解壓目錄查看與跨號遷移的做法。

    Gemini0
  2. 02

    Google Workspace 企業/教育版管理員怎麼在後台給成員開啟 Gemini 應用、NotebookLM 與設定年齡訪問權限

    團隊成員或學校師生登入 Google Workspace 帳號時提示無權使用 Gemini 或打不開 NotebookLM?本文按 Google 管理控制檯官方文檔整理服務開關路徑、組織部門(OU)與群組放行、18 歲年齡訪問權限設定及對話保留合規配置。

    Gemini0
  3. 03

    安卓手機預設助手換成 Gemini 後設鬧鐘、發短訊或控制智能家居失靈怎麼辦:Workspace 與實用程序擴展開啟步驟

    安卓手機把預設語音助手從 Google Assistant 換成 Gemini 後,喊它定鬧鐘、開手電筒、發短訊或開關智能燈全都沒反應?本文按官方幫助中心整理實用程序(Utilities)、Google Home 與 Workspace 關聯應用開啟步驟及鎖屏放行設定。

    Gemini0
  4. 04

    Gemini 寫長代碼或長文檔到一半突然停住、格式截斷怎麼無縫續寫:錨點接續指令與 Canvas 分塊修改技巧

    讓 Gemini 寫幾百行代碼或萬字長文時經常寫到一半突然停住、Markdown 代碼塊沒閉合,直接回「繼續」又重頭抄一遍?本文整理字面錨點續寫指令、代碼塊防亂碼補齊法與 Canvas 局部圈選修改工作流。

    Gemini0
  5. 05

    NotebookLM 中文音頻播客(Audio Overview)高階玩法:用自定義引導詞控制對談深度、受眾水平與重點章節(附模板)

    NotebookLM 生成的中文音頻播客總是泛泛而談、漏掉核心章節或夾雜生僻英文縮寫?本文按官方幫助中心整理來源勾選過濾、四種播客格式搭配與三維自定義引導詞寫法,附 4 套可直接複製的中文控場模板。

    Gemini0
  6. 06

    NotebookLM 添加 YouTube 影片、網頁或掃描版 PDF 提示「無法導入來源」怎麼辦:無字幕、反爬與純圖 PDF 逐項解決

    往 NotebookLM(Gemini Notebook)塞 YouTube 連結、外文網頁或掃描教材時總是亮紅歎號提示無法導入來源?本文按官方幫助中心逐項排查無字幕影片、反爬動態頁與加密純圖 PDF 的替代導入步驟。

    Gemini0

同產品的其他教學

  1. 01

    iPhone 操作按鈕(Action Button)或鎖屏小組件一鍵開啟 ChatGPT / Gemini 實時語音對話配置教學

    每次在 iPhone 上練口語或語音提問都要解鎖、找圖標、再點耳機按鈕太繁瑣?本文整理利用 iPhone 操作按鈕(Action Button)、iOS 18 鎖屏底部控制項、控制中心與背面輕點一鍵直達 ChatGPT 實時語音或 Gemini Live 的完整步驟。

    ChatGPTGemini0
  2. 02

    Firebase Studio(原 Project IDX)是什麼、怎麼用:瀏覽器雲端全棧開發環境搭配 Gemini 智能體實戰

    以前收藏的 Project IDX 網址為什麼跳到了 Firebase Studio?本文按 Google 官方文檔講清它的全棧雲端定位、App Prototyping 原型智能體、Code 視圖切換、.idx/dev.nix 環境定製與免費工作區上限。

    Gemini其他 AI 工具0
  3. 03

    Google Colab 內置 Gemini 編程助手怎麼用:免費雲端 GPU 筆記本自動生成數據分析代碼、修報錯與限額說明

    不用配本地 Python 環境,怎麼在 Google Colab 雲端筆記本里免費用 Gemini 自動寫數據分析代碼、一鍵修復紅字報錯並跑 Data Science Agent?本文整理四大入口用法、Secrets 密鑰管理與免費版限額。

    Gemini其他 AI 工具0
  4. 04

    Gemini API Token 計數(count_tokens)與多模態計費規則:圖片解像度、音頻秒數與影片幀率怎麼折算 Token

    傳一張高清截圖或一段 10 分鐘影片給 Gemini API 到底扣多少 Token?本文按官方文檔拆解 258 圖片切片、每秒 32 音頻與每秒 263 影片折算公式,附 count_tokens 免費預估與降本代碼。

    Gemini0
  5. 05

    Gemini API 回答被安全策略攔截(SAFETY / PROHIBITED_CONTENT)怎麼辦:閾值調節邊界與合規提示詞排查

    調用 Gemini API 翻譯文檔或分析安全日誌時返回空白、報 finish_reason: SAFETY 或 PROHIBITED_CONTENT 怎麼辦?本文詳解四類可調安全閾值代碼寫法、不可關閉的硬性紅線區別與誤報排查步驟。

    Gemini0
  6. 06

    Gemini API 圖像生成與多輪改圖怎麼調:用 google-genai SDK 出圖、局部修改與寬高比控制參數

    怎麼用 Python 代碼調用 Gemini API 生成高清配圖並像聊天一樣連續局部改圖?本文詳解 google-genai SDK 原生生圖代碼、多輪對話改圖、參考圖融合與 aspect_ratio 寬高比配置。

    Gemini0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~