guides

Gemini 4 Carbon API:Gemini 4 Carbon 是什么、模型 ID、限制与价格

Poyo.ai Team
5 min read
Share:

PoYo 上的 Gemini 4 Carbon API:模型 ID、接口、限制与价格

Gemini 4 Carbon API 已在 PoYo 上线,模型 ID 为 gemini-4-carbon。用一个 PoYo 密钥即可通过兼容 OpenAI 的 Chat Completions 接口或 Google 原生 generateContent 格式调用,价格为每 1M 输入 token $1.60、每 1M 输出 token $8.00。写代码之前,可以先在 Gemini 4 Carbon 模型页上试用。

本文介绍 Google 对该模型的定位、设计时必须考虑的限制、PoYo 与 Google 的价格,以及哪些请求值得交给 Carbon 而不是 Gemini 4 Argon。

Gemini 4 Carbon 是什么?

Google 于 2026 年 10 月 28 日发布 Gemini 4 Carbon,称其为“我们最强的模型,具备业界领先的网络安全与长周期任务能力”。它建立在两周前发布的 Gemini 4 Argon 之上,Google 表示它“为持续运行的智能体工作流而打造”:在大型代码库中定位根因并修复 bug、多智能体编码、迁移、高密度知识工作以及科学推理。

开放分两步进行:

日期事件
2026 年 10 月 28 日Google 发布 Gemini 4 Carbon;首先通过 Fairwind Program 向部分网络安全防御方开放
2026 年 11 月 10 日向 Gemini API 付费层(AI Studio)的所有付费开发者以及 Gemini for business 开放
2026 年 11 月 16 日可在 PoYo 上以 gemini-4-carbon 调用

Google 指出,部分网络安全能力仍有门槛:开发者需申请 Fairwind Program,“以滚动方式获得 Carbon 的网络安全用途访问权限”。规划防御性安全功能时请考虑这一点。

Gemini 4 Carbon API 速览

项目值
PoYo 模型 IDgemini-4-carbon
Google 模型代码gemini-4-carbon(单一稳定版本,未列出别名)
上下文窗口1,048,576 token,输入与输出共享
最大输出默认 65,536 token(Google 仅在“long decode”下列出最高 1M)
输入类型文本、图像、音频、视频、PDF
输出类型文本
知识截止2026 年 3 月
Google 免费层无
PoYo 支持的格式Chat Completions 和 Gemini Native(不支持 Responses 或 Anthropic Messages)

Google 模型页把 1M 列为输入与输出合计的统一上限,因此 1,000,000 token 的提示几乎不给回答留空间。PoYo 文档没有说明 long-decode 开关,所以在 PoYo 上请按每次响应 64K 输出来规划。

接口与鉴权

两种格式都向 https://api.poyo.ai 发送请求,并使用 Authorization: Bearer $POYO_API_KEY。响应保持各格式的原生结构,不带 PoYo 媒体任务使用的 code / data 包装。

格式接口流式输出最大输出字段
OpenAI Chat CompletionsPOST https://api.poyo.ai/v1/chat/completions"stream": true(SSE)max_tokens
Gemini NativePOST https://api.poyo.ai/v1beta/models/gemini-4-carbon:generateContent:streamGenerateContent(SSE)generationConfig.maxOutputTokens

