> ## 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 Neon API 上线：价格、调用示例与 Gemini 4 Carbon 对比

> Gemini 4 Neon（gemini-4-neon）API 接入说明：每 1M tokens 输入 $3、输出 $15，与 Google 官方价相同；OpenAI 兼容与 Gemini 原生调用示例、thinkingLevel 思考级别，以及 12 月 1 日 Carbon 调价前后 Neon、Carbon、Hydrogen 怎么选。

Gemini 4 Neon（`gemini-4-neon`）2026 年 11 月 22 日在老张API上线，每 1M tokens 输入 \$3、输出 \$15，与 Google 官方价相同。用 `default` 分组的 API Key，走 OpenAI 兼容接口或 Gemini 原生接口都能调用。

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

## 关键信息

| 项目 | 内容 |
| - | - |
| 模型 ID | `gemini-4-neon` |
| Google 发布日期 | 2026 年 11 月 18 日（正式版） |
| 老张API上线 | 2026 年 11 月 22 日 |
| OpenAI 兼容端点 | `POST https://api.laozhang.ai/v1/chat/completions` |
| Gemini 原生端点 | `https://api.laozhang.ai/v1beta/models/gemini-4-neon:generateContent` |
| 令牌分组与计费 | `default` 分组，按量计费（按 tokens） |
| 价格 | 每 1M tokens 输入 \$3、输出 \$15（含思考 token），与 Google 官方价相同 |
| 上下文窗口（Google） | 1,048,576 tokens，输入和输出共用 |
| 单次输出上限（Google） | 默认 65,536 tokens |
| 思考级别 | `low`、`medium`、`high`（默认）、`xhigh` |
| 可用能力 | 函数调用、结构化输出（JSON Schema）、图片输入、流式输出、多轮对话与系统指令 |

## 价格

单位为美元每 1M tokens，2026 年 11 月 22 日核对：

| 计价项 | 老张API | Google 官方价 |
| - | -: | -: |
| 输入 | \$3 | \$3 |
| 输出（含思考 token） | \$15 | \$15 |

* 价格不分档：整个 1M 上下文都按同一单价，没有长上下文加价。Google 也没有宣布 Neon 的调价日期。
* 思考 token 按输出单价计费。Neon 每次都会先思考，简单问题也一样，所以输出 token 通常比正式回答长。
* 两个扣费例子：
  * 简单问答：输入 46 tokens，输出 179 tokens（其中思考 176 个），扣费约 \$0.0028。
  * 一道推理题：输入 67 tokens，输出 2,136 tokens（其中思考 1,407 个），扣费约 \$0.032。
