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 条评论

登录 后参与评论

还没有评论,来抢沙发~