# Chatbox

Chatbox поддерживает пользовательских OpenAI-API-compatible провайдеров. Заполните host и ключ, затем добавьте нужные модели.

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

Проверено на версии Chatbox 1.23

## Добавьте провайдера

1. Откройте **Settings** → **Model Provider** и нажмите **Add** внизу.

2. Введите название и выберите **OpenAI API Compatible** в поле **API Mode**.

3. Заполните ключ и адрес, как показано в таблице.

4. Убедитесь, что строка **Preview** под полями показывает полный адрес эндпоинта (см. ниже таблицы).

| Поле | Что вписать |
| --- | --- |
| **API Mode** | OpenAI API Compatible |
| **API Key** | Ваш API-ключ NezhaGate |
| **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 прямо из браузера, а 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**

Проверьте, что ключ скопирован полностью, без лишних пробелов, и что баланса хватает; в веб-версии также включите Improve Network Compatibility.