Kling 4.0 现已上线 — 真实到难以置信的视频 | 立即体验 →
Agent 配置

将 Gemini CLI 接入 WaveSpeed LLM API

复制推荐的 ~/.gemini/.env 配置,将 Gemini CLI 请求路由到 /v1beta/models/{model}:generateContent,并在 WaveSpeed Logs 中验证本地 agent 调用。

Google 开源的终端智能体,可指向 WaveSpeed 的 Gemini 兼容端点。

配置文件

~/.gemini/.env

协议

Gemini generateContent API

Endpoint

/v1beta/models/{model}:generateContent

手动配置

1

创建 WaveSpeed Access Key

2

在本地导出所需密钥

3

将配置粘贴到~/.gemini/.env

4

运行 gemini 并查看 Logs

OpenAI 兼容 Chat Completions

用量会出现在 Dashboard 和 Logs 中

无需改 Agent 代码即可切换模型

一条命令完成配置

配置 Gemini CLI、检查是否可用,并备份你原有的设置。加上 --undo 即可恢复。

  1. 1

    安装 WaveSpeed CLI

    npm install -g @wavespeed/cli
  2. 2

    登录

    wavespeed login
  3. 3

    配置 Gemini CLI

    wavespeed setup gemini

没有 Node.js?查看其他安装方式

手动配置

编辑 ~/.gemini/.env
# File: ~/.gemini/.env  (read only in folders Gemini CLI trusts)
GOOGLE_GEMINI_BASE_URL=https://llm.wavespeed.ai
GEMINI_API_KEY=wsk_live_...

# File: ~/.gemini/settings.json
{
  "security": { "auth": { "selectedType": "gemini-api-key" } },
  "model": { "name": "deepseek/deepseek-v4.1-flash-1017" }
}
保存此配置文件前,请把 wsk_live_... 替换为你真实的 WaveSpeed API 密钥。

Agent 接入指南

将 Gemini CLI 接入 WaveSpeed LLM API

本指南说明如何通过 ~/.gemini/.env、Gemini generateContent API、/v1beta/models/{model}:generateContent、base URL https://llm.wavespeed.ai/v1 和默认模型 deepseek/deepseek-v4.1-flash-1017 将 Gemini CLI 接入 WaveSpeed AI。复制上方配置,导出 API key,运行 agent,然后在 Logs 中验证请求。

1

创建 WaveSpeed Access Key

2

在本地导出所需密钥

3

将配置粘贴到

~/.gemini/.env
4

运行 gemini 并查看 Logs

这个 Gemini CLI 配置会设置什么

协议

Gemini generateContent API

Endpoint

/v1beta/models/{model}:generateContent

模型

deepseek/deepseek-v4.1-flash-1017

上方可复制配置就是推荐方案下唯一需要编辑的 Gemini CLI 文件:~/.gemini/.env。API key 建议保留在 shell 环境变量中,避免提交到代码仓库。

常见问题排查

API key 没有生效

请在运行 Gemini CLI 的同一个 shell 中导出 WAVESPEED_API_KEY。如果写入 shell profile,需要重新加载终端后再启动 agent。

请求出现协议或 endpoint 错误

确认 Gemini CLI 使用的是 Gemini generateContent API 和 endpoint /v1beta/models/{model}:generateContent。协议不匹配是 404 或 payload 错误最常见的原因。

选择的模型不可用

先确认模型 ID 存在于 WaveSpeed Models,再将完整 ID 粘贴到 ~/.gemini/.env。也可以先使用本页展示的默认模型。

Logs 中没有请求记录

确认 Gemini CLI 使用的是 WaveSpeed base URL 和当前 API key。然后从本地 agent 发送一个新 prompt,并刷新 Logs。

这个 Gemini CLI 指南可以被搜索到吗?

可以。这个页面被设计成可索引的接入指南,用来承接搜索 Gemini CLI custom provider、OpenAI-compatible endpoint、base URL 和本地 agent 配置流程的用户。