如何免费使用 Gemini Decisions API
你现在就可以免费使用 Gemini Decisions API。[待核实] Google 为 gemini-decision-1 提供的免费档位(Free tier)不收取输入费用,输出 token 计费为 0,且每个项目允许每分钟 200 次请求(RPM)、每分钟 50,000 tokens(TPM)以及每天 10,000 次请求(RPD)。你只需要一个 AI Studio API 密钥,无需绑定计费账户。需要注意的是:在免费档位下,Google 可能会使用你的内容来改进其产品。
下文将解析这些限制在实际工作负载中的含义、付费档位[待核实]每百万 token $0.10 背后的 token 计算方式、其他 $0 免费途径,以及如何避免测试和 CI 消耗你的每日配额。文中所有配额和价格均于 2026 年 11 月 12 日读取自 Google 官方页面。该 API 目前以 v1beta 版本提供,做预算前请再次核实。关于问题类型本身(noul、choice、score)的详细说明,请参阅 Google 的 Decisions API 指南。
AI Coding 交流群
如果你也在用 AI 写代码,或者正在研究 Cursor、Claude Code 这些工具,欢迎加入以下交流群。群里平时会聊一些 AI 编程的实际用法、开发工作流,还有各种新工具和新玩法。
Gemini Decisions API 免费档位包含什么?
Gemini Decisions API 免费档位是 Google Gemini Developer API 针对 gemini-decision-1 模型提供的零成本使用层级。它为每个 Google Cloud 项目提供免费的输入处理、零输出费用,以及[待核实] 固定的 200 RPM、50,000 TPM 和 10,000 RPD 速率限制,且无需设置计费方式。

| 项目 | 免费档位(Free tier) | 付费档位(Tier 1) |
|---|---|---|
| 输入价格(文本、图像、视频、音频、PDF) | [待核实] 免费 | [待核实] 每百万 tokens $0.10 |
| 输出价格 | 不适用(0 输出 tokens) | 不适用(0 输出 tokens) |
| 每分钟请求数(RPM) | [待核实] 200 | [待核实] 1,500 |
| 每分钟 token 数(TPM) | [待核实] 50,000 | [待核实] 1,000,000 |
| 每日请求数(RPD) | [待核实] 10,000 | [待核实] 50,000 |
| 内容是否用于改进 Google 产品 | 是 | 否 |
| 上下文缓存(Context caching) | 不支持 | 不支持 |
有三个细节比表面数字更重要:
- 限额按项目(Project)计算,而非按 API 密钥计算。 在同一个项目中创建五个密钥并不会给你带来五份配额。
- [待核实] 每日上限在太平洋时间午夜重置。 如果批处理任务在太平洋时间晚上 11 点启动,可以在当晚最后 1 小时使用当天的配额,并在午夜过后立刻获得新一天完整的 10,000 次请求额度。
- 免费档位的数据可能被 Google 使用。 定价表将“用于改进我们的产品(Used to improve our products)”在免费档位标记为“是”,在付费档位标记为“否”。切勿通过免费密钥发送客户个人身份信息(PII)、合同或医疗影像。
[待核实]

如何获取免费的 Gemini Decisions API 密钥
大约五分钟内即可开始发起免费调用:
- 登录 Google AI Studio 并点击 Create API key。新建项目默认处于免费档位。
- 安装 3.2 或更高版本的 SDK:
pip install -U google-genai或npm install @google/genai@latest。 - 将密钥导出为
GEMINI_API_KEY环境变量,以便 SDK 自动读取。 - 带上
http_options={"api_version": "v1beta"}发送一次请求,并读取响应中的usage字段。
from google import genai
client = genai.Client(http_options={"api_version": "v1beta"})
result = client.decisions.create(
model="gemini-decision-1",
input="Order 8821 arrived with a cracked screen.",
questions={
"is_damaged": {"type": "noul", "instructions": "Did the item arrive damaged?"},
},
)
print(result.answers["is_damaged"].noul)
print(result.usage.total_input_tokens)
[待核实] usage.total_input_tokens 这个数字值得记录到日志中。在免费档位下,它消耗的是你 50,000 TPM 的额度;在付费档位下,它是唯一向你计费的指标。
如需了解 Google 的其他免费额度政策,请参阅我们的 Gemini API 免费档位指南以及如何免费使用 Gemini。
Gemini Decisions API 的计费方式是如何运作的?
你只需为输入 token 付费,且无论在单次请求中提出多少个问题,共享输入(shared input)在每次请求中都只计算一次。每个问题仅额外增加其自身的指令(instructions)和评估标准(criteria)token。输出始终为 0 token,因为模型返回的是概率值而非生成文本。

