> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 在 ChatBox 中使用 APIMart

> 详细指导如何在 ChatBox 桌面客户端中配置和使用 APIMart API 服务，本指南将帮助您在 ChatBox 中配置 APIMart API，以便使用丰富的 AI 模型资源。

## 准备工作

在开始之前，请确保：

1. **已安装 ChatBox**\
   从 [ChatBox GitHub](https://github.com/Bin-Huang/chatbox) 下载并安装适合您操作系统的版本，或访问 [ChatBox 官网](https://chatboxai.app/)

2. **已获取 APIMart API 密钥**\
   登录 [APIMart 控制台](https://apimart.ai/keys) 获取您的 API 密钥（以 `sk-` 开头）

<Note>**提示：** 如果还没有 APIMart 账户，请先在 [APIMart](https://apimart.ai) 注册并获取 API 密钥。</Note>

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

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

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

<Frame>
  <img src="https://mintcdn.com/apicore/60dm1rHMQir4d9rs/images/integrations/chatbox/main-interface.png?fit=max&auto=format&n=60dm1rHMQir4d9rs&q=85&s=97330aedf8be26446c3a8d9e4386f0bd" alt="ChatBox 启动配置向导" width="1023" height="768" data-path="images/integrations/chatbox/main-interface.png" />
</Frame>

<caption>*ChatBox 配置向导，选择使用自己的 API Key*</caption>

## 第二步：配置 APIMart API

### 2.1 选择 AI 模型提供商

在设置页面中：

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

<Frame>
  <img src="https://mintcdn.com/apicore/60dm1rHMQir4d9rs/images/integrations/chatbox/settings-page.png?fit=max&auto=format&n=60dm1rHMQir4d9rs&q=85&s=f53a32eb9ce38bd30aa3d631a6582a88" alt="ChatBox 设置页面" width="1023" height="768" data-path="images/integrations/chatbox/settings-page.png" />
</Frame>

<caption>*ChatBox 设置页面，选择 OpenAI API 作为提供商*</caption>

### 2.2 配置 API 信息

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

| 配置项                           | 填写内容                                 |
| ----------------------------- | ------------------------------------ |
| **API Key**                   | 您的 APIMart API 密钥（`sk-xxxxxxxxxxxx`） |
| **API Host** 或 **API Domain** | `https://api.apimart.ai`             |

<Frame>
  <img src="https://mintcdn.com/apicore/60dm1rHMQir4d9rs/images/integrations/chatbox/api-config.png?fit=max&auto=format&n=60dm1rHMQir4d9rs&q=85&s=8fe2f0c256c2f0db5ee3a5226b833509" alt="API 配置" width="1023" height="768" data-path="images/integrations/chatbox/api-config.png" />
</Frame>

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

| 配置项                           | 填写内容                                 |
| ----------------------------- | ------------------------------------ |
| **API Key**                   | 您的 APIMart API 密钥（`sk-xxxxxxxxxxxx`） |
| **API Host** 或 **API Domain** | `https://api.apimart.ai/v1`          |

<Frame>
  <img src="https://mintcdn.com/apicore/BIebF3Cd34siboYG/images/integrations/chatbox/claude.png?fit=max&auto=format&n=BIebF3Cd34siboYG&q=85&s=cbe2d868a9b163e2429ededba1bc7586" alt="claude模型" width="1023" height="768" data-path="images/integrations/chatbox/claude.png" />
</Frame>

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

| 配置项                           | 填写内容                                 |
| ----------------------------- | ------------------------------------ |
| **API Key**                   | 您的 APIMart API 密钥（`sk-xxxxxxxxxxxx`） |
| **API Host** 或 **API Domain** | `https://api.apimart.ai/`            |

<caption>*填写 APIMart 的 API Key 和 API Host*</caption>

<Frame>
  <img src="https://mintcdn.com/apicore/BIebF3Cd34siboYG/images/integrations/chatbox/Gemini.png?fit=max&auto=format&n=BIebF3Cd34siboYG&q=85&s=779122ac703c90f3ed009aa8dae47370" alt="Gemini" width="1023" height="768" data-path="images/integrations/chatbox/Gemini.png" />
</Frame>

<Warning>
  **重要提示：** - 使用 OpenAI API 时，API Host 应填写 `https://api.apimart.ai`（不包含 `/v1` 后缀） - 使用 Claude API 时，API Host 应填写 `https://api.apimart.ai/v1`（包含 `/v1`
  后缀） - 使用 Gemini API 时，API Host 应填写 `https://api.apimart.ai/`（不包含 `/v1` 后缀） - API Key 必须是从 APIMart 控制台获取的以 `sk-` 开头的密钥 - 确保您的 API
  密钥有足够的余额
</Warning>

### 2.3 选择模型

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

**推荐模型：**

| 模型名称              | 模型 ID                          | 特点       |
| ----------------- | ------------------------------ | -------- |
| GPT-5             | `gpt-5`                        | 最新最强大的模型 |
| GPT-4o            | `gpt-4o` 或 `chatgpt-4o-latest` | 高质量对话    |
| GPT-4o Mini       | `gpt-4o-mini`                  | 快速且经济    |
| Claude Sonnet 4.5 | `claude-sonnet-4-5-20250929`   | 擅长代码和推理  |
| Claude Haiku 4.5  | `claude-haiku-4-5-20251001`    | 快速响应     |
| Gemini 2.0 Flash  | `gemini-2.0-flash-exp`         | 多模态支持    |

<Warning>
  **使用 Claude 模型的特殊说明：**

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

  1. **切换到 Claude API 提供商**：
     * 在设置中将 **AI 模型提供商** 改为 **Claude API**
     * API Host 保持填写 `https://api.apimart.ai/v1`
     * API Key 使用您的 APIMart API 密钥（`sk-xxxxxxxxxxxx`）

  2. **或者添加自定义请求头**（如果使用 OpenAI API 提供商）：
     * 某些版本的 ChatBox 支持添加自定义 Headers
     * 在高级设置中添加请求头：`anthropic-version: 2023-06-01`

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

<caption>*从模型列表中选择您需要使用的 AI 模型*</caption>

<Tip>
  **性能建议：** - 💰 **高性价比：** `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`
</Tip>

## 第三步：开始使用

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

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

<Frame>
  <img src="https://mintcdn.com/apicore/60dm1rHMQir4d9rs/images/integrations/chatbox/chat-interface.png?fit=max&auto=format&n=60dm1rHMQir4d9rs&q=85&s=3bdd5a9f07e4d0610520c71d0ff2d599" alt="对话界面" width="1023" height="768" data-path="images/integrations/chatbox/chat-interface.png" />
</Frame>

<caption>*ChatBox 对话界面，开始与 AI 交流*</caption>

### 调整模型参数（可选）

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

| 参数              | 说明      | 推荐值              |
| --------------- | ------- | ---------------- |
| **Temperature** | 控制输出随机性 | 0.7（创意）/ 0.3（精确） |
| **Max Tokens**  | 最大输出长度  | 2000-4000        |
| **Top P**       | 核采样参数   | 0.9              |

## 高级功能

### 多会话管理

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

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

### 保存和导出对话

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

### 使用提示词模板

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

## 常见问题

### Q1: 无法连接到 APIMart 服务？

**解决方案：**

1. **检查 API Host**：
   * 确保填写的是 `https://api.apimart.ai`
   * 不要添加 `/v1` 或其他路径

2. **验证 API Key**：
   * 确认 API Key 正确且以 `sk-` 开头
   * 在 [APIMart 控制台](https://apimart.ai/keys) 检查密钥是否有效

3. **检查网络连接**：
   * 确保能够访问 `https://api.apimart.ai`
   * 如果在国内，可能需要配置代理

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

**解决方案：**

1. **手动输入模型名称**：
   * 在模型输入框中直接输入模型 ID
   * 例如：`gpt-4o`、`gpt-4o-mini`、`claude-sonnet-4-5-20250929`

2. **刷新模型列表**：
   * 重启 ChatBox 应用
   * 重新配置 API 信息

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

**常见错误及解决方案：**

| 错误信息                        | 原因            | 解决方法               |
| --------------------------- | ------------- | ------------------ |
| `401 Unauthorized`          | API Key 无效或过期 | 重新获取 API Key 并更新配置 |
| `429 Too Many Requests`     | 请求频率超限        | 稍等片刻后重试            |
| `500 Internal Server Error` | 服务器临时故障       | 等待几分钟后重试           |
| `insufficient_quota`        | 账户余额不足        | 前往控制台充值            |

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

登录 [APIMart 控制台](https://apimart.ai/overview) 查看：

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

### Q5: ChatBox 支持哪些平台？

ChatBox 支持多个平台：

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

## 使用技巧

### 1. 快捷键

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

| 快捷键                | 功能      |
| ------------------ | ------- |
| `Ctrl/Cmd + Enter` | 发送消息    |
| `Ctrl/Cmd + N`     | 新建对话    |
| `Ctrl/Cmd + K`     | 搜索对话    |
| `Ctrl/Cmd + ,`     | 打开设置    |
| `Ctrl/Cmd + /`     | 显示快捷键帮助 |

### 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 + APIMart，您可以：

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

## 支持与帮助

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

* 📚 [APIMart 文档中心](https://docs.apimart.ai)
* 📚 [ChatBox GitHub](https://github.com/Bin-Huang/chatbox)
* 💬 [Discord 社区](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @APIMart\_](https://x.com/APIMart_)
* 📧 技术支持：[zhihong@apimart.ai](mailto:zhihong@apimart.ai)

***

<Card title="开始使用 APIMart" icon="rocket" href="https://apimart.ai">
  立即注册 APIMart，获取您的 API 密钥，在 ChatBox 中开启 AI 之旅！
</Card>