> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Gemini 4 Carbon（gemini-4-carbon）API 接入说明：老张API当前价与 Google 12 月 1 日起的官方价、OpenAI 兼容与 Gemini 原生调用示例、思考级别用法，以及和 Gemini 4 Argon 在价格与思考 token 上的区别。

Gemini 4 Carbon（`gemini-4-carbon`）是 Google 2026 年 11 月 10 日正式发布的 Gemini 模型，主打复杂编程、调试和科学推理。老张API从 11 月 11 日起提供，用 `default` 分组的 API Key 即可调用，每 1M tokens 输入 \$2、输出 \$10，与 Google 官方价和 Gemini 4 Argon 相同。

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

## 关键信息

| 项目 | 内容 |
| - | - |
| 模型 ID | `gemini-4-carbon` |
| Google 发布日期 | 2026 年 11 月 10 日（正式版） |
| 老张API上线 | 2026 年 11 月 11 日 |
| OpenAI 兼容端点 | `POST https://api.laozhang.ai/v1/chat/completions` |
| Gemini 原生端点 | `https://api.laozhang.ai/v1beta/models/gemini-4-carbon:generateContent` |
| 令牌分组与计费 | `default` 分组，按量计费（按 tokens） |
| 当前价格 | 每 1M tokens 输入 \$2、输出 \$10、缓存读取 \$0.1 |
| 上下文窗口（Google） | 1,048,576 tokens |
| 单次输出上限（Google） | 默认 65,536 tokens |
| 思考级别 | `low`、`medium`、`high`，Google 默认 `medium` |
| 可用能力 | 函数调用、结构化输出（JSON Schema）、图片输入、流式输出 |

## 价格

以下为 2026 年 11 月 11 日公开价格配置中的单价，单位为美元每 1M tokens：

| 计价项 | 老张API当前价 | Google 官方价（至 11 月 30 日） | Google 官方价（12 月 1 日起） |
| - | -: | -: | -: |
| 输入 | \$2 | \$2 | \$4 |
| 输出（含思考 token） | \$10 | \$10 | \$20 |
| 缓存读取 | \$0.1 | \$0.1 | \$0.2 |

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

## 和 Gemini 4 Argon 怎么选

| 对比项 | `gemini-4-carbon` | `gemini-4-argon` |
| - | - | - |
| Google 发布 | 2026 年 11 月 10 日 | 2026 年 9 月 30 日 |
| 每 1M tokens 单价 | 输入 \$2、输出 \$10 | 输入 \$2、输出 \$10 |
| 上下文窗口 | 1,048,576 tokens | 1,048,576 tokens |
| 思考级别 | `low`、`medium`、`high` | `low`、`medium`、`high` |
| 每轮思考 token | 更多（Google 说明） | 较少 |

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

## 调用示例

在[令牌管理](https://api2.laozhang.ai/token)创建 API Key：令牌分组选 `default`，计费模式选择按量优先（推荐）或按量计费。然后在终端设置环境变量：

```bash theme={null}
export LAOZHANG_API_KEY="替换为你的老张API密钥"
```

> [tab] OpenAI 兼容
>
> ```bash theme={null}
> 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": "用三句话解释什么是数据库索引，以及它为什么会让写入变慢。"}
>     ]
>   }'
> ```

> [tab] Gemini 原生
>
> ```bash theme={null}
> 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"}
>     }
>   }'
> ```

> [tab] Python
>
> ```python theme={null}
> 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 协议](https://docs.laozhang.ai/api-reference/gemini.md)，工具调用写法见[函数调用](https://docs.laozhang.ai/api-capabilities/function-calling.md)。

## 思考级别

| 接口 | 参数 | 可用值 |
| - | - | - |
| Gemini 原生 | `generationConfig.thinkingConfig.thinkingLevel` | `low`、`medium`、`high` |
| OpenAI 兼容 | `reasoning_effort` | `low`、`medium`、`high` |

* 不传时按 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 是什么？

`gemini-4-carbon`。Google 只发布了这一个正式版 ID，没有 `-preview` 或带日期的版本。OpenAI 兼容接口写在 `model` 字段，Gemini 原生接口写在 URL 路径里。

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

不需要。Google 官方 API 只向付费层级开放 Gemini 4 Carbon，免费层不能调用。在老张API上用老张API的 API Key 和 Base URL `https://api.laozhang.ai` 即可调用，余额预付、按 token 计费。

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

会。Google 的首发价到 11 月 30 日为止，12 月 1 日起官方价改为每 1M tokens 输入 \$4、输出 \$20、缓存读取 \$0.2。老张API届时同步调整，并在[网站公告](https://docs.laozhang.ai/changelog.md)说明，实际扣费以[调用日志](https://api2.laozhang.ai/log)为准。

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

单价相同，但 Carbon 每轮的思考 token 更多，同一个请求通常比 Argon 贵、也更慢。难题用 Carbon 换更好的结果，常规任务用 Argon 更省。两个模型的区别见上方「和 Gemini 4 Argon 怎么选」。

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

支持图片输入：OpenAI 兼容接口用 `image_url`（URL 或 Base64），Gemini 原生接口用 `inlineData` 或 `fileData`。Google 列出的输入类型还包括视频、音频和 PDF，写法见[图片理解 API](https://docs.laozhang.ai/api-capabilities/vision-understanding.md)和 [Gemini 协议](https://docs.laozhang.ai/api-reference/gemini.md)。模型只输出文字，不生成图片或语音。

### 长请求超时怎么办？

思考级别为 `high` 时，一次请求可能需要一分钟以上。客户端超时设到 600 秒左右，并改用流式输出：

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

## 来源与相关链接

* [Google：Gemini 4 Carbon 模型页](https://ai.google.dev/gemini-api/docs/models/gemini-4-carbon)：模型 ID、上下文窗口、输出上限、输入类型、思考级别和支持的工具。
* [Google：Gemini API 价格](https://ai.google.dev/gemini-api/docs/pricing)：首发价、12 月 1 日起的价格和隐式缓存价格。
* [Google：Gemini API 更新日志](https://ai.google.dev/gemini-api/docs/changelog)：2026 年 11 月 10 日正式发布。
* [模型与价格总表](https://docs.laozhang.ai/models.md#vendor-google-text)：老张API当前单价。
* [Gemini 4 Argon 上线公告](https://docs.laozhang.ai/announcements/gemini-4-argon-2026-10.md)
* [文本生成 API：协议选择与常用模型](https://docs.laozhang.ai/api-capabilities/text-generation.md)
* [Gemini 协议：generateContent](https://docs.laozhang.ai/api-reference/gemini.md)
* [老张API最新公告](https://docs.laozhang.ai/changelog.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.