常用应用集成教程
Chatbox 配置教程
学习如何将ZestAI API 集成到 Chatbox 中，桌面端与移动端畅享全部模型。
Chatbox 是一款开源的多平台 AI 对话客户端，支持 Windows、macOS、Linux、Android、iOS 以及网页版，内置对 OpenAI、Claude、Gemini 等主流协议的兼容。通过接入我们的 API，您可以在 Chatbox 中调用 ZestAI 提供的全部模型。
获取 API 凭证
在开始配置前，请确保：
下载与安装
前往 Chatbox 官方渠道下载对应平台的安装包：
- 官网：https://chatboxai.app
- GitHub Releases：https://github.com/Bin-Huang/chatbox/releases
- 网页版：https://web.chatboxai.app（无需安装，打开即用）
支持 Windows、macOS、Linux 三大桌面平台以及 Android / iOS 移动端，根据设备选择对应版本即可。
添加自定义模型提供商
安装完成并启动 Chatbox 后，通过以下步骤接入 ZestAI。
第一步：进入模型设置
点击左下角的设置按钮，进入「模型提供方」页面。
第二步：添加自定义提供方
- 在「模型提供方」的底部，点击「+ 添加」新建一个服务。
- 在弹出的对话框中填写以下信息：
| 配置项 | 值 |
|---|---|
| 名称 | 任意填写，例如 ZestAI |
| API 模式 | 选择 OpenAI API 兼容 |
第三步：填写 API 信息
在新建的 ZestAI 提供方详情中，填写以下信息：
| 配置项 | 值 |
|---|---|
| API 密钥 | 您在 ZestAI 平台创建的 sk- 开头令牌 |
| API 主机 | https://api.zestai.pro |
| API 路径 | 保持默认，不要填 |
| 改善网络兼容性 | 一般不需要开启 |
第四步：添加模型
点击 API 信息下方的「获取」按钮，Chatbox 会自动拉取 ZestAI 提供的可用模型，勾选您要使用的模型即可。
若遇到点击获取没有反应，可以点击新建，手动输入模型ID，模型 ID 请前往 模型广场 复制，确保与平台完全一致。您可以添加任意多个模型。
第五步：设置模型能力
- 点击模型右侧的「设置」图标，配置模型能力。
- 给模型勾选对应的能力，不同模型能力不同，例如gemini、claude模型均支持视觉、推理、工具使用，deepseek模型仅支持推理和工具使用，如果不了解模型能力，可以查看官方介绍或咨询客服。
第五步：开始对话
- 返回对话主界面，在右下角模型选择器中切换到刚刚添加的 ZestAI 模型。
- 输入对话内容，点击发送即可开始使用。
常见问题
Q：发送消息后没有返回 / 报错怎么办？
A：请依次排查：
- API 域名是否为
https://api.zestai.pro。 - 模型是否切换为你配置的 ZestAI 模型（如果配置了多个提供方，务必注意切换）。
- API 密钥是否复制完整。
- 账户是否有足够余额。
- 本地是否开启了代理/梯子，部分代理会干扰请求，可尝试关闭后重试。
Q：是否支持联网搜索？
A：可以，但Chatbox仅支持软件内置的搜索引擎，不支持如gemini的模型内置联网搜索。可以进入设置-联网搜索，选择Bing Search，或者自行配置第三方联网搜索API。