# Chatbox с OpenCheese

> Подключите OpenCheese к Chatbox на телефоне или компьютере: провайдер, совместимый с OpenAI API, хост и путь API, API-ключ, модели и проверка подключения.
>
> Веб-страница: https://opencheese.dev/ru/docs/chatbox/ · Все страницы документации: https://opencheese.dev/ru/docs.md

[Chatbox](https://chatboxai.app) работает на Android, iOS, Windows, macOS и Linux и подключается к
OpenCheese как пользовательский провайдер в формате OpenAI. Настройка одинакова во всех версиях.

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

1. Откройте **Настройки** (Settings) на боковой панели, затем **Провайдер моделей** (Model Provider).
2. Нажмите **Добавить** (Add) внизу списка провайдеров.
3. Задайте имя (например, `OpenCheese`) и выберите режим API **Совместимо с OpenAI API**
   (OpenAI API Compatible).
4. Заполните поля:

| Поле | Значение |
| --- | --- |
| API Key | ваш API-ключ OpenCheese |
| Хост API (API Host) | `https://api.opencheese.dev/v1` |
| Путь API (API Path) | пусто (Chatbox использует `/chat/completions`) |

5. Добавьте хотя бы одну модель: получите список или введите ID модели из
   [`/v1/models`](https://opencheese.dev/ru/docs/models.md). Отметьте возможности модели, например **Зрение** (Vision) или
   **Использование инструментов** (Tool use), в соответствии с её `modalities` и `capabilities`;
   модель без отмеченных возможностей считается чисто текстовой.
6. Сохраните и нажмите **Проверить** (Check): проверка должна сообщить об успешном подключении.

Если путь оставлен пустым, Chatbox добавляет `/v1`, когда в хосте его нет, поэтому
`https://api.opencheese.dev` тоже подойдёт.

## Работа с OpenCheese

Начните новый разговор и выберите модель OpenCheese в списке моделей. Для изображений
используйте модель изображений через [API изображений](https://opencheese.dev/ru/docs/images.md) или страницу
**AI Изображения** в панели.

## Расход

Каждый запрос отображается в панели на странице **Транзакции**. Chatbox не сообщает шлюзу, к какому
разговору относится запрос, поэтому пока каждый запрос показывается как отдельная сессия.

## Решение проблем

Чтобы исключить проблему в приложении, проверьте ключ и ID моделей с компьютера:

```bash
curl -s https://api.opencheese.dev/v1/models \
  -H "Authorization: Bearer $OPENCHEESE_API_KEY" | jq -r '.data[].id'
```

- **«Invalid or disabled OpenCheese API key»**: ключ скопирован не полностью или отключён на
  странице **API-ключи**.
- **Модель не найдена**: ID моделей должны совпадать в точности; копируйте их из `/v1/models`.
- **Вместо API отвечает сайт**: хост должен быть `api.opencheese.dev`, а не `opencheese.dev`.