如果已经在用 OpenAI SDK,就用 Chat Completions(把 base_url 设为 https://api.poyo.ai/v1)。如果需要用 inlineData part 传图像等文件,就用 Gemini Native:PoYo 的 Chat Completions schema 把 content 定义为纯字符串。把该模型发到不支持的格式(例如 /v1/responses)会返回 HTTP 400,并列出支持的 URI。请求结构见 Gemini Native 文档。

Google 还为该模型列出了函数调用、结构化输出、思考等级和 Google 搜索 grounding。PoYo 为这两个接口公布的 schema 只说明了 messages、contents / parts、采样字段、generationConfig 和 safetySettings,依赖其他功能之前请先查阅文档。

Gemini 4 Carbon API 价格:PoYo 与 Google 对比

PoYo 按 token 以积分计费(1 积分 = $0.005):

计费项(每 1M token)PoYo 价格PoYo 积分Google,截至 2026 年 11 月 30 日Google,2026 年 12 月 1 日起
输入$1.60320$2.00$4.00
输出(含思考 token)$8.001,600$10.00$20.00
缓存读取$0.0816$0.10$0.20

PoYo 的价格比 Google 的推广期输入和输出价格低 20%。Google 价格页说明思考 token 计入输出价格,且 Carbon 只支持隐式上下文缓存。上表 Google 价格为标准层。Google 另有批处理价格,不属于 PoYo 这个接口的范围。PoYo 价格以 2026 年 11 月 16 日的标价为准;最新价格以模型页为准。

一次 200K token 的代码仓库审查、回答 8K token,在 PoYo 上的费用是 0.2 × $1.60 + 0.008 × $8.00 = $0.384(76.8 积分)。完整计算示例见 Gemini 4 Carbon API 价格。

哪些请求该交给 Gemini 4 Carbon API

这里基准测试只作为路由依据。根据 Google 公布的表格:

工作负载基准测试CarbonArgon交给 Carbon?
基于终端的智能体编码Terminal-Bench 4.0 (AA)65.2%57.1%是,适合长的多步骤任务
长周期智能体编码SWE-sweep9.6%4.3%是
256K–1M token 范围内的检索GraphWalks (BFS F1)96.2%84.2%是,提示非常大时
跨工具的业务自动化AutomationBench (Zapier)53.9%51.3%差距小;两者都测
漏洞发现SEC-bench Pro88.2%83.4%是,前提是有 Fairwind 权限
针对弱点的补丁质量CWE-bench71.0%68.0%是

同一张表中,GPT-6 Astra 在 FrontierSWE 2 上领先(65.5% 对 61.2%),Claude Opus 5.5 在 OSWorld-2.1 上领先(87.2% 对 81.5%)。三方对比见 Gemini 4 Carbon API vs Claude Opus 5.5 vs GPT-6 Astra。

Carbon 与 Argon:一条路由规则

无论在 PoYo 还是 Google,Carbon 和 Argon 的输入、输出价格都相同。区别在于每个任务消耗的 token:Google 称 Carbon 的做法是“比 Argon 使用更多 token 来充分探索、深入推理并运行更长的验证循环”,并表示“Argon 仍是大多数软件工程和知识工作的理想选择”。因此,日常编码和文档工作交给 gemini-4-argon,最难的调试、迁移、百万 token 检索和安全工作交给 gemini-4-carbon。两者请求结构相同,切换只需改模型 ID。详情见 Gemini 4 Carbon API vs Gemini 4 Argon 和 Gemini 4 Argon API 指南。

Gemini 4 Carbon API 快速上手

curl https://api.poyo.ai/v1/chat/completions \
  -H "Authorization: Bearer $POYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-4-carbon",
    "messages": [
      {"role": "system", "content": "You are a senior engineer. Answer with a numbered plan."},
      {"role": "user", "content": "Plan a migration of a Flask service from SQLAlchemy 1.4 to 2.0."}
    ],
    "max_tokens": 8192
  }'

回答在 choices[0].message.content 中,token 计数在 usage 中。通过 OpenAI SDK 发送同样的请求、流式输出、图像输入和原生格式,见 Gemini 4 Carbon API 指南。智能体循环和长上下文编码,见 Gemini 4 Carbon API 用于编码智能体。

常见问题

Gemini 4 Carbon API 的模型 ID 是什么?

使用 gemini-4-carbon。调用 /v1/chat/completions 时放在 "model" 中,调用 /v1beta/models/gemini-4-carbon:generateContent 时放在 URL 路径中。

Gemini 4 Carbon API 多少钱?

在 PoYo 上:每 1M token 输入 $1.60、输出 $8.00、缓存读取 $0.08(320 / 1,600 / 16 积分)。Google 截至 2026 年 11 月 30 日收费 $2.00 / $10.00 / $0.10,2026 年 12 月 1 日起为 $4.00 / $20.00 / $0.20。

Gemini 4 Carbon API 兼容 OpenAI SDK 吗?

兼容。设置 base_url="https://api.poyo.ai/v1",使用你的 PoYo 密钥,并在 chat.completions.create 中设置 model="gemini-4-carbon"。

Gemini 4 Carbon 的上下文窗口和最大输出是多少?

1,048,576 token,输入与输出共享,默认输出 65,536 token。输入可以是文本、图像、音频、视频和 PDF;输出为文本。

Gemini 4 Carbon API 有免费层吗?

Google 价格页说明 Gemini 4 Carbon 不提供免费层。PoYo 采用积分按量付费。

该用 Gemini 4 Carbon API 还是 Gemini 4 Argon API?

每 token 价格相同;Carbon 每个任务消耗更多 token。Google 推荐大多数软件工程和知识工作使用 Argon,最难的长周期、长上下文和安全任务使用 Carbon。

Share: