# Chatbox

Chatbox 支持自定义的「OpenAI API 兼容」服务商。填好 Host 和 Key，再添加要用的模型。

> https://nezhagate.com/docs/integrations/chatbox

按此版本编写：Chatbox 1.23

## 添加服务商

1. 打开 **Settings** → **Model Provider**，点底部的 **Add**。

2. 输入名称，**API Mode** 选 **OpenAI API Compatible**。

3. 按下表填写 Key 和地址。

4. 确认字段下方 **Preview** 显示的是完整的接口地址（见表格下方）。

| 字段 | 填什么 |
| --- | --- |
| **API Mode** | OpenAI API Compatible |
| **API Key** | 你的 NezhaGate API Key |
| **API Host** | `https://nezhagate.com/v1` |
| **API Path** | 留空 |

Preview 应显示 `https://nezhagate.com/v1/chat/completions`。

## 添加模型

点 **Fetch** 拉取模型列表，或点 **New** 手动添加（例如 `gpt-5.5`）。只添加对话模型，并给每个模型勾上它支持的能力（图片输入、思考、工具调用）、填上上下文长度；没有设置的模型按纯文本处理。

## 测试

点 **Check**：Chatbox 会对选中的模型发几条很短的测试（文本、图片、工具），显示 Connection successful 即可。纯文本模型的图片和工具测试失败不影响使用。

## 网页版

网页版 Chatbox 从浏览器直接请求 API，而 NezhaGate 的接口不接受浏览器的跨域请求。请在服务商设置里打开 **Improve Network Compatibility**（请求会经 Chatbox 的服务器转发），或者使用桌面版、手机版。

## Claude（可选）

再添加一个服务商，**API Mode** 选 **Claude API Compatible**，**API Host** 填 `https://nezhagate.com/anthropic/v1`。

## 常见问题

**404：地址里出现了两次 /v1**

Host 已经带了 `/v1`，Path 就要留空，否则会拼成 `/v1/v1/chat/completions`。

**404：地址里没有 /v1**

Host 要写到 `/v1`，也就是 `https://nezhagate.com/v1`。

**Connection failed / Failed to fetch models**

检查 Key 是否复制完整、有没有多余的空格、余额是否充足；网页版还要打开 Improve Network Compatibility。