> ## 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 3.8 Flash API 上线：价格、模型 ID 与接入方法

> 老张API已上线 Gemini 3.8 Flash。本页说明 gemini-3.8-flash 的当前输入与输出价格、适用场景、OpenAI 兼容调用方法和迁移注意事项。

* **发布日期**：2026 年 9 月 3 日
* **最后核对**：2026 年 9 月 3 日
* **当前状态**：有效；`gemini-3.8-flash` 已在老张API控制台上线，具体可用分组和实时价格以控制台为准

老张API现已上线 `gemini-3.8-flash`，通过 Chat 按量计费。2026 年 9 月 3 日控制台显示的价格为：**输入 \$0.75 / 1M tokens，输出（补全）\$3.75 / 1M tokens**。准备迁移的用户应先确认目标令牌分组可见该模型，再用真实提示词完成小流量验收。

## 关键事实

| 项目 | 当前结论 |
| - | - |
| 老张API模型 ID | `gemini-3.8-flash` |
| 计费类型 | 按量计费（Chat） |
| 输入价格 | \$0.75 / 1M tokens（2026 年 9 月 3 日控制台价格） |
| 输出价格 | \$3.75 / 1M tokens（2026 年 9 月 3 日控制台补全价格） |
| 老张API接口 | OpenAI 兼容 `POST /v1/chat/completions` |
| Google 官方状态 | GA，稳定模型 ID 为 `gemini-3.8-flash` |
| Google 官方 token 上限 | 最多 1,048,576 输入 tokens、65,536 输出 tokens |
| Google 官方 Thinking | `low`、`medium`、`high`；不支持 `minimal` |

<Tip>
  上表的 token 上限和 Thinking 等级来自 Google 官方规格。用到工具调用、结构化输出、多模态、流式响应或 Thinking 参数时，先用目标令牌各发一次小请求确认，再切换生产流量。
</Tip>

## 谁需要关注

* 正在为长时间软件工程、代码重构或复杂 Agent 工作流选择 Flash 模型的开发者；
* 当前使用 `gemini-3.6-flash` 或更早 Flash 型号，并准备做同任务对照测试的团队；
* 需要在输入、输出质量、延迟和 token 成本之间重新评估模型选择的生产应用。

不使用 Gemini 文本模型的图像生成、语音或视频生成工作流不受本次上线影响。已有稳定生产调用也不需要立即迁移；本公告新增模型，不代表旧模型同步下线。

## 如何调用 Gemini 3.8 Flash

先在[控制台模型与价格页面](https://api.laozhang.ai/account/pricing)确认目标令牌分组可见 `gemini-3.8-flash`，再发送最小文本请求：

```bash theme={null}
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-3.8-flash",
    "messages": [
      {"role": "user", "content": "审查这段代码的并发风险，并给出最小修改方案。"}
    ]
  }'
```

成功验收至少应确认：响应包含可用文本、响应中的模型与请求一致、调用日志记录输入与输出 tokens、实际扣费符合当前控制台价格。需要工具调用、结构化输出、多模态或流式响应时，再为每项能力增加独立测试，不要只凭一次 HTTP 200 全量切换生产流量。

## 迁移注意事项

[Google 官方迁移说明](https://ai.google.dev/gemini-api/docs/latest-model)对 Gemini 3.8 Flash 的 Thinking 等级说明如下：

* 默认 Thinking 等级为 `medium`。
* 支持 `low`、`medium`、`high`。
* `minimal` 会返回错误。

Google 原生 API 还要求迁移时检查已弃用的采样参数、`thinking_budget`、`candidate_count` 和对话轮次格式。

这些原生规则不应直接等同于老张API的 OpenAI 兼容协议。迁移时建议：

1. 只替换测试环境中的模型 ID，保留已验证的回退模型；
2. 使用代表性请求比较答案质量、首 token 延迟、总耗时与 token 用量；
3. 单独测试工具调用、JSON 输出、图片或文件输入以及流式返回；
4. 核对调用日志中的实际扣费后，再分阶段增加流量。

## 常见问题

### Gemini 3.8 Flash 的正确模型 ID 是什么？

使用 `gemini-3.8-flash`。不要自行添加 `-preview`、`-thinking` 或 `-nothinking` 后缀；只有控制台明确列出的兼容别名才可使用。

### 价格是多少？

上线价见上方关键事实表（2026 年 9 月 3 日控制台价格）。价格可能随线路或活动变化，批量调用前请复核[模型与价格总表](/models)和控制台，并以调用日志中的实际扣费为准。

### Gemini 3.8 Flash 是正式版吗？

是。Google 将 `gemini-3.8-flash` 标记为 GA 和稳定模型。老张API是否对某个令牌分组开放，仍需在控制台单独确认。

### 可以只改模型 ID 就迁移吗？

可以把替换模型 ID 作为第一步，但不能因此认定完整兼容。生产迁移前还需检查提示词效果、Thinking、工具调用、结构化输出、流式响应、token 用量和延迟。

### 旧版 Gemini Flash 需要立即停用吗？

不需要。本次是新增模型上线公告，不是旧模型下线通知。若旧模型的质量、延迟和成本仍满足要求，可以继续使用并安排对照测试。

## 证据来源与相关文档

* [Google：Gemini 3.8 Flash 官方模型页](https://ai.google.dev/gemini-api/docs/models/gemini-3.8-flash) — 上游状态、模型 ID、输入输出上限与能力范围
* [Google：Gemini 3.8 Flash 更新与迁移说明](https://ai.google.dev/gemini-api/docs/latest-model) — 上游默认 Thinking、价格窗口与迁移事项
* [Google：Gemini API 价格](https://ai.google.dev/gemini-api/docs/pricing) — 上游官方价格；不等同于老张API未来价格承诺
* [老张API OpenAI SDK 接入指南](/api-manual#openai-sdk) — OpenAI 兼容客户端配置
* [Gemini 3.6 Flash 与 3.5 Flash-Lite 上线公告](/announcements/gemini-flash-models-2026-07) — 旧款 Flash 模型与选型边界
* [老张API控制台](https://api.laozhang.ai/account/pricing) — 当前可用分组、实时价格与实际扣费入口


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