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

# Chatbox 集成

> 在 Chatbox 中配置 APIAny.AI API Key、Base URL 和推荐模型。

[Chatbox](https://chatboxai.app/) 可以通过 OpenAI 兼容配置接入 APIAny.AI。完成配置后，你可以在同一个客户端中使用对话、推理、翻译和多模态模型。

## 准备工作

* 已安装 Chatbox。
* 已在 [APIAny.AI 控制台](https://apiany.ai/zh/dashboard/api-keys) 创建 API Key。
* 已准备一个要使用的模型 ID，例如 `gpt-5.4-mini` 或 `gpt-4o-mini`。

## 配置值

| 字段              | 填写内容                                                    |
| --------------- | ------------------------------------------------------- |
| OpenAI API Key  | 你的 APIAny.AI API Key                                    |
| OpenAI API Host | `https://apiany.ai/v1`                                  |
| Claude API Host | `https://apiany.ai/v1`                                  |
| Gemini API Host | `https://apiany.ai`                                     |
| 模型              | `gpt-5.4-mini`, `claude-sonnet-4-6`, `gemini-3.5-flash` |

## 配置步骤

1. 打开 Chatbox，进入设置页。
2. 选择 OpenAI API、Claude API 或 Gemini API 配置页。
3. 填写 API Key、API 主机和模型 ID。
4. 保存配置并发送一条测试消息。

## 推荐模型

| 模型 ID               | 适用场景                        |
| ------------------- | --------------------------- |
| `gpt-5.5`           | 适合复杂推理、编码和生产级工作流，优先推荐。      |
| `gpt-5.4`           | 适合高级对话、Agent 和通用生产任务。       |
| `gpt-5.4-mini`      | 速度、质量和成本均衡，适合日常高频使用。        |
| `gpt-4o-mini`       | 适合简单对话、翻译和轻量任务，速度快、成本低。     |
| `claude-sonnet-4-6` | 适合 Claude 兼容配置的长文本、写作和编码任务。 |
| `gemini-3.5-flash`  | 适合 Gemini 兼容配置的快速多模态任务。     |

## 操作截图

以下截图展示 Chatbox 中的关键配置入口和保存后的使用界面。截图中的 API 地址和名称均已按 APIAny.AI 调整。

### 步骤 1

<img src="https://mintcdn.com/lingquai/eZ1NTz-jNiJEB-x_/images/integrations/chatbox/main-interface.png?fit=max&auto=format&n=eZ1NTz-jNiJEB-x_&q=85&s=fdd14f6243f2618919b9259b6b8f0352" alt="Chatbox 配置截图 1" width="1023" height="768" data-path="images/integrations/chatbox/main-interface.png" />

### 步骤 2

<img src="https://mintcdn.com/lingquai/eZ1NTz-jNiJEB-x_/images/integrations/chatbox/settings-page.png?fit=max&auto=format&n=eZ1NTz-jNiJEB-x_&q=85&s=91ef08a7f7a09ed16e7db168ad1d68dd" alt="Chatbox 配置截图 2" width="1023" height="768" data-path="images/integrations/chatbox/settings-page.png" />

### 步骤 3

<img src="https://mintcdn.com/lingquai/eZ1NTz-jNiJEB-x_/images/integrations/chatbox/api-config.png?fit=max&auto=format&n=eZ1NTz-jNiJEB-x_&q=85&s=1a7b3fec4996854930dbbde2e1c039c3" alt="Chatbox 配置截图 3" width="1023" height="768" data-path="images/integrations/chatbox/api-config.png" />

### 步骤 4

<img src="https://mintcdn.com/lingquai/eZ1NTz-jNiJEB-x_/images/integrations/chatbox/claude.png?fit=max&auto=format&n=eZ1NTz-jNiJEB-x_&q=85&s=312a421a77fd83f81f00596cd0d5558a" alt="Chatbox 配置截图 4" width="1023" height="768" data-path="images/integrations/chatbox/claude.png" />

### 步骤 5

<img src="https://mintcdn.com/lingquai/eZ1NTz-jNiJEB-x_/images/integrations/chatbox/gemini.png?fit=max&auto=format&n=eZ1NTz-jNiJEB-x_&q=85&s=36983878ec9a1231196b3343011a3862" alt="Chatbox 配置截图 5" width="1023" height="768" data-path="images/integrations/chatbox/gemini.png" />

### 步骤 6

<img src="https://mintcdn.com/lingquai/eZ1NTz-jNiJEB-x_/images/integrations/chatbox/chat-interface.png?fit=max&auto=format&n=eZ1NTz-jNiJEB-x_&q=85&s=e3596fc09f5338461c7df9c340c6c900" alt="Chatbox 配置截图 6" width="1023" height="768" data-path="images/integrations/chatbox/chat-interface.png" />

## 常见问题

### 返回 401 或认证失败

确认 API Key 已完整复制，前后没有多余空格，并且已经在 APIAny.AI 控制台中启用。

### 模型无法选择或调用失败

手动输入模型 ID，并确认该模型在 [模型目录](/zh/models/chat-models) 中可用。不同工具可能不会自动拉取模型列表。

### Base URL 应该怎么填

OpenAI 兼容配置通常使用 `https://apiany.ai/v1`；Claude 兼容配置通常使用 `https://apiany.ai`；需要完整接口地址的工具使用 `https://apiany.ai/v1/chat/completions`。