因此单次请求的计算公式非常简单:
input tokens = shared input + sum(each question's instructions + criteria)
paid cost = input tokens / 1,000,000 x $0.10
[待核实] 有趣的是这一机制对免费档位的影响:处理纯文本时,通常先触及请求次数上限(200 RPM、10,000 RPD);而处理图像、音频或长文档时,往往会先触及 50,000 TPM 的限制。
成本测算实例:免费档位 vs 付费档位
下文中的问题 token 数是估算值(每个简短问题约 30 tokens)。图像和音频的 token 数来自 Google 的媒体分辨率表,[待核实] 其中列出当前 Gemini 模型在 low 分辨率下每张图像计 280 tokens,在 high 分辨率下计 1,120 tokens,音频为每秒 25 tokens。建议运行一次真实请求,并用你实测的 usage 数值替换下面的示例数字。
[待核实] 10,000 张商品照片 x 16 个问题
假设你需要检查配送照片是否存在破损、摆放位置是否正确、标签是否清晰等共计 16 项内容。
low分辨率下每次请求:280(图像)+ 20(文本上下文)+ 16 x 30(问题)= 780 tokens- [待核实] 10,000 张照片:10,000 x 780 = 7.8M tokens
- [待核实] 付费档位成本:7.8 x $0.10 = $0.78
- [待核实]
high分辨率下:1,120 + 20 + 480 = 每张照片 1,620 tokens,共 16.2M tokens,付费成本 $1.62
[待核实] 在免费档位下,TPM 决定了你的处理速度:50,000 / 780 ≈ 每分钟 64 张照片。全部 10,000 张照片大约在 2 小时 36 分钟内处理完毕,并刚好用完一天的 10,000 次请求额度。若使用 high 分辨率,则约为每分钟 30 张,耗时 5.5 小时。
[待核实] 这里有一个务必避免的常见错误:如果你把这 16 项检查拆成 16 次独立请求发送,每次请求都会重复发送一遍图片:16 x 300 = 4,800 个图像及上下文 token,加上同样的 480 个问题 token,每张照片合计约 5,280 tokens。这相当于 52.8M tokens(付费成本 $5.28)以及 160,000 次请求——足足要消耗 16 天的免费档位配额。因此请务必将问题合并到同一次请求中批量发送。
[待核实] 10,000 张客服工单 x 3 个路由问题
- 每次请求:250(工单文本)+ 3 x 40(带标准的问题)= 370 tokens
- [待核实] 10,000 张工单:3.7M tokens,付费成本 $0.37
- [待核实] 免费档位:50,000 / 370 ≈ 每分钟 135 次请求,低于 200 RPM 上限。一天的 10,000 次免费请求刚好能处理完 10,000 张工单。
长篇 PDF 文档
模型的上下文窗口为 262,144 tokens,但免费档位的 TPM 仅为 50,000,因此一份 120,000 token 的合同就已经超过了整整一分钟的免费预算。[待核实] Google 文档没有说明免费档位如何处理单次请求超过 TPM 上限的情况,建议先拿单份文档实测。长文档场景正是 Tier 1 付费档位(1M TPM)发挥价值的地方。
以 $0 成本使用 Gemini Decision 1 的其他途径
| 途径 | 费用 | 是否需要绑卡或设置计费 | 适用场景 |
|---|---|---|---|
| [待核实] | Gemini API 免费档位(AI Studio 密钥) | $0,200 RPM / 50,000 TPM / 10,000 RPD | 否 |
| AI Studio 中的 Decisions Playground | $0(据 Google 发布公告属于免费层) | 否 | 在编写代码前调试问题措辞 |
| [待核实] | OpenRouter(google/gemini-decision-1) |
每百万输入 $0.10,输出 $0 | 是,需充值额度 |
[待核实] 2026 年 11 月 12 日核对 OpenRouter 模型页面显示,该模型由单一提供商(Google AI Studio)提供服务,价格为每百万输入 $0.10、输出免费,且没有 :free 变体。它运行在 OpenRouter 的 Decisions 端点上,因此常规的 Chat Completions SDK 无法直接调用。
如何保持在免费档位限额内运行
以下七个习惯能让你的原型项目尽可能长时间地保持 $0 成本:
- 在一次请求中问完所有问题。 共享输入只计费一次,且单次调用最多可容纳 1,000 个问题。
- 降低媒体分辨率。 每张图像在
low分辨率下的 token 消耗仅为high的四分之一。 - 只发送问题所需的字段。 Google 表示无关内容不仅会降低准确率,还会白白消耗 TPM。
- [待核实] 按 TPM 而非 RPM 进行限流。 将工作线程的速度控制在
50,000 / 实测单次请求 token 数。 - 自行缓存回答结果。 该 API 不支持上下文缓存,重复输入会全额计费,因此可以对“输入 + 问题”计算哈希并跳过重复项。
- 在太平洋时间午夜过后启动大批量任务,以便获得一整天的完整配额。
- [待核实] 不要让单元测试和 CI 直接调用真实 API。 如果每次代码推送都调用真实接口,可能还没到午饭时间就耗尽了 10,000 次每日请求。应当改用 Mock 服务。
让你的编码 Agent 使用 Apifox CLI 为 Decisions API 构建 Mock
单元测试并不需要调用真实的在线模型,只需要验证正确的数据结构:包含 answers 映射、介于 0.01 到 0.99 之间的 noul 值、confidence 置信度,以及 usage.total_output_tokens: 0。你的编码 Agent 可以使用 Apifox CLI 构建这套 Mock,从而只留一个冒烟测试去请求真实的 Google 接口。
只需完成一次初始化:
npm install -g apifox-cli@latest
apifox auth login --with-token <YOUR_TOKEN>
apifox skill install
然后向 Claude Code、Codex 或 Cursor 发送一条提示词:
In Apifox project <id>, add the Gemini Decisions endpoint POST /v1beta/decisions
with a request body of model, input and questions. Create mock expectations that
return a damaged answer (noul 0.97) and an undamaged one (noul 0.04), each with
usage.total_output_tokens = 0. Add a test case that asserts the answers map,
confidence between 0 and 1 and zero output tokens. Run it against the mock
environment, then once against the real API with my free-tier key.
Agent 会先读取各个 payload schema 并完成校验,然后才执行写入和运行:
apifox cli-schema get endpoint-create
apifox cli-schema validate endpoint-create --file decisions-endpoint.json
apifox endpoint create --project <id> --file decisions-endpoint.json
apifox cli-schema get mock-create
apifox cli-schema validate mock-create --file mock-damaged.json
apifox mock create --project <id> --file mock-damaged.json
apifox cli-schema get test-case-create
apifox test-case create --project <id> --file decisions-case.json
apifox run --test-case <caseId> --project <id> -e <mockEnvId> -r cli,json
apifox run --test-case <caseId> --project <id> -e <freeTierEnvId> -r cli
在 CI 流水线中,只需带上 -r junit 针对 Mock 环境运行即可(流水线配置文件可参考我们的 Apifox CLI CI/CD 指南);Agent 侧的配置详见 Claude Code 中的 Apifox CLI 指南。Apifox 免费版不限制成员数量和协作人数,团队可以零成本共享这些 Mock 配置。如果你同时也在评估 OpenAI 的同类接口,可以参考我们的 OpenAI Decisions API 解析。
常见问题
Gemini Decisions API 是免费的吗? 在限额范围内是免费的。免费档位不收取输入费用,且输出始终为 0 tokens。每个项目享有每分钟 200 次请求、每分钟 50,000 tokens 和每天 10,000 次请求的额度。超出后需设置计费账户,按[待核实] 每百万输入 tokens $0.10 付费。
使用 Gemini Decisions API 免费档位需要信用卡吗? 不需要。从 Google AI Studio 创建的 API 密钥默认处于免费档位。Google 的速率限制页面说明,只有当你在 AI Studio 中主动设置计费账户后,才会切换到付费档位。
Google 会使用我免费档位下的 Decisions API 数据进行训练吗? Google 的定价页面将免费档位的“用于改进我们的产品”标记为“是”,付费档位标记为“否”。因此切勿将免费档位密钥用于处理敏感数据。
[待核实] 为什么我的请求远低于每分钟 200 次,却还是触发了 429 错误? 你很可能超出了每分钟 50,000 tokens 的限制。图像、音频和 PDF 输入非常消耗 token,因此往往在达到 RPM 上限前就先触发了 TPM 限制。建议记录 usage.total_input_tokens,并将请求速率控制在 50,000 / 单次请求 token 数。
OpenRouter 上有免费的 Gemini Decision 1 模型吗? 截至 2026 年 11 月 12 日没有。OpenRouter 上列出的 google/gemini-decision-1 价格为[待核实] 每百万输入 tokens $0.10、输出 $0,没有提供 :free 变体。
我可以使用 Batch API 或上下文缓存来扩充免费额度吗? 不能。模型页面显示所有档位均不支持 Batch API 和上下文缓存。请将多个问题合并到单次请求中发送,并在业务代码里自行缓存回答结果。