Gemini 4 Carbon 正式开放 API：调用入口、模型 ID 与首发价格窗口一览（5 步接入）

作者注：本文梳理 Gemini 4 Carbon 的官方 API 入口、模型标识、调用方式和首发价格时间窗口，帮助开发者在 11 月 30 日优惠截止前完成接入评估。

接入前需要知道的 7 个术语

Google 于 2026 年 11 月 10 日发布《Gemini 4 Carbon is now available》，宣布 Gemini 4 Carbon 正式向 Gemini API 付费开发者开放。在此之前，这款模型自 10 月 28 日首次公布后，只面向经过筛选的部分网络安全防御者开放。

这不是又一篇模型发布新闻的复述。本文只聚焦开发者真正关心的四件事：Gemini 4 Carbon 的调用入口在哪里、模型 ID 怎么填、代码怎么写，以及首发价格窗口什么时候结束。

核心价值：读完本文，你可以在 5 个步骤内完成 Gemini 4 Carbon 的 API 接入，并清楚区分 API 付费权限、消费者订阅权限和真实任务成本这三件事。

Gemini 4 Carbon 正式开放：开发者现在可以直接调用

Gemini 4 Carbon 由 Google DeepMind 开发，基于 Gemini 4 Argon 构建，定位是面向高难度推理、复杂软件工程、长周期 Agent 工作流、科学研究和网络安全防御的旗舰推理模型。它的特点是能够消耗更多思考 Token，对复杂任务进行假设探索、规划、执行、验证和修复。

11 月 10 日的正式开放覆盖了多条渠道。开发者可以通过 Gemini API 付费层、Google AI Studio 和 Android Studio 使用；企业可以通过 Gemini for business 获得权限；消费者需要 Google AI Ultra 订阅，才能在 Gemini App、Google Antigravity 和 Google Search AI Mode 中使用。对普通开发者来说，最重要的变化是：只要开通付费 API，就可以直接调用 Carbon。

Gemini 4 Carbon 接入核心要点

Gemini 4 Carbon 与 Argon 的分工

需要注意，Carbon 并不是用来全面替代 Argon 的。Google 明确表示，Gemini 4 Argon 仍然是大多数软件工程和知识工作任务的理想选择；Carbon 更适合需要更深入推理、更长时间执行和更复杂验证的任务。

因此在接入规划上，比较合理的做法是把 Carbon 放在架构设计、复杂代码审计、跨子系统根因排查等“难任务”上，而常规代码生成和批量处理继续交给更快、更轻量的模型。这也是 Google 在 Antigravity 的 /swarm 多 Agent 预览功能中推荐的分工方式。

Gemini 4 Carbon API 调用入口在哪里

Gemini 4 Carbon 的官方接入路径集中在 Google AI Studio。整个流程可以拆成 5 步，每一步都对应一个明确的页面或配置项：

1. 进入 Google AI Studio：使用 Google 账号登录 AI Studio。
2. 创建 API Key：打开 API Keys 页面，新建一个用于 Carbon 调用的 Key。
3. 开通付费层级：设置 Google Cloud Billing，配置支付方式。Carbon 没有免费 API 层，这一步不能跳过。
4. 选择 Gemini 4 Carbon：在 Playground 中直接选择 gemini-4-carbon 试用，或在 SDK 中填写该模型 ID。
5. 开始调用：使用 Python SDK、JavaScript SDK 或 REST API 发起请求。

Gemini 4 Carbon 的 API 权限与订阅权限

很多开发者在 Hacker News 和 Reddit 上的讨论，都把“能不能在 Gemini App 里用 Carbon”和“能不能通过 API 调用 Carbon”混在一起。实际上这是两条完全独立的路径，下表把各渠道的条件拆开说明。

一句话总结：开发者调用 Carbon 不需要购买 Ultra，消费者在 App 里用 Carbon 才需要 Ultra。另外，Google AI 订阅附带的 Google Cloud Developer Credits（例如 AI Pro 每月 $10）属于 Cloud 开发者计划权益，不能等同于 Carbon 专属的免费 Token 额度，具体抵扣资格要按服务、地区和账户条件确认。

