如何免费使用 Gemini Decisions API

详解 Google Gemini Decisions API(gemini-decision-1)免费档位:涵盖 200 RPM [待核实] / 50K TPM [待核实] / 10K RPD [待核实] 限额规则、零输出计费 [待核实]算术测算与 Apifox CLI Mock 测试。

用 Apifox,节省研发团队的每一分钟

如何免费使用 Gemini Decisions API

免费使用 Apifox

相关推荐

最新文章

API

一体化协作平台

API 设计

API 文档

API 调试

自动化测试

API Mock

API Hub

立即体验 Apifox
目录

如何免费使用 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 编程的实际用法、开发工作流,还有各种新工具和新玩法。

AI Coding 交流群二维码

Gemini Decisions API 免费档位包含什么?

Gemini Decisions API 免费档位是 Google Gemini Developer API 针对 gemini-decision-1 模型提供的零成本使用层级。它为每个 Google Cloud 项目提供免费的输入处理、零输出费用,以及[待核实] 固定的 200 RPM、50,000 TPM 和 10,000 RPD 速率限制,且无需设置计费方式。

Gemini Decisions API 免费档位概览

以下是 Google 的定价页面与速率限制页面的直观对比:

项目 免费档位(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 免费档位限额仪表图:每项目每分钟 200 次请求、每分钟 50,000 tokens、每天 10,000 次请求,于太平洋时间午夜重置

如何获取免费的 Gemini Decisions API 密钥

大约五分钟内即可开始发起免费调用:

  1. 登录 Google AI Studio 并点击 Create API key。新建项目默认处于免费档位。
  2. 安装 3.2 或更高版本的 SDK:pip install -U google-genai 或 npm install @google/genai@latest。
  3. 将密钥导出为 GEMINI_API_KEY 环境变量,以便 SDK 自动读取。
  4. 带上 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,因为模型返回的是概率值而非生成文本。

Gemini Decisions API 请求计费示意图:一次共享输入只计费一次并分发给五个问题,每个问题仅叠加各自的指令 token,账单显示输入 token 乘以每百万 $0.10 且输出 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. 在一次请求中问完所有问题。 共享输入只计费一次,且单次调用最多可容纳 1,000 个问题。
  2. 降低媒体分辨率。 每张图像在 low 分辨率下的 token 消耗仅为 high 的四分之一。
  3. 只发送问题所需的字段。 Google 表示无关内容不仅会降低准确率,还会白白消耗 TPM。
  4. [待核实] 按 TPM 而非 RPM 进行限流。 将工作线程的速度控制在 50,000 / 实测单次请求 token 数。
  5. 自行缓存回答结果。 该 API 不支持上下文缓存,重复输入会全额计费,因此可以对“输入 + 问题”计算哈希并跳过重复项。
  6. 在太平洋时间午夜过后启动大批量任务,以便获得一整天的完整配额。
  7. [待核实] 不要让单元测试和 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 和上下文缓存。请将多个问题合并到单次请求中发送,并在业务代码里自行缓存回答结果。