* 每次请求的 token 用量和扣费可在[调用日志](https://api2.laozhang.ai/log)查看，当前单价以[模型与价格总表](https://docs.laozhang.ai/models.md#vendor-google-text)为准。

## Gemini 4 Neon、Carbon、Hydrogen 怎么选

下表价格均为 Google 官方价（美元每 1M tokens，输入 / 输出），评测分数来自 Artificial Analysis 的 Intelligence Index：

| 对比项 | `gemini-4-neon` | `gemini-4-carbon` | `gemini-4-hydrogen` |
| - | - | - | - |
| 到 11 月 30 日 | \$3 / \$15 | \$2 / \$10 | \$1.5 / \$7.5 |
| 12 月 1 日起 | \$3 / \$15 | \$4 / \$20 | \$1.5 / \$7.5 |
| 默认思考级别 | `high` | `medium` | `high` |
| 最高思考级别 | `xhigh` | `high` | `xhigh` |
| Intelligence Index | `high` 59.6，`medium` 54.9 | `high` 60.0 | `xhigh` 53.9 |

* **12 月 1 日前后，Neon 和 Carbon 的单价高低对调**：11 月 30 日前 Carbon 更便宜；12 月 1 日 Carbon 调到 \$4 / \$20 后，Neon 的 \$3 / \$15 比它低四分之一。
* **效果接近 Carbon、速度更快时选 Neon**：两者在 `high` 级别的分数只差 0.4。按 Artificial Analysis 的数据，Neon 默认级别完成每个任务的耗时约为 Carbon 默认级别的一半。
* **单价优先时选 Hydrogen**：Hydrogen 单价是 Neon 的一半。Neon 在 `medium` 级别的分数已略高于 Hydrogen 的最高级别 `xhigh`，需要更强效果再换 Neon。
* 三个模型调用方式相同，切换只需改 `model`。上线前用自己的样例比较效果、耗时和[调用日志](https://api2.laozhang.ai/log)里的 token 用量；老张API上 Carbon 和 Hydrogen 的当前单价见[模型与价格总表](https://docs.laozhang.ai/models.md#vendor-google-text)。

## 调用示例

在[令牌管理](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" \
>   --max-time 600 \
>   -d '{
>     "model": "gemini-4-neon",
>     "messages": [
>       {"role": "user", "content": "一个班有 23 人，至少两人同一天生日的概率是多少？给出计算过程和结果。"}
>     ]
>   }'
> ```

> [tab] Gemini 原生
>
> ```bash theme={null}
> curl "https://api.laozhang.ai/v1beta/models/gemini-4-neon:generateContent" \
>   -H "Authorization: Bearer $LAOZHANG_API_KEY" \
>   -H "Content-Type: application/json" \
>   --max-time 600 \
>   -d '{
>     "contents": [
>       {"role": "user", "parts": [{"text": "一个班有 23 人，至少两人同一天生日的概率是多少？给出计算过程和结果。"}]}
>     ],
>     "generationConfig": {
>       "thinkingConfig": {"thinkingLevel": "low"}
>     }
>   }'
> ```

> [tab] Python
>
> ```python theme={null}
> # pip install openai
> 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,
> )
> response = client.chat.completions.create(
>     model="gemini-4-neon",
>     messages=[{"role": "user", "content": "一个班有 23 人，至少两人同一天生日的概率是多少？给出计算过程和结果。"}],
> )
> print(response.choices[0].message.content)
> print("思考 tokens:", response.usage.completion_tokens_details.reasoning_tokens)
> print("输出 tokens:", response.usage.completion_tokens)
> ```

* OpenAI 兼容接口的回答在 `choices[0].message.content`，思考 token 数在 `usage.completion_tokens_details.reasoning_tokens`。
* Gemini 原生接口的回答在 `candidates[0].content.parts[].text`，思考 token 数在 `usageMetadata.thoughtsTokenCount`，`modelVersion` 为 `gemini-4-neon`。
* 原生示例用 `thinkingLevel` 设成 `low`，适合这类短题；去掉 `thinkingConfig` 就按默认的 `high` 思考。
* 工具调用写法见[函数调用](https://docs.laozhang.ai/api-capabilities/function-calling.md)，图片输入见[图片理解 API](https://docs.laozhang.ai/api-capabilities/vision-understanding.md)，原生接口的流式、多轮对话和 `systemInstruction` 写法见 [Gemini 协议](https://docs.laozhang.ai/api-reference/gemini.md)。

## 思考级别

| 接口 | 参数 | 效果 |
| - | - | - |
| Gemini 原生 | `generationConfig.thinkingConfig.thinkingLevel` | 四个级别都生效 |
| OpenAI 兼容 | `reasoning_effort` | 目前不会明显改变思考量 |

* 不传时按 Google 默认的 `high`。可选 `low`、`medium`、`high`、`xhigh`。
* 最低级别是 `low`，传 `minimal` 会按 `low` 处理。
* 级别对用量和耗时影响很大。同一道数学题，`low` 约 860 个思考 token、约 16 秒；`xhigh` 约 6,300 个思考 token、约 70 秒。
* OpenAI 兼容接口传 `reasoning_effort` 时，从 `low` 到 `xhigh` 的思考 token 都在 1.2k–1.6k 左右。要控制思考级别，请用 Gemini 原生接口。
* Google 说明 Neon 会忽略合法范围内的 `temperature`、`top_p`、`top_k`；超出范围时 Google 官方接口返回 400。

## 影响范围

* **适用**：在用 Gemini 4 Carbon、想在 12 月 1 日调价后降低单价的项目；在用 Gemini 4 Hydrogen、需要更强效果的项目；以及对单次任务耗时敏感的编程、智能体和推理任务。
* **不受影响**：本次上线没有调整已有模型。`gemini-4-carbon`、`gemini-4-argon`、`gemini-4-hydrogen`、`gemini-3.8-flash` 等 Gemini 模型继续可用，现有集成不需要修改。

## 需要做什么

1. 在[令牌管理](https://api2.laozhang.ai/token)确认 API Key 属于 `default` 分组；已有的 Key 不用换。
2. 把请求里的 `model` 改成 `gemini-4-neon`；原生接口改 URL 里的模型名。
3. 把客户端超时设到 600 秒左右，长回答改用流式输出。
4. 跑几条自己的样例，在[调用日志](https://api2.laozhang.ai/log)对比 token 用量和扣费，再决定默认思考级别。

## 常见问题

### Gemini 4 Neon 的模型 ID 是什么？

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

### Gemini 4 Neon 有免费额度吗？

Google 没有在免费层提供 Gemini 4 Neon，只能按付费层计费。在老张API上用老张API的 API Key 和 Base URL `https://api.laozhang.ai` 调用，余额预付、按 token 扣费，单价与 Google 付费层相同。

### Gemini 4 Neon 比 Carbon 便宜吗？

看日期。11 月 30 日前，Carbon 的官方单价 \$2 / \$10 更低；12 月 1 日起 Carbon 调到 \$4 / \$20，Neon 的 \$3 / \$15 更便宜。实际每次花多少还取决于思考 token，Neon 默认 `high`，Carbon 默认 `medium`。

### Gemini 4 Neon 怎么调思考级别？

用 Gemini 原生接口的 `generationConfig.thinkingConfig.thinkingLevel`，可选 `low`、`medium`、`high`、`xhigh`。OpenAI 兼容接口的 `reasoning_effort` 目前不能分档控制思考量。

### 为什么简单问题输出 token 也很多？

输出 token 包含思考 token。Neon 每次都会先思考，即使是简单问题也一样，这部分按输出单价计费。只要短回答时，在原生接口传 `"thinkingLevel": "low"`。

### Gemini 4 Neon 请求超时怎么办？

简单问题约 5–8 秒，有推理的题在 `high` 级别约 20 秒，`xhigh` 可能超过 60 秒。客户端超时设到 600 秒左右，并改用流式输出：

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

## 来源与相关链接

* [Google：Gemini 4 Neon 模型页](https://aistudio.google.com/docs/models/gemini-4-neon)：模型 ID、上下文窗口和输出上限。
* [Google：What's new in Gemini 4 Neon](https://aistudio.google.com/docs/whats-new-gemini-4-neon)：思考级别和采样参数的说明。
* [Google：Gemini API 价格](https://aistudio.google.com/docs/pricing)：Neon、Carbon 和 Hydrogen 的官方价。
* [Artificial Analysis](https://artificialanalysis.ai)：Intelligence Index 分数和任务耗时对比。
* [模型与价格总表](https://docs.laozhang.ai/models.md#vendor-google-text)：老张API当前单价。
* [Gemini 4 Carbon 上线公告](https://docs.laozhang.ai/announcements/gemini-4-carbon-2026-11.md)
* [Gemini 4 Hydrogen 上线公告](https://docs.laozhang.ai/announcements/gemini-4-hydrogen-2026-11.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.