Gemini 4 Carbon API 上线：价格、调用示例与 Gemini 4 Argon 对比

• 发布日期：2026 年 11 月 11 日
• 最后核对：2026 年 11 月 11 日
• 当前状态：有效；可在 default 分组调用

​

关键信息

​

价格

• Google 公布的首发价到 2026 年 11 月 30 日为止，12 月 1 日起改为输入 $4、输出 $20。老张API按 Google 官方价计费，届时同步调整，并在网站公告提前说明；Gemini 4 Argon 同日同幅调整。
• 思考 token 按输出单价计费。例如一次请求输入 46 tokens、正式回答 7 tokens、思考 188 tokens，按 195 个输出 token 计费，约 $0.002。
• 缓存读取是 Google 的隐式缓存：同一段 4,096 tokens 以上的前缀被重复发送时，命中部分自动按缓存价计费，不需要额外参数。
• 每次请求的 token 用量和扣费可在调用日志查看，当前单价以模型与价格总表为准。

​

和 Gemini 4 Argon 怎么选

• 两个模型单价、上下文窗口和内置工具相同，调用方式也相同，切换只需改 model。
• Google 说明 Carbon 每轮会用更多思考 token，所以同一个请求在 Carbon 上通常输出 token 更多、总花费更高、耗时更长。
• 复杂编程、调试、数学和科学推理等难题先试 gemini-4-carbon；Argon 已经能做好的任务，或调用量大、对成本敏感的任务，继续用 gemini-4-argon。上线前用自己的样例比较两者的效果、耗时和调用日志里的 token 用量。

​

调用示例

export LAOZHANG_API_KEY="替换为你的老张API密钥"

curl https://api.laozhang.ai/v1/chat/completions \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-4-carbon",
    "reasoning_effort": "high",
    "messages": [
      {"role": "user", "content": "用三句话解释什么是数据库索引，以及它为什么会让写入变慢。"}
    ]
  }'

curl "https://api.laozhang.ai/v1beta/models/gemini-4-carbon:generateContent" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"role": "user", "parts": [{"text": "用三句话解释什么是数据库索引，以及它为什么会让写入变慢。"}]}
    ],
    "generationConfig": {
      "thinkingConfig": {"thinkingLevel": "high"}
    }
  }'

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["LAOZHANG_API_KEY"],
    base_url="https://api.laozhang.ai/v1",
    timeout=600.0,
    max_retries=0,
)
response = client.chat.completions.create(
    model="gemini-4-carbon",
    reasoning_effort="high",
    messages=[{"role": "user", "content": "用三句话解释什么是数据库索引，以及它为什么会让写入变慢。"}],
)
print(response.choices[0].message.content)
print(response.usage)

• OpenAI 兼容接口的回答在 choices[0].message.content，思考 token 数在 usage.completion_tokens_details.reasoning_tokens。
• Gemini 原生接口的回答在 candidates[0].content.parts[].text，思考 token 数在 usageMetadata.thoughtsTokenCount，modelVersion 为 gemini-4-carbon。
• 已经在用 Gemini 4 Argon 的代码，把 model 或 URL 里的 gemini-4-argon 换成 gemini-4-carbon 即可，API Key 和其他参数不用改。
• 图片、流式、多轮对话等原生写法见 Gemini 协议，工具调用写法见函数调用。

​

思考级别

• 不传时按 Google 默认的 medium。
• Gemini 原生接口传 minimal 会报错，最低用 low。
• 级别越高，思考 token 越多，费用和耗时也越高。简单问答用 low，难题再用 high。
• Google 说明 Gemini 4 Carbon 会忽略 temperature、top_p、top_k，传了不报错，但不改变输出。

​

影响范围

• 适用：需要处理复杂编程、调试、数学与科学推理或多步智能体任务，并通过老张API调用 Gemini 的项目。default 分组、计费模式为按量优先或按量计费的 API Key 即可调用。
• 不受影响：本次上线没有调整已有模型。gemini-4-argon、gemini-3.8-flash 等 Gemini 模型继续可用，现有集成不需要修改。

​

常见问题

​

Gemini 4 Carbon 的模型 ID 是什么？

​

需要 Google 账号或付费的 Gemini API 吗？

​

12 月 1 日以后价格会变吗？

​

Gemini 4 Carbon 和 Gemini 4 Argon 哪个更划算？

​

支持图片、PDF 或音视频输入吗？

​

长请求超时怎么办？

• OpenAI 兼容接口：请求中加 "stream": true。
• Gemini 原生接口：改用 streamGenerateContent?alt=sse。

​

来源与相关链接

• Google：Gemini 4 Carbon 模型页：模型 ID、上下文窗口、输出上限、输入类型、思考级别和支持的工具。
• Google：Gemini API 价格：首发价、12 月 1 日起的价格和隐式缓存价格。
• Google：Gemini API 更新日志：2026 年 11 月 10 日正式发布。
• 模型与价格总表：老张API当前单价。
• Gemini 4 Argon 上线公告
• 文本生成 API：协议选择与常用模型
• Gemini 协议：generateContent
• 老张API最新公告