Gemini 相关问题

Gemini CLI 现状说明

Gemini CLI 对第三方兼容端点的支持会随版本变化。如果当前 Gemini CLI 无法正确拼接 aivoyz 的 /v1beta/models/*path，可以改用支持 OpenAI-compatible 的 VSCode 插件或客户端。

::: important 源码确认 aivoyz 支持 Gemini 兼容路由，但具体 CLI 是否接受自定义 Base URL 要以工具版本为准。 :::

替代方案

工具	接入方式
Roo Code	OpenAI-compatible 或 Gemini provider。
Cline	OpenAI-compatible。
Cherry Studio	OpenAI-compatible / Gemini provider。
自写脚本	直接请求 /v1beta/models/{model}:generateContent。

在 Cline 中使用 Gemini

1. 打开 Cline 设置。
2. Provider 选择 OpenAI Compatible。
3. Base URL 填 https://api.52hertz-palpitate.cn/v1。
4. API Key 填 aivoyz 令牌。
5. Model 填 gemini-3-flash 或模型广场显示的 Gemini 模型。

Cline 配置项	值
API Provider	OpenAI Compatible
Base URL	https://api.52hertz-palpitate.cn/v1
API Key	sk-your-aivoyz-token
Model	gemini-3-flash
Streaming	视模型和客户端支持情况选择

配置完成后先发送一条短消息测试，例如“只回复 connected”。如果失败，优先检查 Base URL 是否带 /v1、令牌分组是否包含 Gemini 模型，以及客户端是否强制走 Gemini 官方端点。

自写脚本验证

如果 GUI 客户端不确定是否正确使用 aivoyz 线路，可以用最小请求先验证接口：

curl https://api.52hertz-palpitate.cn/v1beta/models/gemini-3-flash:generateContent \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: sk-your-aivoyz-token" \
  -d '{
    "contents": [
      {
        "parts": [
          { "text": "只回复 connected" }
        ]
      }
    ]
  }'

::: note 不同客户端对 Gemini 与 OpenAI-compatible 的字段命名不同。遇到模型不存在或鉴权失败时，先确认客户端实际发出的接口路径和请求头。 :::