Chatbox 接入中转站教程

Chatbox 是一个简洁高效的AI聊天客户端。本教程将指导您如何将Chatbox接入到您的中转站。

📋 系统要求

Windows 7+、macOS 10.12+、Linux (任何现代发行版)

至少 2GB RAM

50MB 可用存储空间

🚀 安装指南

🍎 macOS 安装

方法一：直接下载

访问 Chatbox GitHub Releases

下载 Chatbox-*-universal.dmg 文件

双击 .dmg 文件，将应用拖拽到 Applications 文件夹

在 Launchpad 中启动 Chatbox

方法二：使用 Homebrew

🪟 Windows 安装

方法一：安装包（推荐）

访问 Chatbox GitHub Releases

下载 Chatbox-Setup-*.exe 文件

双击运行安装程序，按照向导完成安装

方法二：便携版

下载 Chatbox-win32-x64.zip 文件

解压到任意文件夹

运行 Chatbox.exe 启动应用

方法三：使用 Winget

# 安装
winget install Bin-Huang.Chatbox

🐧 Linux 安装

Ubuntu/Debian 系统

RPM 系统 (CentOS/RHEL/Fedora)

AppImage 方式（通用）

Snap 安装

⚙️ 接入中转站配置

步骤1：打开设置

启动 Chatbox 后，点击右上角的设置图标（齿轮图标）进入设置页面。

快捷键：

macOS: Cmd + ,

Windows/Linux: Ctrl + ,

步骤2：配置API服务

在设置界面中找到 "API" 或 "服务配置" 选项：

配置项	值	说明
API 提供商	OpenAI API	选择兼容OpenAI的接口
API 地址	`https://bestapi.aqi.email/v1`	注意必须添加 `/v1` 后缀
API 密钥	`sk-your-token-here`	替换为您的实际令牌
默认模型	`claude-3-5-sonnet-20241022`	或其他可用模型

步骤3：获取配置信息

您需要准备两个重要的配置项：

配置项	说明	获取方式
API 密钥	API 认证令牌	注册后在 `API令牌` 页面点击 `添加令牌` 获得（以 `sk-` 开头）
API 基础URL	API 服务地址	使用 `https://bestapi.aqi.email/v1`

📝 创建令牌时的建议设置：
名称：随意命名
额度：设为无限额度
分组：选择合适的分组（不同分组支持不同模型）
其他选项：保持默认设置

步骤4：高级配置（可选）

如果 Chatbox 支持高级设置，您可以调整以下参数：

{
  "temperature": 0.7,
  "maxTokens": 4000,
  "topP": 1.0,
  "frequencyPenalty": 0,
  "presencePenalty": 0
}

步骤5：验证配置

配置完成后，点击 "保存" 或 "确定"

返回主界面

发送一条测试消息，如："你好，请介绍一下自己"

如果收到AI回复，说明配置成功

🎯 可用模型列表

配置完成后，您可以使用的具体模型和定价信息，请访问：

👉 查看完整模型列表和定价

该页面包含：

所有可用的AI模型

实时定价信息

模型性能对比

使用建议

❓ 常见问题解答

Q: Chatbox 显示网络错误？

A: 可能的解决方案：

确保API地址包含 /v1 后缀：https://bestapi.aqi.email/v1

检查API密钥是否以 sk- 开头

验证网络连接

尝试重启应用

Q: 无法发送消息？

A: 检查以下项目：

API密钥权限是否正确

选择的模型是否在当前分组中可用

账户余额是否充足

网络是否稳定

Q: macOS 下应用无法启动？

A: 执行以下命令：

然后在 系统偏好设置 → 安全性与隐私 → 通用 中允许应用运行。

Q: Linux 下缺少依赖？

A: 安装必要的依赖：

Ubuntu/Debian:

CentOS/RHEL:

Fedora:

Q: Windows 下安装被拦截？

A: 解决方案：

右键安装包，选择 "属性"

勾选 "解除锁定" 选项

或者在 Windows Defender 中添加排除项

Q: 对话记录丢失？

A: Chatbox 的对话记录默认保存在本地：

Windows: %APPDATA%\Chatbox

macOS: ~/Library/Application Support/Chatbox

Linux: ~/.config/Chatbox

如果需要备份，可以复制该文件夹。

Q: API配额不足？

A: 登录您的BestAPI管理界面检查：

账户余额

API调用限制

令牌权限设置

分组配置

Q: 响应速度慢？

A: 优化建议：

选择响应速度更快的模型（如 Claude 3.5 Haiku）

减少单次对话的长度

检查网络连接质量

尝试切换网络环境

Q: 模型切换无效？

A: 可能的原因：

当前分组不支持目标模型

需要在设置中更新默认模型

重启应用后重试

检查模型名称拼写

📌 注意事项

Chatbox 界面简洁，专注于对话体验

支持对话历史本地保存，隐私性好

请妥善保管API密钥，避免泄露

建议定期更新客户端到最新版本

不同分组支持的模型可能不同，请根据需要选择合适的分组

API地址必须包含 /v1 后缀

🔗 相关链接

Chatbox GitHub

BestAPI 官网

模型定价页面

💡 提示：如果您在配置过程中遇到问题，可以参考官方文档或联系技术支持。Chatbox 有活跃的社区，可以在GitHub Issues中寻求帮助。

Chatbox 接入中转站教程

📋 系统要求#

🚀 安装指南#

🍎 macOS 安装#

方法一：直接下载#

方法二：使用 Homebrew#

🪟 Windows 安装#

方法一：安装包（推荐）#

方法二：便携版#

方法三：使用 Winget#

🐧 Linux 安装#

Ubuntu/Debian 系统#

RPM 系统 (CentOS/RHEL/Fedora)#

AppImage 方式（通用）#

Snap 安装#

⚙️ 接入中转站配置#

步骤1：打开设置#

步骤2：配置API服务#

步骤3：获取配置信息#

步骤4：高级配置（可选）#

步骤5：验证配置#

🎯 可用模型列表#

❓ 常见问题解答#

Q: Chatbox 显示网络错误？#

Q: 无法发送消息？#

Q: macOS 下应用无法启动？#

Q: Linux 下缺少依赖？#

Q: Windows 下安装被拦截？#

Q: 对话记录丢失？#

Q: API配额不足？#

Q: 响应速度慢？#

Q: 模型切换无效？#

📌 注意事项#

🔗 相关链接#