Gemini 专题

Gemini 相关报错，以及为什么本站不提供官方 Gemini CLI 的配置教程。

📌

先说结论

本站不写 Google 官方 Gemini CLI 的配置教程。 原因是官方 CLI 在当前渠道上的稳定性不足 —— 写一份随时会失效的教程对用户没帮助。

替代路径：用 Cline / Roo Code 这类客户端 + 【Gemini】Pro · 企业级 分组。见下「推荐怎么用」。

客户端	类型	说明
Cline	VS Code 插件	支持 Gemini 协议，装完填两个值就能用
Roo Code	VS Code 插件	同类，按使用习惯二选一
Cherry Studio	桌面客户端	用 OpenAI 兼容模式接 Gemini
沉浸式翻译	浏览器插件	用 OpenAI 兼容模式

模型名	定位
`gemini-3.1-pro`	能力强，适合复杂任务
`gemini-3.7-flash`	速度快
`gemini-3.8-flash`	速度快

怎么填

Gemini 有两种接法，按你的客户端选：

接法	基础地址	路径形态
原生 Gemini 格式	`https://cn.fluxtoken.ai`	`/v1beta/models/<模型>:generateContent`
OpenAI 兼容格式	`https://cn.fluxtoken.ai/v1`	`/chat/completions`

国内加速https://cn.fluxtoken.ai默认使用。国内网络首选，延迟更低。

全球站 · 源站直连https://api.fluxtoken.ai港澳台及境外用户请用此地址；国内加速异常时也可回退到这里。

完整的 curl 与 SDK 示例在Gemini 兼容接口。

报错一：为什么官方 Gemini CLI 没有教程

现象

你搜「FluxToken Gemini CLI 配置」，找不到教程。

原因

这是有意为之，不是文档缺失。

官方 Gemini CLI 在当前渠道上的稳定性不足。一份配置教程的背后是一套版本、参数、认证方式的假设，官方 CLI 迭代快，这些假设很容易失效 —— 用户照着做却跑不通，比没有教程更糟。

解决

用替代路径。在 FluxToken 上跑 Gemini，推荐走客户端而不是官方 CLI：

装 Cline 或 Roo Code（VS Code 插件）
协议选 Gemini（原生格式）
基础地址填 https://cn.fluxtoken.ai
令牌填控制台「令牌管理」里生成的
模型填 gemini-3.1-pro（或两个 flash 之一）
令牌分组必须是 【Gemini】Pro · 企业级

如果你更熟悉 OpenAI 兼容的接法，也可以用 Cherry Studio 之类的客户端走 OpenAI 模式。

报错二：`模型不存在`

现象

客户端提示 模型不存在 或 model not found，但模型名看着没错。

原因

令牌的分组不是 【Gemini】Pro · 企业级。

Gemini 对话模型只在这个分组里。如果你的令牌建在别的分组上（比如某个 Claude 或 Codex 分组），调用 Gemini 模型必然报这个错。

解决

确认令牌分组 —— 控制台 → 令牌管理。

对照该选哪个分组：

你想用的模型	该选的分组
`gemini-3.1-pro`、`gemini-3.7-flash`、`gemini-3.8-flash`	`【Gemini】Pro · 企业级`
`gemini-3-pro-image-preview`、`gemini-3.1-flash-image-preview`	`【Gemini】banana生图模型`

改分组 —— 令牌管理 → 编辑 → 改分组 → 保存。
重启客户端 —— 改完不重启不生效。

完整步骤见模型不存在。

【Gemini】Pro · 企业级×0.3

采用 Gemini Pro 企业级池子稳定性一流。

模型数: 3
输入价起: $0.225 /1M
上游: Google

查看该组全部模型（3）

gemini-3.1-pro$0.6 / $3.6
gemini-3.7-flash$0.225 / $1.125
gemini-3.8-flash$0.225 / $1.125

【Gemini】banana生图模型×0.6

暂无说明。

模型数: 2
输入价起: $— /1M
上游: Google

查看该组全部模型（2）

gemini-3-pro-image-preview$— / $—
gemini-3.1-flash-image-preview$— / $—

报错三：`API key is required` / `Invalid API key`（Gemini 风格 401）

现象

返回 401，响应体是 Gemini 风格的结构：

json

{
  "error": {
    "code": 401,
    "message": "API key is required",
    "status": "UNAUTHENTICATED"
  }
}

令牌无效时 message 变 Invalid API key，status 仍是 UNAUTHENTICATED。

原因

请求头里没有令牌 —— message 是 API key is required
令牌无效 —— message 是 Invalid API key

注意 Gemini 路径的响应格式和另外两种协议不一样

OpenAI 兼容路径返回 {code, message}
Anthropic 兼容路径返回 {code, message}
Gemini 原生路径返回 {error: {code, message, status}}

如果你的程序要解析错误信息，这三套结构得分开判断。

解决

确认请求头 —— Gemini 原生路径三种都接受：
三种鉴权头（任选一种）
```
x-goog-api-key: sk-你的令牌Authorization: Bearer sk-你的令牌x-api-key: sk-你的令牌
```
Gemini SDK 默认发 x-goog-api-key，一般不用改。
确认客户端没把 Key 吞掉 —— 有些客户端在「原生 Gemini 模式」下填 Key 的位置和「OpenAI 模式」是分开的，填错格子等于没填。

