快速开始
下载安装
Chatbox AI 支持多平台安装：- 桌面版：Windows、macOS、Linux
- 移动版：iOS、Android
- 网页版：直接通过浏览器访问
配置 API易
步骤 1：打开设置
- 启动 Chatbox AI 应用
- 点击左下角的设置图标（⚙️）
- 进入”模型配置”界面
步骤 2：添加自定义提供商
- 在”模型提供商”部分点击 + 添加 按钮
-
填写提供商信息：
- 名称：API易（可自定义名称）
- API 模式：选择 OpenAI API 兼容
- API 密钥：输入您的 API易 密钥
- API 主机：
https://api.apiyi.com/v1 - API 路径：
/chat/completions（默认值）
-
高级配置（可选）：
- 启用”改善网络兼容性”选项（如图所示）
- 可配置图像生成专用端点
配置要点
- API 主机字段对应 Base URL，必须包含
/v1后缀 - API 路径字段用于指定具体的端点路径
- API 密钥可在 API易控制台 获取
- 配置完成后点击右下角的 + 新建 按钮添加模型
步骤 3：选择模型
配置完成后，在聊天界面可以选择以下模型：支持的模型
模型支持
Chatbox AI 通过 API易 支持多种主流 AI 模型，包括：- GPT 系列：GPT-5系列、GPT-4o、gpt-4.1、o3 等
- Claude 系列：Claude 4 Sonnet、Claude 3.5 Haiku 等
- Gemini 系列：Gemini 2.5 Pro、Gemini 2.5 Flash 等
- 特色模型：思维推理、视觉理解、代码生成专用模型
查看完整模型列表
详细的模型信息、定价和功能对比，请访问 模型信息页面
核心功能
多平台同步
Chatbox AI 的核心优势：- 本地存储：数据完全存储在本地，保护隐私
- 跨平台访问：在不同设备间切换使用
- 离线功能：部分功能支持离线使用
对话管理
智能对话功能：- 多轮对话上下文保持
- 对话历史搜索和管理
- 对话导出（Markdown、PDF）
- 提示词库和消息引用
文档处理
文档理解能力：- PDF、TXT、DOCX 文档上传
- 图片理解和分析
- LaTeX 和 Markdown 渲染
- 代码高亮和预览
图像生成
AI 图像创作：- 支持 DALL-E 系列模型图像生成
- 可配置专用图像生成端点
- 支持多种图像尺寸和风格
- 批量图像生成功能
- 在设置中添加图像生成专用提供商
- 使用标准
/images/generations端点 - 在聊天中直接描述图像需求
- 系统自动调用图像生成API
高级设置
参数调节：使用技巧
提示词优化
Chatbox AI 内置提示词库，您也可以创建自定义提示词：隐私保护
Chatbox AI 采用”隐私设计”理念：- 数据本地存储，不上传云端
- 支持自建 API 端点
- 可完全离线使用（配合本地模型）
高级配置
自定义 API 端点
除了基本的聊天功能，您还可以配置专用的图像生成端点：聊天完成端点配置
图像生成端点配置
方式一：使用专属 Image API端点选择建议
- 常规对话：使用
/chat/completions端点 - 逆向生成图片的模型，比如 sora_image：使用
/chat/completions端点 - 图像生成：优先使用
/images/generations标准端点 - 特殊需求：可使用
gpt-image-1或/v1/responses端点 - 在 Chatbox 中，“API路径”字段对应具体的端点路径
网络代理设置
如需使用代理访问：- 进入设置 > 网络配置
- 配置 HTTP/HTTPS 代理
- 设置代理认证（如需要）
快捷键设置
常用快捷键：Ctrl/Cmd + N：新建对话Ctrl/Cmd + T：切换模型Ctrl/Cmd + /：显示命令面板Ctrl/Cmd + K：快速搜索
移动端配置
iOS/Android 配置
移动端配置与桌面版相同：- 下载 Chatbox AI 移动应用
- 进入设置 > 模型配置
- 添加 API易 自定义提供商
- 配置相同的 API Base URL 和密钥
移动端特色功能
- 语音输入：支持语音转文字
- 相机集成：直接拍照进行图像分析
- 离线缓存：对话历史离线可用
- 推送通知：重要消息提醒
故障排除
常见问题
连接失败- 检查 API Base URL：
https://api.apiyi.com/v1 - 验证 API 密钥有效性
- 确认网络连接正常
- 等待模型列表自动刷新
- 手动点击”刷新模型”按钮
- 检查 API 密钥权限
- 尝试切换到更快的模型
- 检查网络延迟
- 减少上下文长度
日志调试
启用调试模式：- 设置 > 高级选项
- 开启”调试模式”
- 查看详细日志信息
数据备份
定期备份对话数据：- 设置 > 数据管理
- 导出对话历史
- 备份配置文件
最佳实践
性能优化
-
合理选择模型
- 简单任务用 gpt-4.1
- 复杂任务用 o3、gpt-5 系列
- 长文本用 Claude 4 、gemini-2.5-pro 系列
-
上下文管理
- 定期清理无用对话
- 合理设置上下文长度
- 使用对话分组功能
-
资源管理
- 监控 API 使用量
- 设置使用限额提醒
- 定期更新应用版本
安全建议
- 不要分享 API 密钥
- 定期更换密钥
- 使用强密码保护应用
- 谨慎处理敏感信息
团队协作
虽然 Chatbox AI 主要面向个人用户，但可以通过以下方式支持团队：- 共享提示词模板
- 导出对话记录分享
- 统一 API 配置标准
对比优势
vs 其他客户端
| 特性 | Chatbox AI | ChatGPT Web | 其他客户端 |
|---|---|---|---|
| 本地存储 | ✅ | ❌ | 部分支持 |
| 多平台 | ✅ | ❌ | 部分支持 |
| 自定义 API | ✅ | ❌ | ✅ |
| 离线功能 | ✅ | ❌ | ❌ |
| 隐私保护 | ✅ | ❌ | 不确定 |
选择 Chatbox AI 的理由
- 隐私优先：数据完全本地存储
- 灵活配置：支持多种 API 端点
- 跨平台：统一的使用体验
- 功能丰富：提示词库、文档处理等
- 持续更新：活跃的开发维护