主题
【四端】Kelivo 新手教程
💡 快速说明
这篇教程只解决一件事：把 Kelivo 在手机或电脑上接好爱次元，并顺利开始第一次对话。新手按顺序做，熟手直接看「参数速查」和「成功判断」即可。
📦 四端通用教程
先装好 Kelivo
再填好参数并获取模型
Kelivo 的四端配置逻辑基本一致：下载安装、添加爱次元、填写 API 密钥和 Base URL、获取模型、回到首页开始聊天。整篇就按这条主线写，不需要来回跳。
🧰 开始前先准备什么
🔑 准备好 API 密钥
先打开 爱次元令牌管理，复制你要使用的 API 密钥。后面配置时直接粘贴，不要手打。
🌍 先记住 Base URL
这篇文档统一使用 https://api.aicy.pro/v1。配置时直接填写这一条即可。
📌 先跑通基础聊天就够了
第一次配置时，先不要一上来研究太多高级选项。先把模型获取和第一次对话跑通，后面再慢慢调细节。
⚡ 参数速查表
第一次配置时，最容易卡住的就是这几个参数。先看这一段，再往下操作会更顺。
| 配置项 | 填写内容 |
|---|---|
| 名称 | 爱次元 |
| API 密钥 | 你在爱次元后台复制出来的密钥 |
| Base URL | https://api.aicy.pro/v1 |
最容易填错的地方
API 密钥：填你复制出来的密钥，不是账号密码Base URL：填接口地址，不要填成官网首页或其他后台页面链接获取成功后，还要记得把要用的模型点+加进去
先记住主流程
下载并安装 Kelivo → 进入设置里的供应商 → 添加爱次元并填写参数 → 获取并添加模型 → 回到首页开始聊天
手机端和电脑端的主要区别，只是按钮位置略有不同，配置逻辑是一样的。
🪜 按这 6 步完成配置
1
打开 Kelivo
先完成安装并启动 Kelivo。第一次使用时，不需要先研究别的选项，直接进入设置即可。
2
进入设置，找到「供应商」
手机端一般先打开侧边栏再进入设置；电脑端通常可以直接从左下角进入设置。找到 供应商 后，点击 添加。
3
新建一个爱次元配置
名称填写 爱次元。这一步的目的只是创建一个新的供应商入口，后面再把关键参数填进去。
4
填写 API 密钥和 Base URL
把你在 爱次元令牌管理 里复制出来的 API 密钥粘贴进去，再填写 Base URL：https://api.aicy.pro/v1。
5
点击「获取」，再把要用的模型添加进去
点 获取 后，模型列表应该会加载出来。找到你要用的模型，点击右侧 + 添加。只看到模型列表还不算完成，记得真正加进去。
6
回到首页，切换模型并发第一条消息
返回聊天首页，选中刚刚添加的模型，先发一句简单的话测试，例如：你好。如果能正常返回内容，就说明已经接好了。
📱 手机端入口示意（iPhone / Android）
iPhone 和 Android 的流程基本一样，主要区别只是按钮位置略有差异。下面只保留最关键的入口截图，避免你被太多图文打乱节奏。
展开查看手机端截图说明
1. 进入设置和供应商
打开左侧边栏，进入 设置，找到 供应商。
2. 添加新的供应商
点击右上角添加按钮，名称填写 爱次元，然后进入刚创建的供应商。
3. 填写 API 密钥并获取模型
把 API 密钥粘贴进去，填好 Base URL，然后进入模型页点击 获取，再把要用的模型点 + 添加。
4. 返回首页切换模型
模型添加完成后，回到首页，切换到刚刚添加的模型，就可以开始使用了。
💻 电脑端入口示意（Windows / macOS）
Windows 和 macOS 的配置逻辑也是一样的。电脑端通常只是入口更直观一些。
展开查看电脑端截图说明
1. 安装并打开 Kelivo
双击安装包，按提示完成安装，然后打开 Kelivo。
2. 进入设置和供应商
打开软件后，点击左下角的 设置，再进入 供应商 页面。
3. 添加爱次元并填写参数
点击 添加，名称填写 爱次元，再填入 API 密钥和对应的 Base URL。
4. 获取模型并添加到可用列表
进入刚创建的供应商后点击 获取，在列表里把要用的模型点 + 添加进去。
5. 回到首页选择模型并开始聊天
回到首页后切换到刚刚添加的模型，发出第一条消息做测试。
✅ 怎么判断已经配置成功
📃 点击「获取」后能看到模型列表
这说明 API 密钥和 Base URL 基本填写正确，Kelivo 已经能拿到服务端返回的模型信息。
➕ 你常用的模型已经成功添加
只看到列表还不够，你要把准备使用的模型真正点 + 加入可用列表。
🔄 首页能切换到刚刚添加的模型
回到聊天首页后，如果能选中刚添加的模型，说明客户端侧配置已经基本完成。
💬 发一条消息能正常返回内容
例如发一句 你好，如果能稳定返回结果，就说明这次配置已经真正跑通了。
❓ 常见问题
点了「获取」却没有模型，怎么办？
优先检查 3 件事：API 密钥有没有复制完整、Base URL 有没有填对、保存后有没有重新点击「获取」。
我已经填好了，为什么还是连不上？
先重新复制一次 API 密钥，再检查 Base URL 是否仍是 https://api.aicy.pro/v1。如果都没问题，建议保存后重新进入该供应商，再点一次「获取」测试。
模型已经获取到了，首页却选不到？
通常是因为你只看到了模型列表，但没有点击右侧 + 把模型加入可用列表。记得先添加，再回首页切换。
手机端和电脑端要分开配两套吗？
配置逻辑是一样的，但每个设备上的 Kelivo 都需要各自填写一次参数。你可以理解为“同一套参数，分别在不同设备里配置”。
为什么不能读文件、识别图片，或者调用更多能力？
通常不是 Kelivo 本身有问题，而是你当前选择的模型能力没有打开，或者模型本身不支持这些能力。
建议你这样检查：
- 先确认你已经把目标模型点
+添加进可用列表 - 在模型列表里找到该模型，点击右侧的设置按钮
- 进入模型编辑页后，检查需要的能力有没有打开
- 确认后保存，再回到对话页重新测试
你重点看下面这些开关：
- 输入模式：
文本、图片 - 输出模式：
文本、图片 - 能力：
工具、推理
如果你想识别图片，通常至少要确认模型支持图片输入；如果你想读文件、调用工具类能力，通常还要检查对应能力是否已经打开。
最后给新手一句建议
第一次用 Kelivo，不要一上来就折腾太多高级选项。先把第一次对话跑通，再慢慢熟悉别的功能，效率最高，也最不容易乱。
下载安装 → 添加爱次元 → 填写 API 密钥和 Base URL → 获取模型 → 开始聊天