集成指南

准备工作

在开始之前，请确保：

1. 已安装 ChatBox

   从 ChatBox GitHub 下载并安装适合您操作系统的版本，或访问 ChatBox 官网

2. 已获取 MaiToken API 密钥

   登录 MaiToken 控制台 获取您的 API 密钥（以 sk- 开头）

提示： 如果还没有 MaiToken 账户，请先在 MaiToken 注册并获取 API 密钥。

第一步：启动 ChatBox 并开始配置

首次启动 ChatBox 或添加新的 AI 提供商时：

1. 启动 ChatBox 应用
2. 如果是首次使用，会自动弹出配置向导
3. 点击 “使用自己的 API Key 或本地模型” 按钮
4. 如果已经配置过，可以点击左下角的 ⚙️ 设置 图标，或使用快捷键 Ctrl+, (Windows/Linux) / Cmd+, (macOS)

第二步：配置 MaiToken API

2.1 选择 AI 模型提供商

在设置页面中：

1. 找到 AI 模型提供商 或 AI Provider 设置项
2. 在下拉菜单中选择 OpenAI API（使用 GPT 系列模型）、Claude API（使用 Claude 系列模型）或 Gemini API（使用 Gemini 系列模型）

2.2 配置 API 信息

选择 OpenAI API 后，填写以下配置信息：

选择 Claude API 后，填写以下配置信息：

选择 Gemini API 后，填写以下配置信息：

重要提示：

• 使用 OpenAI API 时，API Host 应填写 https://api.maitoken.com（不包含 /v1 后缀）
• 使用 Claude API 时，API Host 应填写 https://api.maitoken.com/v1（包含 /v1 后缀）
• 使用 Gemini API 时，API Host 应填写 https://api.maitoken.com/（不包含 /v1 后缀）
• API Key 必须是从 MaiToken 控制台获取的以 sk- 开头的密钥
• 确保您的 API 密钥有足够的余额

2.3 选择模型

配置完成后，在 模型 或 Model 下拉菜单中选择您要使用的模型：

推荐模型：

使用 Claude 模型的特殊说明： 如果您选择使用 Claude 模型（如 claude-sonnet-4-5-20250929 或 claude-haiku-4-5-20251001），需要进行以下额外配置：

1. 切换到 Claude API 提供商：
   • 在设置中将 AI 模型提供商 改为 Claude API
   • API Host 保持填写 https://api.maitoken.com/v1
   • API Key 使用您的 MaiToken API 密钥（sk-xxxxxxxxxxxx）
2. 或者添加自定义请求头（如果使用 OpenAI API 提供商）：
   • 某些版本的 ChatBox 支持添加自定义 Headers
   • 在高级设置中添加请求头：anthropic-version: 2023-06-01

推荐方式： 使用 GPT 系列模型时选择 OpenAI API，使用 Claude 系列模型时选择 Claude API，使用 Gemini 系列模型时选择 Gemini API。

性能建议：

• 💰 高性价比： gpt-4o-mini、claude-haiku-4-5-20251001
• 🚀 高性能： gpt-5、gpt-4o、claude-sonnet-4-5-20250929
• ⚡ 快速响应： gemini-2.0-flash-exp、gpt-4o-mini

第三步：开始使用

配置完成后，您就可以开始使用 ChatBox 与 AI 对话了：

1. 返回主界面
2. 在输入框中输入您的问题或需求
3. 按 Enter 或点击发送按钮
4. AI 将使用 MaiToken 的模型为您生成回复

调整模型参数（可选）

您可以根据需要调整以下参数：

高级功能

多会话管理

ChatBox 支持创建多个对话会话：

1. 点击 新建对话 按钮
2. 可以为不同的任务创建独立的会话
3. 在左侧会话列表中切换不同的对话

保存和导出对话

1. 右键点击对话会话
2. 选择 导出 选项
3. 可以导出为 Markdown、JSON 等格式

使用提示词模板

1. 在设置中找到 提示词 或 Prompts 设置
2. 可以保存常用的提示词模板
3. 在对话中快速调用预设的提示词

常见问题

Q1: 无法连接到 MaiToken 服务？

解决方案：

1. 检查 API Host：
   • 确保填写的是 https://api.maitoken.com
   • 不要添加 /v1 或其他路径
2. 验证 API Key：
   • 确认 API Key 正确且以 sk- 开头
   • 在 MaiToken 控制台 检查密钥是否有效
3. 检查网络连接：
   • 确保能够访问 https://api.maitoken.com
   • 如果在国内，可能需要配置代理

Q2: 模型列表中没有显示 MaiToken 的模型？

解决方案：

1. 手动输入模型名称：
   • 在模型输入框中直接输入模型 ID
   • 例如：gpt-4o、gpt-4o-mini、claude-sonnet-4-5-20250929
2. 刷新模型列表：
   • 重启 ChatBox 应用
   • 重新配置 API 信息

Q3: 对话时出现错误提示？

常见错误及解决方案：

Q4: 如何查看 API 使用情况和费用？

登录 MaiToken 控制台 查看：

• 📊 API 调用统计
• 💰 费用明细
• 📈 使用趋势图表
• 🔍 详细的请求日志

Q5: ChatBox 支持哪些平台？

ChatBox 支持多个平台：

• 🪟 Windows - Windows 10/11
• 🍎 macOS - macOS 10.15+
• 🐧 Linux - 各主流发行版
• 🌐 Web - 浏览器版本

使用技巧

1. 快捷键

充分利用 ChatBox 的快捷键提升效率：

2. 优化提示词

编写更好的提示词以获得更好的回复：

❌ 不好的提示：

帮我写代码

✅ 好的提示：

请帮我用 Python 编写一个函数，实现以下功能：1. 接收一个字符串列表作为输入2. 过滤掉长度小于 3 的字符串3. 返回按字母顺序排序的结果请包含详细注释和示例用法

3. 利用对话历史

ChatBox 会保存对话历史：

• AI 会记住当前会话中的上下文
• 可以基于之前的回答继续提问
• 适合进行深入的探讨和迭代

4. 切换模型

根据不同任务切换合适的模型：

• 写作任务 - 使用 gpt-4o 或 claude-sonnet-4-5
• 代码任务 - 使用 claude-sonnet-4-5
• 快速问答 - 使用 gpt-4o-mini
• 多模态 - 使用 gemini-2.0-flash-exp

功能特性

使用 ChatBox + MaiToken，您可以：

• 💬 流畅对话 - 实时流式输出，体验更流畅
• 🎯 多会话管理 - 同时管理多个独立对话
• 💾 本地存储 - 对话记录保存在本地，保护隐私
• 📤 导出对话 - 支持多种格式导出对话记录
• 🎨 界面简洁 - 简洁美观的用户界面
• 🔒 开源免费 - 完全开源，免费使用
• 🌍 跨平台 - 支持 Windows、macOS、Linux
• 🚀 性能优秀 - 轻量级应用，运行流畅

支持与帮助

如果您在使用过程中遇到任何问题：

• 📚 MaiToken 文档中心
• 📚 ChatBox GitHub