Daya API

通过答鸭 API 使用 Gemini CLI ​

Gemini CLI 是 Google 推出的开源编程助手工具，可以在本地终端中读取、分析和修改代码。
接入答鸭 API 后，您可以使用答鸭提供的 Gemini 兼容模型，而不仅限于 Google 官方 API。

3 步快速开始 ​

第 1 步：安装 Gemini CLI ​

先安装 Node.js LTS，安装完成后重新打开终端，再执行：

bash
npm install -g @google/gemini-cli --registry=https://registry.npmmirror.com

安装完成后，检查是否成功：

bash
gemini --version

如果能看到版本号，就表示安装成功。

Windows 提示找不到 gemini？

请先关闭并重新打开 PowerShell。
如果仍然无效，请检查 npm 全局安装目录是否已加入 PATH。

第 2 步：创建 .env ​

这一步只需要做一件事：创建一个文件，填入您的 API Key、答鸭 API 地址和默认模型。

请在下面位置创建文件：

  • Windows：C:\Users\您的用户名\.gemini\.env
  • macOS / Linux：~/.gemini/.env

文件内容如下：

bash
GEMINI_API_KEY="sk-替换为您的API_Key"
GOOGLE_GEMINI_BASE_URL="https://api.dayaai.com"
GEMINI_MODEL="gemini-3.1-pro-preview"

您的 API Key 可在 答鸭控制台 获取。

如果您不方便手动创建文件，也可以直接用下面命令打开编辑：

powershell
mkdir $env:USERPROFILE\.gemini -ErrorAction SilentlyContinue
notepad $env:USERPROFILE\.gemini\.env
bash
mkdir -p ~/.gemini
nano ~/.gemini/.env

保存后即可。

第 3 步：创建 settings.json ​

这一步只需要再做一件事：指定 Gemini CLI 使用 API Key 模式，避免启动时要求 Google 登录。

请在下面位置创建文件：

  • Windows：C:\Users\您的用户名\.gemini\settings.json
  • macOS / Linux：~/.gemini/settings.json

文件内容如下：

json
{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

如果您想直接打开这个文件编辑，可以使用：

powershell
notepad $env:USERPROFILE\.gemini\settings.json
bash
nano ~/.gemini/settings.json

实际上只需要这两个文件

这两个文件都放在 .gemini 文件夹中：

text
.gemini/
├─ .env
└─ settings.json
  • .env：保存 API Key、API 地址和默认模型
  • settings.json：保存认证方式配置

也就是说，配置 Gemini CLI 的过程，本质上就是：创建这两个文件，并填入对应内容。

开始使用 ​

配置完成后，进入您的项目目录，运行：

powershell
cd D:\my-project
gemini
bash
cd ~/my-project
gemini

后续使用时，只要直接输入 gemini 即可，无需重复设置 API Key。

也可以使用非交互方式做一次最小测试：

bash
gemini -p "Reply with OK only."

如果能正常返回内容，就表示 Gemini CLI 已经通过答鸭 API 工作。

支持的模型 ​

您可以修改 .env 中的 GEMINI_MODEL 字段，切换为答鸭 API 支持的其他 Gemini 兼容模型，例如：

bash
GEMINI_MODEL="gemini-3.1-pro-preview"

支持的模型列表请查看：

只使用 Gemini 兼容模型

Gemini CLI 使用 Gemini API 协议。请优先选择答鸭模型列表中支持 Gemini / Google 兼容协议的模型。
如果模型只支持 OpenAI 或 Anthropic 协议，Gemini CLI 可能无法直接调用。

故障排除 ​

API Key 无效或未授权

请检查：

  • .env 是否放在正确位置
  • 键名是否写成 GEMINI_API_KEY
  • API Key 是否已激活
  • API Key 是否填写完整
  • API Key 前后是否误加了空格
无法连接到答鸭 API

请检查：

  • 网络是否正常
  • .env 中的 GOOGLE_GEMINI_BASE_URL 是否为 https://api.dayaai.com
  • 防火墙是否阻止了连接
  • 可尝试执行以下命令测试：
bash
curl https://api.dayaai.com/models
启动后仍然要求 Google 登录

请检查：

  • settings.json 路径是否正确
  • Windows 路径应为：C:\Users\您的用户名\.gemini\settings.json
  • macOS / Linux 路径应为：~/.gemini/settings.json
  • selectedType 是否写成 gemini-api-key
  • 保存后是否重新打开了终端
已填写 API Key，但仍提示未配置

请检查：

  • .env 路径是否正确
  • Windows 路径应为：C:\Users\您的用户名\.gemini\.env
  • macOS / Linux 路径应为：~/.gemini/.env
  • 键名是否写成 GEMINI_API_KEY
  • 保存后是否重新打开了终端
修改模型后不生效

请检查：

  • .env 中是否只有一个 GEMINI_MODEL
  • 模型名称是否拼写正确
  • 当前模型是否支持 Gemini CLI 使用的协议
  • 保存后是否重新打开了终端或重启 Gemini CLI
模型不可用

请检查：

  • 模型名称是否拼写正确
  • 当前模型是否支持 Gemini / Google 兼容协议
  • 账户是否有权限访问该模型
  • 可在 答鸭模型列表 中确认

进阶配置 ​

您可以根据任务需求切换不同模型，只需要修改 .env 中的 GEMINI_MODEL 字段即可。

bash
GEMINI_API_KEY="sk-替换为您的API_Key"
GOOGLE_GEMINI_BASE_URL="https://api.dayaai.com"
GEMINI_MODEL="gemini-3.1-pro-preview"
bash
GEMINI_API_KEY="sk-替换为您的API_Key"
GOOGLE_GEMINI_BASE_URL="https://api.dayaai.com"
GEMINI_MODEL="gemini-2.5-pro"

联系我们

如果您在安装或使用过程中遇到问题，欢迎随时联系我们。

  • 客服微信：dayaai_com
  • 客户交流群：添加客服微信后拉群，或在 dayaai.com 首页扫码加入
  • 技术支持邮箱：cs@dayaai.com