Google 的稳定模型 ID 是 gemini-4-carbon。Gemini API 文档提供 Interactions API 调用示例;模型支持文本、图像、视频、音频和 PDF 输入,输出文本,输入与输出共用 1,048,576-token 上下文。
适合的任务:按 Google Gemini API 文档配置模型 ID、输入类型、思考档位及输出上限。
不适合的任务:不能据此判断某个账户、地区或第三方客户端是否已获准使用该模型。
适用的模型版本:Gemini 4 Carbon 稳定版,gemini-4-carbon。
适用的客户端、Agent 或 API:Gemini API;官方快速示例使用 Interactions API。
推荐的推理档位和参数:默认 thinking_level 为 medium,可选 low、medium、high。默认同步输出上限为 65,536。需要更长输出时,可提高 max_output_tokens 并使用后台执行或前台续接。
以下为 Google 官方 REST 快速示例,保留原请求结构和示例输入:
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": "Write a three.js script that renders a realistic 3D black hole with gravitational lensing."
}'将请求的 model 设为 gemini-4-carbon。
默认可不传思考配置;需要指定时,Google 示例使用 generation_config.thinking_level,取值为 low、medium 或 high。
max_output_tokens 限制思考与最终输出的合计 token 数。采用后台长输出时,设 background: true 并将上限提高到 65,536 以上。服务端以多个最多 64K token 的续接段生成,需合并 interaction.steps 中的 model_output 文本。
多轮对话可通过 previous_interaction_id 保留服务端会话状态。
模型 ID 与版本:模型页列出 Model code gemini-4-carbon,Stable 版本同为 gemini-4-carbon。
模态:输入支持 Text、Image、Video、Audio、PDF;输出为 Text。
Token 限制:统一输入和输出上下文为 1,048,576 tokens;默认同步最大输出 65,536;使用 long decode 时最多 1,048,576,且受输入 token 占用约束。
能力:支持 agentic video understanding、code execution、computer use、context caching、file search、function calling、Google Maps/Search grounding、structured outputs、thinking 和 URL context;不支持 audio generation、image generation、Live API。
缓存限制:显式缓存不支持。Google 的迁移说明要求移除 cachedContents / caches.create 和请求中的 cached_content。
采样参数:temperature、top_p、top_k 不适用于该模型,若传入会被忽略。
推理及长输出参数:默认思考档位 medium;thinking_level 支持 low、medium、high。max_output_tokens 统计思考和输出总量;长输出推荐通过 background: true 执行。Google 文档建议复杂推理或代码任务从 131,072 或 262,144 起步,最大值受统一上下文窗口和输入长度限制。
调用方式:官方快速示例使用 POST https://generativelanguage.googleapis.com/v1beta/interactions,请求字段包含 model 和 input。
消费选项:Batch API、Flex inference、Priority inference 均标记为支持。
访问与价格:官方 API 说明称 Carbon 可用于 Gemini API 付费层,不在免费层提供。页面标示的引入价格有效至 2026-11-30:输入每百万 tokens $2、输出(含思考 tokens)每百万 $10;之后标示为 $4 / $20。价格可能变化,应以当前官方定价页为准。
补充官方 API 说明:What's new in Gemini 4 Carbon 展示了上述思考、长输出、缓存和迁移参数;不作为另一款模型或第三方实现的证据。
规格来自 Google 文档页面,不代表独立性能测试。
账号资格、可用地区、配额、当前价格和 API 行为可能变化;本文记录采集日可见内容。
文档建议长时间任务使用后台执行,或将 HTTP 客户端超时设为至少 15 分钟。
采集日期 2026-11-16。通过 Tabbit 打开用户给出的 ai.google.dev 模型页;该地址跳转至 Google AI Studio 的规范文档 URL。读取模型规格页及其官方 Carbon API 说明页的正文和 REST 代码示例。未进行 API 请求或性能测试。
Gemini 4 Carbon