Gemini CLI 中转，改两个环境变量就能用
SoleAPI 原生支持 Gemini CLI 走的 generateContent / streamGenerateContent 协议：10 个 Google 模型，官方 429、503 时自动切到备用货源。支付宝充值，按量计费，无月费。
# ~/.zshrc / ~/.bashrc
export GOOGLE_GEMINI_BASE_URL="https://api.soleapi.com"
export GEMINI_API_KEY="sk-sole-..."
gemini -m gemini-3.1-pro-preview为什么用中转站，而不是直连官方
不是替代 Google，是在官方之上加一层：稳定性、支付和账单，三件官方不替你解决的事。
官方 5xx / 限流时自动切换
同一个模型挂着多条货源，Google 返回 500、过载或限流时，网关在首帧之前就切到备用货源，Gemini CLI 里看不到报错。
支付宝充值，按量计费
不用海外信用卡，不用订阅。1 Credit = ¥1，用多少扣多少；账单按模型、按密钥拆分，随时在控制台看。
原生协议，零缓冲转发
Gemini generateContent 协议直通，不做翻译；SSE 每一帧收到即转发，Gemini CLI 的流式体验和直连一致。
三步接入 Gemini CLI
三步接入，不需要改 Gemini CLI 的任何源码。
注册，领取体验额度
邮箱注册即送体验 Credits，够跑完一个真实项目的接入测试。
创建 API Key
控制台 → API Key → 新建。可以给这把 Key 设预算、限模型、限渠道。
指向 SoleAPI，启动 Gemini CLI
Base URL 换成 SoleAPI，Key 换成刚创建的，其余照旧。
# ~/.zshrc / ~/.bashrc
export GOOGLE_GEMINI_BASE_URL="https://api.soleapi.com"
export GEMINI_API_KEY="sk-sole-..."
gemini -m gemini-3.1-pro-previewGemini CLI 可用的模型与价格
SoleAPI 默认渠道价（Credits，1 Credit = ¥1），划线为官方价折算；点模型名看完整价目、协议与可用率。
| 模型 | 上下文 | 输入 / M | 输出 / M | 7 天可用率 |
|---|---|---|---|---|
| Gemini 3.1 Flash Lite Imagegemini-3.1-flash-lite-image | 64K | — | ||
| Gemini 2.5 Flashgemini-2.5-flash | 1M | 99.3% | ||
| Gemini 2.5 Flash Imagegemini-2.5-flash-image | 64K | — | ||
| Gemini 3 Flash Previewgemini-3-flash-preview | 1M | 96.3% | ||
| Gemini 3.1 Flash Imagegemini-3.1-flash-image | 128K | — | ||
| Gemini 3.7 Flashgemini-3.7-flash | 1M | 98.0% |
数据与模型目录同源，每 5 分钟刷新。 全部 10 个 Google 模型 →
Gemini CLI 常见报错，中转站怎么处理
这些报错来自 Google 官方接口本身。走 SoleAPI 时网关在首帧之前替你重试和切换，Gemini CLI 里通常看不到它们。
429 RESOURCE_EXHAUSTED触发官方配额
免费层每分钟 / 每天请求数用完，或付费项目 RPM 到顶。 SoleAPI：多把上游密钥分摊配额，一把 429 换下一把，不用等窗口重置。
503 UNAVAILABLE: The model is overloaded官方过载
高峰期 Google 主动拒绝。 SoleAPI：按货源健康度调度，过载的货源自动降权，请求走健康的那条。
400 API key not valid密钥不匹配
Base URL 指向了 SoleAPI 但 Key 还是 AI Studio 的，或反过来。 SoleAPI：Base URL 与 Key 必须成对：api.soleapi.com 配 sk-sole- 开头的 Key。
Request timed out长时间无响应
官方侧首帧迟迟不来。 SoleAPI：首帧前超时直接换货源重发；首帧之后每一帧收到即转发，不缓冲。
常见问题
Gemini CLI 中转站安全吗？我的代码会被看到吗？
转发前自动遮蔽密钥、邮箱等敏感信息；传输全程加密；不用你的请求数据训练任何模型。密钥可以限模型、限预算，泄露时一键吊销。
和直连 Google 官方有什么区别？
协议一样（generateContent 原生直通），模型一样，多了三样：官方故障时的自动切换、支付宝充值与人民币账单、按密钥拆分的用量与预算控制。
Claude Code、Codex 也能用吗？
能。Anthropic Messages 与 OpenAI Responses 协议同样支持，把各自的 Base URL 指到 SoleAPI 即可；所有工具共用同一个 API Key 和同一份余额。
怎么充值？最低多少？
控制台 → 钱包，支持支付宝；1 Credit = ¥1，按量扣费，没有月费和最低消费。余额不足会提前邮件提醒。
两个环境变量，Gemini CLI 稳定跑起来
注册即送体验额度，支付宝充值，按量计费无月费。