集成

Gemini CLI

两个环境变量让 Gemini CLI 接入 Half Off Dev，按 Gemini 官方价格的一半计费，再选好要用的 Gemini 模型。

Gemini CLI 是 Google 开源的终端 AI 助手，使用 Gemini API，而 Half Off Dev 原生提供这套 API。设置两个环境变量就能切换过来，此后每次 Gemini 调用都按官方价格的 5 折计费。开始前请先创建 API 密钥。

配置#

export 接入地址和密钥，然后带上模型启动：

Shell

export GOOGLE_GEMINI_BASE_URL=https://halfoff.dev
export GEMINI_API_KEY=$HALFOFF_API_KEY
gemini -m gemini-3.1-pro

地址只填域名部分即可，版本路径由 Gemini CLI 自己拼接。

或者从控制台导入#

在 API 密钥页面选择 接入客户端 → Gemini CLI，就能看到已填好密钥的这几行命令。用 CC Switch 一键导入 会在 CC Switch 桌面应用里添加 Half Off Dev 供应商并设好模型（需先安装 CC Switch）。新建的密钥会自动填入；已有的密钥请粘贴完整内容，因为 Half Off Dev 只保存哈希。

模型#

用 -m 参数指定模型。GET /v1/models 里的任何 Gemini 模型 ID 都能用，比如难题交给 gemini-3.1-pro，简单任务用 gemini-3-flash。所有 ID 见模型列表。

常见报错#

现象	处理方法
`401` `Missing API key`	密钥没有发到 Half Off Dev。在运行 `gemini` 的 shell 里 export `GEMINI_API_KEY`。
`401` `Invalid or revoked API key`	密钥输错、被截断或已吊销。重新粘贴，或新建一个。
`404` `Model '...' is not available`	模型 ID 不存在。从 `GET /v1/models` 或模型列表复制 Gemini 模型 ID。
`404` `Unknown endpoint /v1/v1beta/...`	`GOOGLE_GEMINI_BASE_URL` 末尾带了 `/v1`。改成 `https://halfoff.dev`。
`402`	余额已用完，或密钥达到消费上限。见余额与计费。

其他状态码见错误码。