FlashCoding.AI 文档

外观

Gemini CLI 接入 ​

Gemini CLI 可以通过 Gemini 兼容环境变量连接 FlashCoding.AI。下面先在单个终端会话中完成配置，确认成功后再考虑持久化。

适用场景 ​

  • 已安装 Gemini CLI，希望使用 FlashCoding.AI 控制台中的模型。
  • Gemini CLI 启动后仍访问默认服务，或反复进入认证选择流程。
  • 需要用独立的 API Key 和模型 ID 做一次最小接入测试。

前置条件 ​

开始前准备好：

  1. 已安装可正常启动的 Gemini CLI；可先运行 gemini --version 检查。
  2. 从 FlashCoding.AI 控制台创建的 API Key。下文使用 sk-your-key 占位。
  3. 从控制台复制的完整模型 ID。下文使用 your-model-id 占位。
  4. 当前密钥和模型支持 Gemini CLI 所使用的 Gemini 原生协议。

保护 API Key

不要把真实密钥写进项目文件、公开的 Shell 脚本或截图。发现密钥泄露时，应立即在控制台停用并创建新密钥。

操作步骤 ​

1. 在当前终端设置环境变量 ​

macOS / Linux：

bash
export GOOGLE_GEMINI_BASE_URL="https://flashcoding.ai"
export GEMINI_API_KEY="sk-your-key"
export GEMINI_MODEL="your-model-id"

Windows PowerShell：

powershell
$env:GOOGLE_GEMINI_BASE_URL = "https://flashcoding.ai"
$env:GEMINI_API_KEY = "sk-your-key"
$env:GEMINI_MODEL = "your-model-id"

GOOGLE_GEMINI_BASE_URL 使用服务根地址。不要追加 /v1、/v1beta 或 :generateContent，Gemini CLI 会根据调用自行生成后续路径。

2. 替换密钥与模型 ​

把 sk-your-key 替换为真实 API Key，把 your-model-id 替换为控制台中当前可用的完整模型 ID。模型列表会变化，因此不要直接复制其他人的配置。

3. 从同一个终端启动 ​

bash
gemini

如果当前版本显示认证方式，选择使用 Gemini API Key 的方式。CLI 应从 GEMINI_API_KEY 读取凭证，无需把真实密钥再次写入项目配置。

进入会话后发送：

text
请只回复：Gemini CLI 连接成功

首次验证只做文本请求，不要同时启用工具调用、扩展或复杂生成参数。

4. 按需保存配置 ​

临时变量在关闭终端后失效。需要长期使用时，可以用受保护的环境变量管理方式注入密钥；只将 Base URL 和模型 ID 等非敏感值写入个人 Shell 配置。

保存后应新开终端并重新启动 Gemini CLI。已运行的进程不会自动读取变量变化。

成功验证 ​

接入成功时应同时满足：

  • Gemini CLI 能返回测试文本，不再使用错误的默认服务地址。
  • 当前模型与 GEMINI_MODEL 中配置的完整模型 ID 一致。
  • FlashCoding.AI 控制台的使用记录中出现刚才的请求。
  • 最终请求路径由 CLI 正常生成，没有重复的 /v1 或 /v1beta。

常见错误 ​

启动后仍进入认证流程 ​

确认 GEMINI_API_KEY 已在启动 CLI 的同一终端中设置，变量名没有拼错。若设置变量前已经启动 Gemini CLI，请完全退出后重试。

401 或 403 ​

重新从控制台复制 API Key，确认密钥未停用，并检查当前密钥或分组是否能访问目标模型。不要把占位符 sk-your-key 原样使用。

404 或路径中出现重复版本号 ​

GOOGLE_GEMINI_BASE_URL 应为 https://flashcoding.ai。删除手动添加的 /v1、/v1beta 或完整接口路径，再让 CLI 自行拼接。

模型不存在或不可用 ​

从控制台复制完整模型 ID 到 GEMINI_MODEL，并确认该模型支持 Gemini 原生协议。同名模型在不同协议或分组下不一定可互换。

设置新模型后仍调用旧模型 ​

完全退出 Gemini CLI，从已更新 GEMINI_MODEL 的终端重新启动。还要检查个人 Shell 配置是否在终端启动时覆盖了当前值。

返回 HTML 或无法解析响应 ​

通常表示 Base URL 指向了网页路由，或中间代理返回了错误页。记录最终请求 URL、状态码和响应正文，确认地址使用 HTTPS 且没有额外路径。

下一步 ​