如何通过 API 调用 Gemini 4 Carbon：快速上手

官方推荐：Interactions API 极简示例（Python）

Google 当前推荐新项目优先使用 Interactions API，它可以统一处理模型调用、工具编排、多轮交互和 Agent 工作流，传统的 GenerateContent API 仍然受支持。下面是依据官方 Interactions 示例整理排版后的 Python 代码，原始补充资料中的版本被粘贴成了一行，无法直接执行。

from google import genai

client = genai.Client()
interaction = client.interactions.create(
    model="gemini-4-carbon",
    input="Write a Three.js script that renders a 3D scene."
)
print(interaction.output_text)

运行前先执行 pip install google-genai，并把 AI Studio 中创建的 Key 设置为环境变量 GEMINI_API_KEY，genai.Client() 会自动读取。需要说明的是，本示例仅修复了排版，我们没有对这次模型调用做实际运行验证，请以官方文档的最新写法为准。

REST API 调用示例

如果你的项目不方便引入 SDK，可以直接请求官方 REST 端点 https://generativelanguage.googleapis.com/v1beta/interactions,通过 x-goog-api-key 请求头传入 API Key:

curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "model": "gemini-4-carbon",
    "input": "Hello"
  }'

JavaScript 项目使用 @google/genai 包，调用方法同样是 client.interactions.create()，模型 ID 和输入字段的含义与 Python 一致。

设置 Gemini 4 Carbon 的思考档位 thinking_level

Carbon 提供 thinking_level 参数，可选值为 low、medium、high，公开模型 gemini-4-carbon 默认是 MEDIUM。参数在请求体中的具体字段位置，请以官方 “What’s new in Gemini 4 Carbon” 文档为准。三个档位的典型用途如下：

• low：分类、摘要、元数据提取等轻量任务；
• medium：常规代码、工具调用、文档问答、视频理解；
• high：多文件软件工程、架构设计、形式化证明、漏洞发现。

迁移旧代码时要特别注意：thinking_budget 在 Carbon 上不受支持，传入会返回 HTTP 400；MINIMAL 推理档位同样不可用。

通过 OpenAI 兼容接口调用（以平台上线情况为准）

如果你的项目已经基于 OpenAI SDK 搭建，并且希望用一个 Key 同时管理多家模型，也可以使用 OpenAI 兼容的聚合接口。下面的示例仅展示写法，gemini-4-carbon 是否可用、实际模型名称是什么，请以平台模型列表为准：

import openai

client = openai.OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1"  # API易 OpenAI 兼容接口
)

response = client.chat.completions.create(
    model="gemini-4-carbon",  # 示例名称,以平台模型列表为准
    messages=[{"role": "user", "content": "用三句话解释什么是长周期 Agent。"}]
)
print(response.choices[0].message.content)

import openai
from typing import Optional, List

def call_model(
    prompt: str,
    models: List[str],
    system_prompt: Optional[str] = None,
    max_tokens: int = 4096
) -> str:
    """
    按顺序尝试多个模型,第一个成功即返回。
    适合在新模型上线初期做平滑回退。
    """
    client = openai.OpenAI(
        api_key="YOUR_API_KEY",
        base_url="https://api.apiyi.com/v1"
    )

    messages = []
    if system_prompt:
        messages.append({"role": "system", "content": system_prompt})
    messages.append({"role": "user", "content": prompt})

    last_error = None
    for model in models:
        try:
            response = client.chat.completions.create(
                model=model,
                messages=messages,
                max_tokens=max_tokens
            )
            return f"[{model}] " + response.choices[0].message.content
        except Exception as e:
            last_error = e
            continue
    return f"Error: {last_error}"

# 使用示例:模型名称以平台模型列表为准
result = call_model(
    prompt="审查这段架构设计中的单点故障风险。",
    models=["gemini-4-carbon", "gemini-4-argon"],
    system_prompt="你是一名资深后端架构师,回答要具体、可执行。"
)
print(result)

