主题
Kelivo 配置说明
本文先介绍 Kelivo 是什么，再一步步演示如何在 Kelivo 中配置 OpenAI 分类的供应商，把请求指向自定义 API 服务，并在需要生成图片时打开 Response API 与 图像生成内置工具。
全文顺序为：认识 Kelivo → 准备 → 打开设置 → 进入供应商 → 填写 Key 与地址 → 添加模型 → 开启图像生成 → 测试 → 排错。
Kelivo 是什么
Kelivo 是一款开源、免费、多平台的 AI 聊天客户端（AGPL-3.0 许可）。它本身不提供模型，只是一个"外壳"：你把自己的 API Key 填进去，它负责界面、会话管理和各种增强功能。
| 特性 | 说明 |
|---|---|
| 多平台 | Android、iOS、HarmonyOS、Windows、macOS、Linux，同一套 Flutter 代码 |
| 多供应商 | OpenAI、Gemini、Anthropic 及任意 OpenAI 兼容中转服务，可同时配置多家并随时切换 |
| 自定义助手 | 为不同场景建立独立的助手（人格、提示词、模型、参数） |
| 多模态输入 | 图片、PDF、Word、纯文本文档 |
| 联网搜索 | 内置 Bing、DuckDuckGo、Tavily、Exa 等十余种搜索服务 |
| MCP 工具 | 支持 Model Context Protocol，扩展外部工具能力 |
| 增强功能 | 世界书、记忆、快捷短语、指令注入、语音朗读（TTS）、网络代理 |
| 数据自主 | 配置可用二维码分享，会话支持备份与恢复，数据留在本机 |
适合谁
如果你已经有一个 API Key（官方或中转），想要一个界面现代、功能齐全、手机和电脑都能用的客户端，Kelivo 是很合适的选择。它不替你解决"从哪买 Key"的问题，只解决"Key 怎么好用"的问题。
配置速查
| Kelivo 字段 | 填写内容 | 说明 |
|---|---|---|
| 供应商类型 | OpenAI | 决定请求格式，OpenAI 兼容服务都选这个 |
| 名称 | OpenAI，或自定义 | 仅用于本机辨认，可改成服务商名字 |
| API Key | 你自己的 API Key | 从服务方后台创建并复制 |
| API Base URL | https://api.quietdogapi.com/v1 | 必须包含末尾的 /v1 |
| 是否启用 | 打开 | 关闭后该供应商不参与对话 |
| 多 Key 模式 | 关闭 | 只有需要多 Key 轮询时才打开 |
Response API (/responses) | 需要图像生成时打开 | 走 /v1/responses，内置工具依赖它 |
| 模型 | 从"模型"页同步或手动添加 | 不要照抄文档或截图里的示例模型 |
| 内置工具 → 图像生成 | 需要出图时打开 | 在单个模型的编辑弹窗里设置 |
不要泄露 API Key
API Key 等同于账户密码。只把它粘贴进 Kelivo 的输入框，不要放进截图、聊天记录、公开文档或 Git 仓库。Kelivo 的"二维码分享"会包含 Key，不要把这类二维码发到公开场合。怀疑泄露时立即在后台停用旧 Key 并创建新 Key。
开始前准备
- 已安装 Kelivo（未安装见 第 1 步）；
- 已在服务方后台创建 API Key（见 创建 API 密钥）；
- 已验证该 Key 能正常访问
/v1/models（见下方命令）； - 手机或电脑网络能正常访问接口域名。
验证 Key 是否可用：
bash
curl -s -o /dev/null -w "%{http_code}\n" \
https://api.quietdogapi.com/v1/models \
-H "Authorization: Bearer sk-your-api-key"powershell
curl.exe -s -o NUL -w "%{http_code}`n" `
https://api.quietdogapi.com/v1/models `
-H "Authorization: Bearer sk-your-api-key"返回 200 表示 Key 有效；返回 401 / 403 说明 Key 无效、已停用或受限制，先解决这一步再往下走。
1. 安装 Kelivo
Android（本站镜像）
GitHub 在国内访问不稳定，我们把安卓安装包镜像了一份：
| 项目 | 内容 |
|---|---|
| 下载 | Kelivo_android_1.2.4+68_arm64-v8a.apk |
| 版本 | 1.2.4+68 |
| 架构 | arm64-v8a |
| 大小 | 70.8 MiB（74,245,849 字节） |
| SHA256 | ff80d9058a32ac487ab74d604a0e709f3876a49afe355a45425537d364ff86a3 |
该选哪个架构
选 arm64-v8a 就对了——2015 年后的安卓手机几乎全是 64 位 ARM。
只有极老或极低端的设备才需要 armeabi-v7a，x86_64 是给模拟器和部分 Chromebook 用的。装错了会提示「应用未安装」或装上闪退，换正确的包重装即可，不会有其他影响。这两个包请到 GitHub Releases 获取。
安装时会提示「未知来源」
侧载 APK 时系统会拦截，需要在弹窗里允许当前应用（浏览器或文件管理器）安装未知来源的应用。装完建议把该权限关回去。
校验文件完整性（可选）
镜像文件与上游发布版逐字节相同，你可以自行核对。把下载到的文件算一次 SHA256，应与上表一致，也与 GitHub Releases 页面 上标注的值一致：
bash
shasum -a 256 Kelivo_android_1.2.4+68_arm64-v8a.apkpowershell
Get-FileHash Kelivo_android_1.2.4+68_arm64-v8a.apk -Algorithm SHA256对不上说明文件在传输中损坏或被篡改，不要安装，重新下载或改从上游获取。
其他平台
镜像只提供安卓包，其余平台请走官方渠道，不要从来源不明的第三方站点下载：
- 官网：kelivo.psycheas.top
- GitHub Releases（Windows / macOS / Linux / iOS ipa）：github.com/Chevey339/kelivo/releases
- iOS：App Store 搜索
Kelivo
关于本站镜像
Kelivo 采用 AGPL-3.0 许可，允许再分发。本站仅原样转存官方发布的安装包，未做任何修改，对应源码见 github.com/Chevey339/kelivo。
镜像版本可能落后于上游，需要最新版请直接从 GitHub Releases 下载。
安装后启动一次，确认能进入下图的对话界面。首次进入时还没有任何供应商，发消息会报错，这是正常的。
2. 打开左侧抽屉
在对话界面点击左上角的菜单按钮，展开左侧抽屉。
- 菜单按钮 —— 展开助手列表与设置入口。
3. 进入设置
抽屉展开后，点击左下角的齿轮图标进入设置。
- 设置（齿轮图标） —— 所有配置都在这里。左边的"用户"是账号与外观，不要点错。
4. 打开供应商列表
在设置页的模型与服务分组中找到两项，本文只用第一项：
- 供应商 —— 添加、启用、配置 API 服务（本文重点）；
- 默认模型 —— 配置完成后回到这里，指定新会话默认使用的模型。
5. 选择 OpenAI 分类的供应商
供应商列表里预置了一批常见服务，每行右侧显示 启用 / 禁用 状态。
- OpenAI —— 点进去即可，标准 OpenAI 分类，兼容绝大多数中转服务；
- 右上角
+—— 如果你想保留官方 OpenAI 配置不动，用它新建一个供应商，供应商类型同样选OpenAI。
用预置的 OpenAI，还是新建一个？
只用一个服务就直接改预置的 OpenAI，最省事。同时要用官方和中转、或者要接多家中转，就用 + 各建一个，名称写成服务商的名字，方便在对话里切换。
6. 填写 Key 与地址（并按需打开 Response API）
进入供应商详情页，底部有 配置 与 模型 两个标签，先在"配置"里填好这几项：
- Response API (
/responses) —— 需要图像生成时打开；只做纯文字对话可以保持关闭； - API Key —— 粘贴后台创建的密钥，注意前后不要带空格、引号或换行；
- API Base URL —— 填
https://api.quietdogapi.com/v1，必须包含末尾的/v1，后面不要再加/chat/completions或/responses； - 模型标签 —— 填好上面三项后切到这里添加模型（下一步）。
同页还有几个开关，保持默认即可：是否启用打开、多 Key 模式关闭、分组只影响列表里的归类。
Response API 是图像生成的前提
Kelivo 的内置工具（图像生成、代码解释器）依赖 OpenAI 的 Responses 接口。Response API 关闭时，模型编辑弹窗里的内置工具不会生效。 想出图就先在这里打开它。
反过来，如果你的通道只支持 Chat Completions，打开 Response API 后会出现 404，此时应关掉它，并放弃内置工具（改用专门的绘图模型走对话接口）。
7. 添加模型
切到 模型 标签，底部会弹出模型选择面板。
- 刷新 / 同步按钮 —— 请求
GET /v1/models，拉取当前 Key 实际可用的模型列表； - 分组右侧的
+—— 把整个分组（如GPT）一次性全部添加； - 单个模型右侧的
+—— 只添加你要用的那一个，推荐这种做法，列表更干净。
模型名下方的小标签表示能力：聊天、T 🖼 > T（图文输入、文字输出）、工具调用、推理等。
不要手填模型 ID
不同 Key、不同分组、不同时间可见的模型不一样，截图里的 gpt-5.6-luna 等名称只是示例。始终以刷新结果为准。
同步列表为空或报错时，按顺序检查：
- 用上面的
curl确认/v1/models返回200； - Base URL 是否恰好为
https://api.quietdogapi.com/v1； - 重新粘贴 Key，确认前后没有空格或换行；
- Key 是否过期、停用、额度不足或受 IP 限制；
- 检查设置里的网络代理是否拦截了该域名。
8. 开启图像生成内置工具
模型添加完成后，点击已添加模型的名称打开「编辑模型」弹窗，切到 内置工具 标签。
- 内置工具标签 —— 与"基本设置""高级设置"并列；
- 图像生成 —— 打开这个开关，模型即可在对话中直接出图；
- 确认 —— 必须点一下才会保存。
弹窗顶部提示"内置工具取决于供应商和 API 模式"，含义就是：开关能否生效取决于第 6 步的 Response API 是否打开，以及通道是否真的支持。 上图中"代码解释器"保持关闭，需要时同理打开。
这是按模型设置的
内置工具是单个模型的属性，不是供应商的全局属性。换用另一个模型出图，需要在那个模型的编辑弹窗里再打开一次。
9. 回到对话测试
- 回到设置 → 默认模型，把刚配置好的模型设为默认（可选，但省去每次手选）；
- 回到对话界面，新建一个会话，确认顶部/输入区显示的是目标模型；
- 先发一条纯文字消息验证连通：
text
请只回复：连接成功- 再发一条出图请求验证内置工具：
text
画一只戴着宇航头盔的柴犬，卡通风格文字能回、图片能出，说明 Kelivo、API Key、Responses 接口与内置工具已经全部连通。
检查清单
- [ ] 已从官方渠道安装 Kelivo
- [ ] 供应商类型为
OpenAI - [ ] API Base URL 为
https://api.quietdogapi.com/v1（含/v1，无多余后缀） - [ ] API Key 粘贴正确，无空格与换行
- [ ] 是否启用已打开，多 Key 模式已关闭
- [ ] 需要出图时，Response API 已打开
- [ ] 模型来自"刷新"结果，不是手填的
- [ ] 目标模型的内置工具 → 图像生成已打开，并点了"确认"
- [ ] 已发送文字与出图两条测试消息
故障排查
按 API Key → 供应商配置 → 模型 → 内置工具 的顺序排查，一次只改一处。
获取模型失败 / 模型列表为空
- 用
curl直接请求/v1/models，确认返回200； - 检查 Base URL 是否恰好为
https://api.quietdogapi.com/v1； - 重新粘贴 API Key，确认没有多余字符；
- 确认 Key 处于活跃状态，且所属分组包含可用模型；
- 临时关闭设置里的网络代理再试。
返回 401 / 403
- Key 无效、已停用、额度不足或超出有效期；
- Key 的 IP 白名单没有包含当前网络；
- 误把其他服务商的 Key 填进了这个供应商。
返回 404
先核对这两项：
text
API Base URL: https://api.quietdogapi.com/v1
Response API: 按通道支持情况开或关/v1/models 成功但对话报 404，通常是接口路径不匹配：打开 Response API 后 404，说明该通道未开放 Responses API，关掉它改走对话接口；关闭 Response API 仍 404，检查 Base URL 是否少了 /v1 或多了后缀。
图像生成开关打不开或无效果
- 确认供应商配置页的 Response API 已打开；
- 确认是在目标模型的编辑弹窗里打开的，且点过"确认"；
- 确认该模型本身支持出图（部分纯文本模型不支持）；
- 确认服务方通道开放了 Responses 的内置工具能力——这一项客户端无法绕过，需要向服务方确认。
能连通但回复很慢或中断
- 检查设置里的网络代理配置；
- 换用同分组的其他模型对比，判断是通道问题还是模型问题；
- 长上下文会话先新建一个空会话再测。
想恢复到干净状态
回到供应商详情页，把 是否启用 关掉即可停用该配置而不删除。要彻底重来，删除该供应商后重新按第 5 步添加。
反馈问题时
提供操作系统与 Kelivo 版本、供应商类型、Base URL、HTTP 状态码、模型 ID、Response API 与图像生成的开关状态，以及错误消息。API Key 只展示末尾 4 位，任何截图与日志发出前先脱敏。
相关文档
- 还没有 Key？先看 创建 API 密钥
- 想在桌面版 ChatGPT / Codex 里接入？看 ChatGPT 桌面版配置