用 curl 直测：

直测 Gemini 路径

curl -s -o /dev/null -w "%{http_code}\n" \  https://cn.fluxtoken.ai/v1beta/models \  -H "x-goog-api-key: sk-你的令牌"

200 → 令牌没问题，是客户端配置问题。 401 → 看认证与 401。

报错四：404 / 路径错误

现象

404，或客户端提示找不到模型端点。

原因

Gemini 的两条路径格式不同，容易混：

你要用	路径长什么样
原生格式	`https://cn.fluxtoken.ai/v1beta/models/gemini-3.1-pro:generateContent`
OpenAI 兼容格式	`https://cn.fluxtoken.ai/v1/chat/completions`

常见的错法：

把 /v1beta 写成了 /v1 —— Gemini 原生格式用的是 v1beta
在原生格式里多写了 /v1 —— 变成 /v1/v1beta/...
用 OpenAI 兼容格式时漏了 /v1 —— 见下条

解决

对照上面两张表逐字核对。
注意这条判据 —— OpenAI 兼容路径漏写 /v1 时，响应体是纯文本 404 page not found，不是 JSON。看到非 JSON 的 404 就是路径问题。
确认模型名和方法拼写 —— :generateContent 前面的冒号不能少，模型名逐字对照模型列表（注意两个生图模型带 -preview）。

报错五：Gemini 模型响应慢或超时

现象

请求很久没响应，或报超时。

原因

上游渠道波动 —— 先看服务状态页
gemini-3.1-pro 本身较慢 —— Pro 比 Flash 慢是正常的
长上下文或生图任务 —— 本身耗时长

解决

换 flash 型号试 —— gemini-3.7-flash 或 gemini-3.8-flash，速度明显更快。用快模型验证通路是否正常。
看服务状态页 —— https://status.fluxtoken.ai/
换端点试 —— cn ↔ api。
加大超时 —— 长任务需要更长的客户端超时。

详见连接与超时。

报错六：生图模型报错

现象

用 gemini-3-pro-image-preview 或 gemini-3.1-flash-image-preview 时报错。

原因

分组不对 —— 这两个模型在 【Gemini】banana生图模型，不在 【Gemini】Pro · 企业级
用 token 的直觉估算成本 —— 它们是按次计费，不按 token

解决

令牌分组改成 【Gemini】banana生图模型，重启客户端。
计费方式见生图模型和模型价格表。

完整排查顺序

看服务状态页 https://status.fluxtoken.ai/
确认令牌分组 —— Gemini 对话模型要 【Gemini】Pro · 企业级
确认路径格式 —— 原生用 /v1beta，OpenAI 兼容用 /v1
用 curl 直测 —— 分割「令牌问题」和「客户端配置问题」
看错误响应结构 —— Gemini 风格是 {error:{...}}，别按 {code,message} 解析
重启客户端
换端点试 —— cn ↔ api
慢的话换 flash 型号

还不行怎么办

服务状态页 https://status.fluxtoken.ai/
报错原文索引 —— 报错原文索引
协议文档 —— Gemini 兼容接口
进群 —— QQ 群 1108757955 · Telegram https://t.me/fluxtokengroup

进群请附上：客户端名称、协议模式（原生/OpenAI 兼容）、基础地址、模型名、分组名、完整报错原文。

Gemini 专题

推荐怎么用 Gemini

用客户端，不用官方 CLI

三个可用的 Gemini 模型

怎么填

报错一：为什么官方 Gemini CLI 没有教程

现象

原因

解决

报错二：`模型不存在`

现象

原因

解决

报错三：`API key is required` / `Invalid API key`（Gemini 风格 401）

现象

原因

解决

报错四：404 / 路径错误

现象

原因

解决

报错五：Gemini 模型响应慢或超时

现象

原因

解决

报错六：生图模型报错

现象

原因

解决

完整排查顺序

还不行怎么办

相关页面

Gemini 专题 ​

推荐怎么用 Gemini ​

用客户端，不用官方 CLI ​

三个可用的 Gemini 模型 ​

怎么填 ​

报错一：为什么官方 Gemini CLI 没有教程 ​

现象 ​

原因 ​

解决 ​

报错二：模型不存在 ​

现象 ​

原因 ​

解决 ​

报错三：API key is required / Invalid API key（Gemini 风格 401） ​

现象 ​

原因 ​

解决 ​

报错四：404 / 路径错误 ​

现象 ​

原因 ​

解决 ​

报错五：Gemini 模型响应慢或超时 ​

现象 ​

原因 ​

解决 ​

报错六：生图模型报错 ​

现象 ​

原因 ​

解决 ​

完整排查顺序 ​

还不行怎么办 ​

相关页面 ​

Gemini 专题

推荐怎么用 Gemini

用客户端，不用官方 CLI

三个可用的 Gemini 模型

怎么填

报错一：为什么官方 Gemini CLI 没有教程

现象

原因

解决

报错二：`模型不存在`

现象

原因

解决

报错三：`API key is required` / `Invalid API key`（Gemini 风格 401）

现象

原因

解决

报错四：404 / 路径错误

现象

原因

解决

报错五：Gemini 模型响应慢或超时

现象

原因

解决

报错六：生图模型报错

现象

原因

解决

完整排查顺序

还不行怎么办

相关页面