Gemini 桌面端客户端配置完整指南:国内直连、OpenAI 兼容接口与常用工具推荐(2026最新)
首页 / 文章 / 技术教程 / Gemini 桌面端客户端配置完整指南:国内直连、OpenAI 兼容接口与常用工具推荐(2026最新)
ChatBox / Cherry Studio / NextChat / LobeChat 与 Itzyk Gemini Desktop 配置指南;Base URL 仅作代码参数展示,便于全网同步过审。
作者:Itzyk API · 发布:2026-11-13 · 更新:2026-11-16
标签:Gemini 桌面端 | ChatBox | Cherry Studio | NextChat | LobeChat | OpenAI 兼容 署名:Itzyk API · 更新:2026-11-14 · 阅读约 18 分钟 --- 想在本机调通 Gemini 桌面端 ,却总卡在官方出网、多套 SDK 和鉴权配置上?本文将基于面向开发者的 OpenAI 兼容 AI API 网关—— Itzyk(api.itzyk.top) ,说明如何用一套 sk- Key,把 Base URL 配成 https://api.itzyk.top/v1 ,在 ChatBox、Cherry Studio、NextChat、LobeChat 以及开源桌面端里统一调用 Gemini 等已上架模型。 平台配置说明 :下文所有示例均按 Itzyk 的 OpenAI Compatible 接口测试。客户端里只需把 base url 填为 https://api.itzyk.top/v1 (或按客户端规则填写主机名,见各节说明)。 --- 直连官方 SDK 与 OpenAI 兼容桌面端怎么选 | 对比项 | 官方 Gemini SDK / 网页 | OpenAI 兼容桌面端(Itzyk 网关) | |--------|------------------------|--------------------------------| | 接入成本 | 多套 SDK、环境与出网策略 | 改 base url + api key + model | | 客户端生态 | 少 | ChatBox / Cherry Studio / NextChat / LobeChat 等均可 | | 模型切换 | 换供应商常要改代码 | 同一 Key 换 model code | | 计费与控制台 | 分散 | 统一用量(以控制台公布为准) | 结论:只要客户端支持「OpenAI Compatible / 自定义 Base URL」,优先走聚合网关,桌面端与线上服务共用同一套协议。 --- ChatBox 接入 Gemini:OpenAI API 怎么填 1. 打开 ChatBox → 设置 / Settings → 模型供应商 (或 Model Provider)。 2. 新增供应商,类型选 OpenAI API 。 3. 填写: | 项 | 建议值 | |----|--------| | API Host / Base URL | https://api.itzyk.top/v1 | | API Key | 控制台创建的 sk-… | | 模型名 | gemini-3.6-flash (或服务页已上架 code,如 gemini-2.5-pro ) | 4. 保存后新建对话,发一句 ping 冒烟。 5. 若失败:检查是否少写 /v1 、Key 首尾空格、模型名是否与上架 code 完全一致。 --- Cherry Studio 配置 Gemini:OpenAI 兼容供应商 1. 打开 Cherry Studio → 设置 → 模型服务 / Providers 。 2. 添加 OpenAI 兼容 (或 OpenAI Compatible)供应商。 3. 填写: | 项 | 建议值 | |----|--------| | API 地址 | https://api.itzyk.top/v1 | | 密钥 | sk-… | | 模型 | gemini-3.6-flash | 4. 启用该供应商,在对话页选中对应模型再发送。 5. 常见坑:写成 …/v1/v1 ;把 Google AI Studio 官方 Key 当成平台 sk- 使用。 --- NextChat(ChatGPT-Next-Web)接入 Gemini 1. 打开 NextChat 设置中的 自定义接口 / OpenAI Endpoint 。 2. 注意版本差异:有的版本会 自动拼接 /v1 ,此时主机只填 https://api.itzyk.top ;有的版本要求完整 Base,填 https://api.itzyk.top/v1 。 3. API Key 填平台 sk-… ,模型填上架 code。 4. 若出现 404,优先怀疑「自动拼 /v1 + 你又手写了 /v1 」导致路径翻倍。 --- LobeChat 配置 Gemini OpenAI 兼容接口 1. 打开 LobeChat → 设置 → 语言模型 / OpenAI。 2. 开启自定义接口,Base URL 填 https://api.itzyk.top/v1 。 3. 填入 sk-… 与模型名(如 gemini-3.6-flash )。 4. 新建助手验证一轮短对话即可。 四款客户端参数速查 | 客户端 | 接口类型 | API 域名 / Base URL | API Key | 模型示例 | |--------|----------|---------------------|---------|----------| | ChatBox | OpenAI API | https://api.itzyk.top/v1 | sk-… | gemini-3.6-flash | | Cherry Studio | OpenAI 兼容 | https://api.itzyk.top/v1 | 同上 | 同上 | | NextChat | OpenAI | https://api.itzyk.top 或带 /v1 (看版本) | 同上 | 同上 | | LobeChat | OpenAI | https://api.itzyk.top/v1 | 同上 | 同上 | --- 联调冒烟:curl / Python / Node.js 先确认 Key 与模型在命令行通,再回头排查桌面端,能少走很多弯路。 Bash(macOS / Linux) PowerShell(Windows) Python Node.js --- 开源桌面端:Itzyk Gemini Desktop(保留安装与界面说明) 若需要「下载即用、带文生图 / 文生视频页」的一体客户端,可用开源 Itzyk Gemini Desktop (仓库目录名仍为 zhishu-gemini-desktop ,默认网关指向 https://api.itzyk.top/v1 )。 | 项 | 说明 | |----|------| | 名称 | Itzyk Gemini Desktop | | 版本 | v0.1.0(Windows amd64) | | 技术栈 | Go + Wails v2 + Vite | | 协议 | MIT | | 默认网关 | https://api.itzyk.top/v1 | | 能力 | 对话 · Nano Banana 文生图 · 文生视频 | 开源仓库(纯文本,非超链接): - GitHub: github.com/liwie/zhishu-gemini-desktop - Gitee: gitee.com/Itzyk/zhishu-gemini-desktop Windows 安装包(CDN 纯文本路径,复制到浏览器地址栏打开): - 最新 ZIP: cdn.itzyk.top/downloads/zhishu-gemini-desktop/latest/zhishu-gemini-desktop-windows-amd64.zip - 最新 EXE: cdn.itzyk.top/downloads/zhishu-gemini-desktop/latest/zhishu-gemini-desktop.exe - v0.1.0 备份: cdn.itzyk.top/downloads/zhishu-gemini-desktop/v0.1.0/zhishu-gemini-desktop-windows-amd64-v0.1.0.zip 系统要求:Windows 10 / 11(64 位);多数机器已自带 Edge WebView2,打不开窗口时再补装。 安装步骤 1. 下载 ZIP,解压到任意目录(如 D:\Apps\zhishu-gemini-desktop\ )。 2. 双击 zhishu-gemini-desktop.exe 。 3. SmartScreen 提示「未知发布者」时:更多信息 → 仍要运行(开源社区构建、无签名属正常)。 4. 左侧应出现:获取 API Key / AI 对话 / 文生图·香蕉 / 文生视频 / 设置。 ! Itzyk Gemini Desktop:获取 API Key 界面 https://cdn.itzyk.top/articles/zhishu-gemini-desktop-guide/01-portal-api-key.png 获取并保存 API Key 软件本身免费;调用模型按控制台价格计费。 1. 左侧 「① 获取 API Key」 → 注册 / 登录,或用系统浏览器打开门户后复制 Key。 2. 创建 Key,复制以 sk- 开头的密钥。 3. 粘贴到应用 → 保存 Key (也可在「⑤ 设置」改 Base URL / Key)。 ! Itzyk Gemini Desktop:设置页 https://cdn.itzyk.top/articles/zhishu-gemini-desktop-guide/05-settings.png | 项 | 值 | |
本文发布于 Itzyk API(AI API 网关,OpenAI 兼容)。更多: 文章中心 · 开发者文档 · API 服务 · 价格。