🚀 快速上手建议：如果你需要在 Carbon、Argon 以及其他厂商模型之间做横向对比，可以通过 API易 apiyi.com 用同一个 Key 和统一的 OpenAI 兼容接口完成切换，新用户有免费测试额度。Gemini 4 Carbon 的具体上线时间和模型名称，请以平台控制台公布的信息为准。

Gemini 4 Carbon API 支持哪些能力

根据 Google AI Studio 的 Carbon 模型文档和官方模型卡，Carbon 是一个“多模态输入、文本输出”的推理模型，同时具备完整的 Agent 开发工具链。下表汇总了接入时最常用的规格参数。

Gemini 4 Carbon 的参数兼容性限制

Carbon 对部分常用采样参数的处理与旧模型不同，迁移代码时容易踩坑。根据 Google Cloud 开发者指南：temperature、top_p、top_k 会被忽略；frequency_penalty、presence_penalty 不受支持；candidate_count 大于 1 会返回错误。

缓存方面，Carbon 不支持显式 Context Caching，但支持自动隐式缓存。当请求之间共享的提示词前缀达到 4096 Token 及以上时，就有机会触发缓存。实践中，建议把系统提示词、工具声明、固定参考文档放在请求最前面并保持不变，把每次变化的用户输入放在末尾，以提高缓存命中率。

Gemini 4 Carbon 首发价格窗口与 12 月 1 日价格变化

Gemini 4 Carbon 的价格有两个必须记住的时间节点：2026 年 11 月 30 日前为首发价格，2026 年 12 月 1 日起输入和输出价格均上涨一倍。以下价格均来自 Google AI Studio 官方 API 定价页面，单位为美元 / 每百万 Token，为 Google 官方服务口径。

从表中可以看到，缓存输入价格相当于普通输入价格的 95% 折扣。Batch 和 Flex 的单价是 Standard 的一半，适合对实时性要求不高的离线任务；Priority 价格更高，适合对延迟和稳定性更敏感的生产场景。

Gemini 4 Carbon 的实际账单怎么算

单价只是起点，Carbon 的实际费用还受三个因素影响：

• 思考 Token 计入输出费用：模型在 medium 或 high 档位下产生的推理过程按输出单价计费，账单不能只按用户看到的最终回答长度估算。
• Grounding 会带来额外开销：使用 Grounding 时，内部工具系统指令和函数声明也会计入计费。Google Search Grounding 每月有 5,000 次免费请求额度，与 Gemini 3 及更新模型共享，超出后每 1,000 次收费 14 美元，一次用户请求可能触发多次搜索。
• 缓存命中率：隐式缓存命中的输入部分按缓存价格计费，结构良好的提示词能明显降低长上下文成本。

举一个假设性的估算：某次请求输入 20,000 Token，思考加最终输出共 8,000 Token，不考虑缓存和工具调用。按首发 Standard 价格计算约为 0.02 × $2 + 0.008 × $10 = $0.12；12 月 1 日后同样用量约为 $0.24。思考 Token 越多，输出侧费用占比就越高。

第三方数据也印证了这一点。Artificial Analysis 按 $4 / $20 标准价格测算，Carbon 在其 Intelligence Index v5.0.1 中每个评测任务的平均成本为：Low 约 $7.19、Medium 约 $6.59、High 约 $7.76。Medium 的任务成本反而低于 Low，说明档位与成本并非线性关系，这些数字是综合评测任务的平均值，不代表单次普通请求的价格。

💰 成本建议：正式上线前，建议先用小批量真实任务分别测试 low、medium、high 三个档位，记录思考 Token 和输出 Token 的比例，再决定默认档位。如果项目同时使用多家模型，也可以借助 API易 apiyi.com 的统一计费面板对比不同模型的实际消耗。

接入 Gemini 4 Carbon 前需要注意什么

在正式写进生产代码之前，下面几条边界条件值得逐一核对：

