GPT Image 2.5 is live — OpenAI's newest image model, targeted edits that leave the rest of the frame alone
全部教程与指南

· reAPI Team

Gemini 4 Carbon 怎么用：访问方式、请求与限制

了解在哪里使用 Gemini 4 Carbon、如何编写原生 generateContent 请求，以及需要预留的输出额度。reAPI 不托管该模型。

Gemini 4 Carbon 怎么用：访问方式、请求与限制

Gemini 4 Carbon 于 2026 年 11 月 10 日向付费开发者开放，距 Google 首次向网络安全防御人员发布该模型已有两周。其请求模型 ID 为 gemini-4-carbon，接受文本、图片、视频、音频和 PDF 输入，返回文本。[1][2] 许多写于 10 月下旬的指南仍称该模型尚未开放，因此复制内容前请先核对日期。

本指南介绍目前如何使用 Gemini 4 Carbon：在哪里运行、如何按原生 Gemini 格式编写首个请求，以及从旧版 Gemini 模型迁移时容易忽略的输出限制。reAPI 不提供该模型的推理服务。 reAPI 的 Gemini 4 Carbon 概览 提供请求编辑器，实际服务由 SeedRouter 提供。

前往 SeedRouter 的 Gemini 4 Carbon 页面。 在该页面确认你的账户是否拥有访问权限及当前费率。以下请求体是根据 Google 和 SeedRouter 的文档编写的模板，并非为本指南进行的真实调用记录。[3]

快速了解

  • 开发者需通过 Gemini API 的付费层级使用 Gemini 4 Carbon；免费层级不提供该模型。Google AI Ultra 订阅用户也可在 Gemini 应用、Google Antigravity 和搜索中的 AI Mode 使用它。[1][4]
  • 从 Gemini 4 Argon 迁移只需修改模型 ID，但 Carbon 每轮会消耗更多思考 token，因此输出预算和客户端超时时间都要留有余量。[5]
  • thinkingLevel 是主要控制项：可选 low、medium（默认）或 high。Temperature、top-p 和 top-k 会被忽略。[5]
  • 非流式 REST 调用每跳最多返回 32,768 个输出 token。未携带续传 token 却请求更多输出，会返回 400 错误。[6]
  • 在 SeedRouter 上，Gemini 4 Carbon 使用原生 Gemini 格式，通过 generateContent 和 streamGenerateContent 调用。[3]

目前在哪里可以使用 Gemini 4 Carbon

Google 在 11 月 10 日的公告中列出了几种独立的使用路径。这些产品和账户各不相同，因此 Gemini 应用的 Ultra 订阅不等于 API 密钥，付费 API 密钥也不能解锁面向消费者的应用。[1]

使用路径适用人群所需条件
Gemini API（Google AI Studio、Android Studio）开发者Gemini API 付费层级
Gemini for business、Antigravity、CodeMender企业企业账户
Gemini Enterprise Agent PlatformGoogle Cloud 项目Cloud 项目；使用全球端点或 us / eu 多区域[7]
Gemini 应用、搜索中的 AI Mode、Antigravity消费者和个人开发者Google AI Ultra 订阅
Antigravity 科研访问科学家和研究人员申请获批（六个月，滚动开放接入）
Fairwind Program网络安全防御人员申请获批，用于独立的 Carbon for cyber 模型
SeedRouter使用第三方服务的开发者SeedRouter 账户和密钥[3]

能否免费使用是最常见的问题；对于 API，答案是不可以。Google 的定价页将免费层级下 Gemini 4 Carbon 的每一项都标为“不可用”。[4] 面向消费者的使用路径要求 Ultra 订阅，普通付费套餐不适用。

这项任务该选 Carbon 还是 Argon

Google 将 Argon 定位为大多数软件工程和知识工作的合适选择。Carbon 面向更考验模型推理能力的任务，例如跨大型代码库的多步骤调试或开放式研究；它会比 Argon 使用更多 token 来探索和验证自己的工作。[1] Google 的迁移说明也给出了相同的实际建议：如果希望响应更快、每轮 token 消耗更低，就继续使用 Argon。[5]

两个模型采用相同的请求 schema，因此可以将难题交给 gemini-4-carbon，日常流量继续使用 gemini-4-argon，无需维护两套客户端。Google 还为 Carbon 提供了与 Argon 相同的首发优惠 token 单价。[1] 由于 Carbon 思考时间更长，即使 token 单价相同，同一提示词在 Carbon 上仍可能花费更多。思考 token 按输出计费。[4]

Google 为 Gemini API 公布的价格为：截至 2026 年 11 月 30 日，每百万输入 token $2、每百万输出 token $10；自 12 月 1 日起，分别为 $4 和 $20。[4] 优惠期内，缓存输入为每百万 token $0.10，之后为 $0.20。这些是 Google 自有 API 的费率。其他服务自行定价，因此在 SeedRouter 上实际需要支付多少，应查看其模型页。

准备首个 Gemini 4 Carbon 请求

选择能够检查答案的任务，例如一个存在已知缺陷的简短函数。一开始就提供整个代码仓库，会更难分辨问题来自访问权限、请求构造还是提示词不够明确。

在原生 Gemini 格式中，模型写在 URL 路径里，而非请求体中；contents 是唯一必填字段。[3] 以下是 POST /v1beta/models/gemini-4-carbon:generateContent 的请求体：

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "This retry loop re-reads an account balance before taking the lock. Explain the race condition and propose a fix with one test."
        }
      ]
    }
  ],
  "generationConfig": {
    "thinkingConfig": { "thinkingLevel": "medium" },
    "maxOutputTokens": 32768
  }
}

32768 的预算遵循 Google 的建议：显式设置该字段时，至少设为 32,768，因为 Carbon 可能将大部分额度用于思考。[5] 这也是单次非流式 REST 调用的上限，下一节会具体说明。

SeedRouter 文档在其主机 api.seedrouter.ai 上使用相同路径，并在 Authorization 请求头中携带 bearer token。Google 自己的 REST 示例则使用 x-goog-api-key 请求头。[3][6] 密钥应与签发它的服务保持对应。Google 密钥无法在 SeedRouter 通过认证，SeedRouter 密钥也不能用于 Google 的主机。

不要发送 Gemini 4 Carbon 会忽略或拒绝的设置。Google 表示，即使发送 temperature、topP 和 topK，这些字段也会被忽略，且不支持显式上下文缓存。至少包含 4,096 个 token 的提示词会自动使用隐式缓存，因此应将代码库或长文档等大型静态材料放在提示词开头。[5] 如果客户端仍在发送旧模型使用的 thinkingBudget，请替换为 thinkingLevel；Google 的 Agent Platform 指南指出，在该平台的 Gemini 4 模型上，thinking_budget 和 MINIMAL 会返回 HTTP 400。[7]

流式调用、输出上限与续传

Gemini 4 Carbon 的统一窗口为 1,048,576 个 token，由输入、思考和输出共享。单次同步调用会在远低于这一额度时停止。[2] Google 的长解码指南规定了每跳的上限：[6]

调用类型每跳输出 token 数超过上限时
generateContent，非流式 REST32,768maxOutputTokens 超过 32,768 且未携带 continuationToken 时返回 400
streamGenerateContent65,536使用返回的 token 续传
跨多跳长解码最多 1,048,576 减去输入 token 数需要续传

续传逐跳进行。当某一跳达到上限且仍有剩余预算时，响应会以 finishReason: "CONTINUATION" 和一个 continuationToken 结束。在完全相同的请求中加入该 token 后再次发送，不要将已生成的部分回答追加到 contents，因为 token 已经携带模型状态。只要结束原因仍为 CONTINUATION，就继续续传。[6]

某一跳可能返回空文本。面对难题，模型可能将整跳都用于思考；Google 将带有续传 token 的空 text 视为正常进展，而非失败。[6]

也要为较慢的响应做好准备。Google 建议将长解码的 HTTP 读取超时设为 20 分钟；SeedRouter 则提醒，非流式请求运行超过约 100 秒后，可能在答案返回前以 HTTP 524 结束。对于长任务，SeedRouter 建议使用 streamGenerateContent?alt=sse。[3][6] 连接断开不能证明生成失败，因此重新发送相同请求前，应先检查已收到的部分结果。

选择思考强度

thinkingLevel 用于在质量、延迟和 token 用量之间取舍。[5]

强度token 用量Google 建议的用途
lowtoken 最少，延迟最低较简单且对成本敏感的工作；难题上的质量可能下降
medium（默认）均衡大多数任务，包括复杂代码和智能体任务
hightoken 最多，首个 token 返回最慢高难度数学与科学问题、最复杂的代码任务；配合长解码使用

Google 建议自行评估三个档位，并选择能够达到质量要求的最低档位。[5] 在 Argon 上有效的档位可以作为起点，但不能直接作为结论，因为 Carbon 消耗 token 的方式不同。

扩大任务前先检查响应

不要只看回答文本。原生响应包含 candidates[].content.parts、finishReason 和 usageMetadata；SeedRouter 文档还将 continuationToken、safetyRatings 和 promptFeedback 列为值得检查的字段。[3]

  • finishReason: "MAX_TOKENS" 表示输出预算耗尽。Google 表示，可以携带返回的 token 并提高 maxOutputTokens 后重发，也可以从头开始，但这样需要支付两次运行的费用。[6]
  • thoughtsTokenCount 显示按输出计费的思考 token 数。即使可见回答很短，背后也可能消耗了大量思考 token。[4][6]
  • REST 每次返回单跳用量。计算费用时应跨跳累加相应字段，提示词大小则只取第一跳的数值。[6]
  • SeedRouter 的流式用量是累计值，因此应读取最新计数，不要将每个数据块的用量相加。[3]

构建对话历史时，应保留完整的内容部分，包括 thoughtSignature。[3] 对于代码修复，采纳补丁前应运行测试，因为 200 响应只能说明服务接受了请求。

Google 发布时公布了哪些结果

Google 在 10 月 28 日的公告中称，Gemini 4 Carbon 以 59 分位列 Artificial Analysis Intelligence Index v5.0 第一。Google 公布的成绩包括 SEC-bench Pro 的 88.2%、ExploitGym 的 54.8% 和 CWE-bench 的 71.0%，所有评估均未启用防护措施。[8] 这些结果由厂商报告。将生产流量交给模型前，请先用自己的任务进行测试。

常见问题

Gemini 4 Carbon 免费吗？

在 Gemini API 上不免费。Google 定价页列明免费层级不提供该模型，而在 Gemini 应用中使用需要 Google AI Ultra 订阅。[1][4] 研究人员可以申请六个月的免费 Antigravity 访问权限，是否获批取决于遴选结果。

Gemini 4 Carbon 现在可以用了吗？

可以。自 2026 年 11 月 10 日起，付费 Gemini API 开发者、Gemini for business 用户和 Google AI Ultra 订阅用户均可使用。此前仅向 Fairwind Program 中的防御人员开放。[1]

Gemini 4 Carbon 怎么收费？

在 Google 的 API 上，截至 2026 年 11 月 30 日，每百万输入 token $2、每百万输出 token $10，之后分别为 $4 和 $20。[4] 思考 token 计入输出。SeedRouter 在其模型页公布自己的费率。

Gemini 4 Carbon 的上下文窗口有多大？

1,048,576 个 token，由输入、思考和输出共享。默认同步输出上限为 65,536 个 token，非流式 REST 调用则为 32,768 个；长解码可以生成更多。[2][6]

可以从 Gemini 4 Argon 切换到 Carbon 吗？

可以。Google 表示，升级无需更改请求 schema，只需修改模型 ID。输出预算和超时时间应为更长的思考过程留出余量。[5]

可以在 reAPI 上使用 Gemini 4 Carbon 吗？

不可以。reAPI 不提供该模型的推理、计费或密钥。概览页 帮助你准备请求，实际运行则在 SeedRouter 上进行。

顺利完成首次 Gemini 4 Carbon 调用

从小任务开始，在 URL 中使用 gemini-4-carbon，明确设置 thinkingLevel 和 maxOutputTokens；任务可能耗时较长时，使用流式调用。扩大提示词前，先检查结束原因和 token 数。准备就绪后，打开 SeedRouter 上的 Gemini 4 Carbon，确认账户权限。

参考资料

  1. Google。Gemini 4 Carbon is now available. 2026 年 11 月 10 日发布，2026 年 11 月 11 日查阅：blog.google/innovation-and-ai/models-and-research/gemini-models/gemini-4-carbon-now-available。
  2. Google AI for Developers。Gemini 4 Carbon model page. 2026 年 11 月 11 日查阅：ai.google.dev/gemini-api/docs/models/gemini-4-carbon。
  3. SeedRouter。Gemini 4 Carbon API documentation. 2026 年 11 月 11 日查阅：seedrouter.ai/docs/gemini-4-carbon。模型页：seedrouter.ai/models/gemini-4-carbon。本指南未测试真实模型执行。
  4. Google AI for Developers。Gemini Developer API pricing: Gemini 4 Carbon. 2026 年 11 月 11 日查阅：ai.google.dev/gemini-api/docs/pricing。
  5. Google AI for Developers。What's new in Gemini 4 Carbon. 2026 年 11 月 11 日查阅：ai.google.dev/gemini-api/docs/whats-new-gemini-4-carbon。
  6. Google AI for Developers。Long decode (generateContent). 2026 年 11 月 11 日查阅：ai.google.dev/gemini-api/docs/long-decode。
  7. Google Cloud。Get started with Gemini 4. Gemini Enterprise Agent Platform 文档，2026 年 11 月 11 日查阅：docs.cloud.google.com/gemini-enterprise-agent-platform/models/start/get-started-with-gemini-4。
  8. Google。Gemini 4 Carbon: our next frontier model. 2026 年 10 月 28 日发布，2026 年 11 月 11 日查阅：blog.google/innovation-and-ai/models-and-research/gemini-models/introducing-gemini-4-carbon。
全部教程与指南