截至 2026-11-11 的模型目录，Router One 以 google/gemini-4-carbon 列出 Gemini 4 Carbon。网关也接受 Google 官方 id gemini-4-carbon，指向同一个目录条目。国内开发者不需要 VPN：用 Router One 的 Key 向 https://api.router.one/v1/chat/completions 发 "model": "google/gemini-4-carbon"，或者把 OpenAI 兼容 SDK、客户端的 base URL 换成 https://api.router.one/v1，请求就会像目录里其他模型一样被路由、计费并记入日志。截至 2026-11-11 的套餐接口，Pro、Max、Ultra 都没有档位列出 Gemini 4 Carbon，所以无论是否订阅，每次调用都按 token 从钱包扣费，实时单价看 Gemini 4 Carbon 模型页。
本文依次讲清：目录对这个 id 列出了什么；Google 官方对这个模型的说明；费用怎么算；它和 Gemini 4 Argon 有什么不同；怎样用 curl 与 OpenAI SDK 发出第一个请求；哪些客户端能调用；以及国内怎么用。文中 Google 的每条说法都注明出处，均为 2026-11-11 核对；目录与套餐信息也都注明了日期，发起新请求前以实时目录为准。
Gemini 4 Carbon 速览
| 项目 | 目录所列（2026-11-11） |
|---|---|
| 目录 id | google/gemini-4-carbon |
| 短 id（别名） | gemini-4-carbon，即 Google 官方模型 id |
| 输入 / 输出 | 文本、图像输入，文本输出 |
| 能力标签 | chat、streaming、tool calling、vision |
| 端点 | POST /v1/chat/completions（OpenAI 兼容） |
| 不提供的端点 | 其他所有模型端点，包括 POST /v1/messages（只服务 Claude 系列与 DeepSeek id） |
| 套餐 | 不在 Pro、Max、Ultra 的任何套餐档位（2026-11-11 套餐接口）：每次调用都从钱包扣费 |
| 单价 | 按 token 计费，见模型页；本文不印具体数字 |
Google 官方怎么说明 Gemini 4 Carbon
据 Google 的 Gemini API 发布说明（2026-11-10 条目，2026-11-11 核对），Gemini 4 Carbon（Google 官方模型 id：gemini-4-carbon）已在 Gemini API 上正式发布（GA）。Google 的 Gemini 模型总览页（2026-11-11 核对）这样描述它："Our strongest reasoning model, built for complex software engineering, multimodal knowledge work, scientific reasoning, and cybersecurity defense."（Google 最强的推理模型，面向复杂软件工程、多模态知识工作、理工类推理与网络安全防御。）
Google 的 Gemini 4 Carbon 模型页（2026-11-11 核对）就 Google 自家的 Gemini API 列出以下信息：
- 状态。 Google 把这个模型列为稳定版；Google 的弃用说明页（2026-11-11 核对）给出的发布日期是 2026-11-10，尚未公布停用日期。
- Token 上限。 输入与输出共用 1,048,576 token 的上下文窗口，也就是 Google 在 Gemini 4 Carbon 新功能页（2026-11-11 核对）里说的统一 1M token 上下文窗口；默认最大输出 65,536 token。Google 的 long decode 功能运行在 Google 自家的 API 上，能让单次响应超过 65,536 token，最多用到窗口剩余的部分。
- 输入与输出。 按 Google 的说法，输入支持文本、图像、视频、音频与 PDF，输出为文本。Router One 的目录条目列出的是文本与图像输入，所以下面的示例只发这两种。
- 功能。 Google 把函数调用、结构化输出、代码执行、搜索 grounding、URL context 与隐式上下文缓存列为支持（不支持显式缓存），图像生成、音频生成与 Live API 列为不支持。
- 思考。 Google 列出
low、medium、high三个级别。Google 给出的默认级别和细节见下一节。
以上是 Google 对自家 Gemini API 的说法；Router One 负责的是目录条目本身，以及网关如何路由和计费。目录为这个 id 列出了 tool calling 能力标签，函数工具按标准的 Chat Completions tools 数组传。Google 的内置工具属于 Gemini API 的功能：在 Router One 的 Chat Completions 端点上，托管搜索工具只对 google/gemini-3-flash 生效，其他 id 的 tools 数组按原样转发（API 兼容性事实页）。迁移前先用自己的提示词测试代码会发送的工具定义。
思考级别与 reasoning_effort
按 Google 的 Gemini 4 Carbon 新功能页与思考指南（均为 2026-11-11 核对）：
- 级别。 Gemini 4 Carbon 的思考级别为
low、medium、high，默认是medium；Google 建议大多数任务用medium，并建议在三个级别上都跑一遍评测，再选能达到质量要求的最低级别。 - Token 用量。 按 Google 的说法，遇到难题时 Gemini 4 Carbon 每轮比 Gemini 4 Argon 花更多思考 token 去探索和验证，单轮 token 用量和延迟随之增加；想少用 token，Google 建议调低思考级别。
- 输出上限。 Google 的输出上限把思考 token 和回答一起算在内；模型还在思考时就触到上限，返回的内容会被截断，甚至为空；Google 建议显式设置的输出上限至少调到 32,768 token。
- 关不掉思考。 Google 的 OpenAI 兼容说明（2026-11-11 核对）把 Gemini 4 系列模型的
reasoning_effort中minimal与low对应到low思考级别、medium对应medium、high对应high，不传时用模型的默认级别，并说明 Gemini 4 系列模型不能关闭推理。
以上规则描述的是 Google 自家的 API。下面的示例都不设 reasoning_effort；如果你的代码会设，迁移前先用自己的提示词跑一遍。思考产生的输出按模型公示的输出单价计费，没有单独的推理价格行（定价事实页），所以思考 token 也会计入每次调用的钱包扣费。
费用怎么算
Gemini 4 Carbon 按 token 计费，单价以模型页公示的输入与输出单价为准。Router One 为每个模型单独公示单价，部分模型最低官方价 1 折；本文不印每 token 单价，因为它会过时。截至 2026-11-11 的套餐接口，Gemini 4 Carbon 不在 Pro、Max、Ultra 的任何套餐档位，所以无论是否订阅，每次调用都按公示单价从钱包扣费。
Google 的 Gemini API 另有自己的定价：按 Google 的定价页与 Gemini 4 Carbon 新功能页（均为 2026-11-11 核对），Gemini 4 Carbon 在 Gemini API 上的推广价持续到 2026-11-30，Google 的标准价从 2026-12-01 起生效，Google 的输出价包含思考 token，这个模型也不在 Google 的免费层。这些日期属于 Google 的价目表；Router One 对这个 id 收取的单价以模型页为准。
控制台 → 日志里每次调用都带模型、Token、钱包扣费或套餐扣减次数、延迟和状态（每请求可观测）。一个任务扣了多少钱包余额，可以按它发出的调用逐条加总，不必凭估算。
订阅套餐覆盖 Gemini 4 Carbon 吗？
不覆盖。截至 2026-11-11 的套餐接口，Router One 的 Pro、Max、Ultra 三个套餐都没有档位列出 Gemini 4 Carbon，所以订阅了套餐，它的调用也和不订阅时一样，按公示单价从钱包扣费。Gemini 4 Argon 是另一个目录条目：截至 2026-11-11 的套餐接口，它在 Pro、Max、Ultra 的「高级模型」档。套餐的模型列表会调整，各套餐额度与实时模型列表以价格页为准。
Gemini 4 Carbon 与 Gemini 4 Argon 的区别
Google 的 Gemini 模型总览页（2026-11-11 核对）这样描述 Gemini 4 Argon："Our efficient Gemini 4 frontier reasoning model, delivering faster responses and lower token spend per turn compared to Gemini 4 Carbon across complex coding, agentic, math, and science tasks."（Google 高效的 Gemini 4 前沿推理模型，在复杂编码、智能体、数学与理工类任务上，比 Gemini 4 Carbon 响应更快、每轮消耗的 token 更少。）按 Google 的 Gemini 4 Carbon 新功能页（2026-11-11 核对），在 Google 自家的 Gemini API 上，两个模型的上下文窗口、内置工具与每 token 单价相同，主要区别在于每轮花多少思考 token；Google 建议把 Gemini 4 Carbon 用在复杂的根因排查、架构设计、密集的多模态综合、数理证明与安全审计上，在更看重响应速度与每轮 token 消耗的场景保留 Gemini 4 Argon，并说明在其 API 上从 Argon 换到 Carbon 不需要改请求结构。
在 Router One 上，截至 2026-11-11 的模型目录两个 id 都在列，都只走 /v1/chat/completions，所以 Key、base URL 和端点都不变，请求层面只需把 model 从 google/gemini-4-argon 改成 google/gemini-4-carbon。套餐这一侧不同。截至 2026-11-11 的套餐接口，Gemini 4 Argon 在 Pro、Max、Ultra 的「高级模型」档，用套餐时调用扣这一档的额度。截至 2026-11-11 的套餐接口，Gemini 4 Carbon 不在任何套餐档位，无论是否订阅都按 token 从钱包扣费。切换前对比 Gemini 4 Argon 与 Gemini 4 Carbon 两个模型页的公示单价，并用自己的提示词把两个模型都跑一遍。
对比页 Gemini 4 Carbon vs Gemini 4 Argon 并排渲染两者的规格表与实时单价；Argon 的模型 id、端点与套餐覆盖见 Gemini 4 Argon API 接入指南。
发出第一个请求
- 创建 Key。 控制台 → API 密钥 → 创建密钥，Key 形如
sk-...。试用阶段给这把 Key 设一个maxSpend消费上限。每把 Key 的消费上限（maxSpend）限的是这把 Key 能从钱包扣的钱：累计扣费到上限后，这把 Key 上需要钱包付费的请求返回 HTTP 402。套餐额度覆盖的请求从账户共用的套餐额度里扣，不计入任何 Key 的上限。其他 Key 照常可用（按 Key 成本追踪）。 - 准备钱包余额。 2026-11-11 的套餐接口里没有档位列出 Gemini 4 Carbon，所以无论是否订阅，它的调用都从钱包扣费——充值在控制台 → 充值。
- 设置 base URL：在任意 OpenAI 兼容 SDK 或客户端里填
https://api.router.one/v1。 - 调用模型。 下面的示例都用目录 id
google/gemini-4-carbon，并显式设置max_tokens。
用 curl 调用 Chat Completions，开启流式：
curl https://api.router.one/v1/chat/completions \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "google/gemini-4-carbon",
"max_tokens": 32768,
"stream": true,
"messages": [
{"role": "system", "content": "你负责排查并发问题，先给出根因，再给出修复方案。"},
{"role": "user", "content": "请求超时后，两个 worker 会重试同一笔支付，部分客户因此被重复扣款。竞态出在哪里？重试怎样才安全？"}
]
}'
用 OpenAI Python SDK 发同样的请求（不开流式；pip install -U openai），只需要改 base_url 和 Key：
from openai import OpenAI
client = OpenAI(
base_url="https://api.router.one/v1",
api_key="sk-your-api-key",
)
response = client.chat.completions.create(
model="google/gemini-4-carbon",
max_tokens=32768,
messages=[
{"role": "system", "content": "你负责排查并发问题，先给出根因，再给出修复方案。"},
{"role": "user", "content": "请求超时后，两个 worker 会重试同一笔支付，部分客户因此被重复扣款。竞态出在哪里？重试怎样才安全？"},
],
)
print(response.choices[0].message.content)
print(response.choices[0].finish_reason, response.usage)
返回遵循 Chat Completions 的格式：正文在 choices[0].message.content，finish_reason 说明生成为什么停止，usage 给出输入与输出的 token 数。
用 Node 的 OpenAI SDK 流式输出（npm install openai）：
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.router.one/v1",
apiKey: "sk-your-api-key",
});
const stream = await client.chat.completions.create({
model: "google/gemini-4-carbon",
max_tokens: 32768,
stream: true,
messages: [
{
role: "user",
content:
"请求超时后，两个 worker 会重试同一笔支付，部分客户因此被重复扣款。请用三句话解释竞态出在哪里。",
},
],
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}
以 base64 data URL 内联发送图片（Python，沿用上面的 client）：
import base64
with open("architecture.png", "rb") as f:
image_b64 = base64.b64encode(f.read()).decode()
response = client.chat.completions.create(
model="google/gemini-4-carbon",
max_tokens=32768,
messages=[{
"role": "user",
"content": [
{"type": "text", "text": "把这张架构图里的单点故障按编号列出来。"},
{"type": "image_url", "image_url": {"url": f"data:image/png;base64,{image_b64}"}},
],
}],
)
print(response.choices[0].message.content)
每个请求都适用的几条规则：
- 每个请求都显式设置
max_tokens。 在你预期的最长回答之上留出余量，上面的示例设的是 32768，也就是 Google 建议为这个模型显式设置输出上限时的最低值（Gemini 4 Carbon 新功能页，2026-11-11 核对）。Router One 的 Chat Completions 也接受max_completion_tokens作为同一个上限（两者都传时以max_completion_tokens为准）。按 Google 的思考指南（2026-11-11 核对），思考 token 也计入输出上限，所以要多留余量。 - 不要传采样参数。 按 Google 新功能页上的迁移清单（2026-11-11 核对），去掉
temperature、top_p与top_k；在 Google 自家的 Gemini API 上，传了也会被忽略。语气与格式要求改写进 system 消息。 - 给长请求留足时间。 按同一页面（2026-11-11 核对），难题在 Google 自家的 API 上可能要跑好几分钟，所以 HTTP 客户端的超时要设得宽松，长回答用
stream: true流式返回（流式输出指南）。 - 保持充足的钱包余额。 请求执行前，网关会按预估额从余额中预留；余额不够时，网关会把
max_tokens调低到余额能覆盖的数值，长回答可能因此被截断。余额连这次请求的初始预留都覆盖不了时，网关会在模型运行前返回 HTTP 402。 - 图片直接内联。 图片以 base64 data URL 放进
image_url内容块发送，写法见上面的示例；Router One 不提供 Files API。 - 先测试代码依赖的东西。 把一类任务迁过去之前，先用你自己的提示词，把代码会发送的参数与请求形态（工具定义、图片输入、输出上限、思考设置）都测一遍。
- 看 Trace。 控制台 → 日志里每次调用都带模型、Token、钱包扣费或套餐扣减次数、延迟和状态（每请求可观测）。可重试的上游故障由同一模型多条候选线路之间的自动故障转移消化；Gemini 4 Carbon 的请求绝不会被换成别的模型来回答。
网关在调用任何模型之前就拒绝的请求，在控制台 → 日志里没有记录，原因看状态码和错误信息：401 说明 Key 没有通过校验；402 说明钱包余额或这把 Key 的 maxSpend 不够覆盖这次请求的初始预留；404 说明路径或模型 id 不存在，请照目录原样复制 id。其他状态码见错误码速查。
哪些客户端能调用
凡是支持 Chat Completions、能填自定义 base URL 的客户端，都能调用 Gemini 4 Carbon：官方 OpenAI SDK（OpenAI SDK 接入），以及集成目录里发送 /v1/chat/completions 请求的聊天应用与框架。给客户端填上 base URL https://api.router.one/v1 和 Router One 的 Key，model 写 google/gemini-4-carbon；这个端点的总体说明见 OpenAI 兼容 API。
Claude Code 调不了 Gemini 4 Carbon。Claude Code 向 /v1/messages 发送 Anthropic Messages 请求，这个端点只服务 Claude 系列与 DeepSeek id；目录里列出的其他对话模型 id 发过去，网关会在调用任何模型之前返回 HTTP 400。Gemini 4 Carbon 请从支持 Chat Completions 的客户端调用。各模型系列的端点规则见 API 兼容性事实页。
国内怎么用
中国大陆可直连 api.router.one，无需 VPN，Key 和 base URL 与海外完全一致。支付宝或银行卡在同一个托管收银台完成充值，也支持 6 条链上的 USDT/USDC（Tron、BSC、以太坊、Polygon、Base、Arbitrum），无需美国信用卡。Router One 列出的其他 Gemini 模型怎么接入，见 Gemini API 国内调用教程与 Gemini API 国内使用指南。
常见问题
国内能直接调用 Gemini 4 Carbon 吗？
能。中国大陆可直连 api.router.one，无需 VPN，Key 和 base URL 与海外完全一致。支付宝或银行卡在同一个托管收银台完成充值，也支持 6 条链上的 USDT/USDC（Tron、BSC、以太坊、Polygon、Base、Arbitrum），无需美国信用卡。
Router One 上 Gemini 4 Carbon 的模型 ID 是什么？ 截至 2026-11-11 的模型目录，目录 id 是 google/gemini-4-carbon，代码和客户端配置里都用它。网关也接受 Google 官方 id gemini-4-carbon，在 /v1/chat/completions 上指向同一个目录条目。截至 2026-11-11 的套餐接口，Pro、Max、Ultra 都没有档位列出它，所以它的调用按 token 从钱包扣费。
Gemini 4 Carbon API 价格是多少？ 在 Router One 上按 token 计费，单价以 Gemini 4 Carbon 模型页公示的输入与输出单价为准，部分模型最低官方价 1 折；本文不印具体数字，因为它会过时。截至 2026-11-11 的套餐接口，它不在任何套餐档位，每次调用都从钱包扣费。在 Google 自家的 Gemini API 上，按 Google 的定价页与新功能页（2026-11-11 核对），这个模型的推广价持续到 2026-11-30，Google 的标准价从 2026-12-01 起生效。
Gemini 4 Carbon 有免费额度吗？ Google 自家的 Gemini API 上没有：按 Google 的定价页（2026-11-11 核对），Gemini 4 Carbon 不在 Google 的免费层。在 Router One 上，Gemini 4 Carbon 的每次调用都按公示单价从钱包扣费；截至 2026-11-11 的套餐接口，它不在任何套餐档位。
调用 Gemini 4 Carbon 需要 Google 的 API Key 吗？
通过 Router One 不需要：一把 Router One 的 Key（sk-...）配 https://api.router.one/v1，就能调用 Gemini 4 Carbon 和目录里的其他模型，不用申请 Google 的 API Key，也不用开 Google Cloud 结算账号。
Gemini 4 Carbon 的上下文窗口多大？ 按 Google 的模型页与 Gemini 4 Carbon 新功能页（2026-11-11 核对），Gemini 4 Carbon 的输入、思考与输出共用 1,048,576 token 的上下文窗口，即 Google 所说的统一 1M token 上下文窗口；在 Google 自家的 Gemini API 上，默认最大输出 65,536 token。Router One 模型页显示这个 id 的实时目录条目。
Gemini 4 Carbon 支持哪些思考级别？ 按 Google 的说明（2026-11-11 核对），在 Google 自家的 Gemini API 上：low、medium、high，默认 medium；Gemini 4 系列模型不能关闭推理；按 Google 的 OpenAI 兼容说明，在 Google 的 OpenAI 兼容端点上用 reasoning_effort 设置思考级别。本文示例都不设 reasoning_effort；你的代码要设的话，先用自己的提示词测一遍。
选 Gemini 4 Carbon 还是 Gemini 4 Argon？ 按 Google 的 Gemini 模型总览页与新功能页（2026-11-11 核对），Gemini 4 Carbon 是 Google 最强的推理模型，每轮花的思考 token 更多；Gemini 4 Argon 是 Google 高效的 Gemini 4 前沿推理模型，响应更快、每轮消耗的 token 更少。在 Router One 上两者都走 /v1/chat/completions，切换只需改 model 字符串。截至 2026-11-11 的套餐接口，Gemini 4 Argon 在 Pro、Max、Ultra 的「高级模型」档。截至 2026-11-11 的套餐接口，Gemini 4 Carbon 不在任何套餐档位。
Gemini 4 Carbon 在 Router One 订阅套餐里吗？ 不在。截至 2026-11-11 的套餐接口，Pro、Max、Ultra 都没有档位列出它，无论是否订阅，调用都按公示单价从钱包扣费。Gemini 4 Argon 是另一个目录条目，截至 2026-11-11 的套餐接口，它在这三个套餐的「高级模型」档。各套餐额度见价格页。
能在 Claude Code 里用 Gemini 4 Carbon 吗？ 不能。Claude Code 向 /v1/messages 发送 Anthropic Messages 请求，这个端点只服务 Claude 系列与 DeepSeek id，所以 Gemini 4 Carbon 的请求发到那里，会在调用任何模型之前返回 HTTP 400。请从支持 Chat Completions 的客户端调用 Gemini 4 Carbon。
下一步
- 打开 Gemini 4 Carbon 模型页，查看实时单价和端点。
- 在 Gemini 4 Carbon vs Gemini 4 Argon 对比页把它和 Gemini 4 Argon 放在一起看，并阅读 Gemini 4 Argon API 接入指南。
- 各套餐的额度与各档列出的模型，见价格页。
- 在国内调用其他 Gemini 模型，见 Gemini API 国内调用教程与 Gemini API 国内使用指南。
- 第一次用 OpenAI 兼容端点？OpenAI 兼容 API 讲清 base URL、Key 与 SDK。
- Gemini 3.8 Flash 的接入，见 Gemini 3.8 Flash API 接入指南。