1. 没有免费 API 层:AI Studio Playground 可以选择 Carbon 试用，但 Carbon 本身不提供免费 API 层，调用需要付费账户。
2. Ultra 订阅不是 API 前提：开发者无需购买 Google AI Ultra；反过来，Ultra 订阅也不能替代 API 账单。
3. 响应延迟偏高：模型卡提示高推理档位可能出现较慢响应和超时。Artificial Analysis 测得 Carbon High 首个回答 Token 时间约 67.54 秒，不适合直接替代实时聊天模型。
4. 仍可能出现幻觉:Google 承认 Carbon 仍可能产生幻觉，Prompt Injection 防护也仍需改进，关键业务要保留校验环节。
5. 网络安全专项能力有门槛：官方公布的漏洞发现成绩反映的是通过 Fairwind Program 使用时的专项能力，不能等同于普通 API 的无条件开放能力。
6. 价格快照有时效：本文价格与权限信息基于 2026 年 11 月 11 日的资料，后续请以官方页面为准。

常见问题 FAQ

Gemini 4 Carbon 核心要点 Key Takeaways

• 正式开放:2026 年 11 月 10 日起，Gemini API 付费开发者可直接调用 Carbon。
• 模型 ID：稳定 ID 为 gemini-4-carbon，官方推荐用 Interactions API 接入。
• 调用入口:Google AI Studio 创建 Key，绑定 Cloud Billing 后即可使用。
• 价格窗口:11 月 30 日前 $2 / $10,12 月 1 日起 $4 / $20（每百万 Token）。
• 权限区分:API 调用不需要 Ultra，App 内使用 Carbon 才需要 Ultra 订阅。
• 成本关键：思考 Token 计入输出，实际账单取决于档位、工具调用和缓存。
• 多模型对比：可借助 API易 apiyi.com 统一接口测试，Carbon 上线情况以平台公布为准。

总结

Gemini 4 Carbon 正式开放 API 的核心要点：

1. 入口明确:Google AI Studio → API Keys → Cloud Billing → 选择 gemini-4-carbon → 发起调用，5 步即可完成接入。
2. 接口优先级：新项目优先使用 Interactions API，GenerateContent 仍受支持，迁移时注意 thinking_budget 等参数已不可用。
3. 价格节点:11 月 30 日前是首发价格窗口，12 月 1 日起全线翻倍，评估预算时要把思考 Token 算进输出成本。

如果你计划在首发窗口内完成评估，建议先用 medium 档位跑一批真实任务，记录 Token 结构后再决定生产配置。需要在多家模型之间横向对比时，推荐通过 API易 apiyi.com 统一接入测试，Gemini 4 Carbon 是否可用请以平台模型列表为准。

📚 参考资料

1. Gemini 4 Carbon 正式开放公告:Google 官方博客
2. 链接： blog.google/innovation-and-ai/models-and-research/gemini-models/gemini-4-carbon-now-available

3. 说明： 正式开放时间、各渠道权限与价格变化

4. Gemini 4 Carbon API 模型文档:Google AI Studio

5. 链接： aistudio.google.com/docs/models/gemini-4-carbon

6. 说明： 模型 ID、输入输出模态、上下文与工具能力

7. What’s new in Gemini 4 Carbon:Google AI Studio 接入指南

8. 链接： aistudio.google.com/docs/whats-new-gemini-4-carbon

9. 说明： Interactions API 示例与 thinking_level 参数

10. Gemini API 定价:Google AI for Developers

11. 链接： ai.google.dev/gemini-api/docs/pricing

12. 说明： Standard、Batch、Flex、Priority 与缓存价格

13. Gemini 4 Carbon 开发者指南:Google Cloud

14. 链接： docs.cloud.google.cn/gemini-enterprise-agent-platform/models/guides/gemini-4-carbon

15. 说明： 参数限制、Long Decode 与隐式缓存规则

16. Gemini 4 Carbon 模型卡:Google DeepMind

17. 链接： deepmind.google/models/model-cards/gemini-4-carbon

18. 说明： 技术参数、知识截止日期与已知限制

19. Gemini 4 Carbon 独立模型分析:Artificial Analysis

20. 链接： artificialanalysis.ai/models/gemini-4-carbon
21. 说明： 不同思考档位的任务成本与延迟数据

作者:APIYI 技术团队
技术交流：欢迎在 API易官网首页联系我们，更多接入资料可访问 docs.apiyi.com 文档中心