Свой ключ нужен, если у вас уже есть доступ к модели у провайдера и вы хотите платить ему напрямую. Запросы по ключу идут через серверы WorkAI, но не списывают Ⓦ.

## Что даёт свой ключ

- Основной ход агента по вашему ключу не списывает Ⓦ. Баланс, тариф и дневной лимит WorkAI Free такой ход не блокируют.
- Платить за токены вы будете провайдеру по его тарифам.
- Модель провайдера появляется в списке моделей чата рядом с моделями платформы.

## Какие провайдеры можно подключить

- OpenAI
- Anthropic
- xAI
- Другой провайдер, совместимый с OpenAI: вы сами указываете адрес сервиса. Так подключаются, например, OpenRouter и Kimi.

Список в настройках зависит от того, какие провайдеры сейчас включены в WorkAI, и может быть шире.

## Как подключить

1. Откройте настройки WorkAI → «Модели» → «API ключи провайдеров».
2. Выберите провайдера. Ссылка «Где взять ключ» ведёт на страницу выдачи ключа у провайдера.
3. Вставьте ключ и нажмите «Сохранить». WorkAI проверяет ключ у провайдера; пока идёт проверка, на кнопке написано «Проверяем…».
4. Статус «Подключён» значит, что ключ прошёл проверку. «Не проверен» — ключ сохранён, но проверку не прошёл. Если чат идёт по этому ключу, ход не отправится, пока ключ не пройдёт проверку: WorkAI не переводит его молча на платный маршрут.
5. Кнопки рядом с ключом: «Проверить» — повторная проверка, «Заменить» — новый ключ вместо старого, «Отключить» — удалить ключ из аккаунта. Модели OpenAI, Anthropic и xAI останутся в списке и будут работать через WorkAI за Ⓦ; модели OpenAI-совместимого провайдера исчезнут — через WorkAI их не подключить.
6. Переключатель «Использовать ключ» выбирает маршрут. Включён: модели провайдера работают по вашему ключу. Выключен (статус «Выключен»): модели OpenAI, Anthropic и xAI работают через WorkAI и списывают Ⓦ.

После сохранения клиент показывает только первые 8 символов ключа.

## Как модель выглядит в списке моделей

Модели, подключённые по ключу, собраны в секции «Мои модели». Обычно у модели один пункт, а маршрут выбирает переключатель «Использовать ключ». Если у модели несколько маршрутов (например, несколько ключей одного провайдера), у каждого своя пометка:

| Пометка | Что значит |
|---|---|
| «Свой ключ · X» (X — название ключа) | Ход идёт по вашему ключу, Ⓦ не списываются |
| «Через WorkAI · Ⓦ» | Ход идёт через платформу и списывает Ⓦ |

Если чат идёт по вашему ключу, а ключ перестал проходить проверку, ход не отправляется: иначе он ушёл бы через WorkAI и списал Ⓦ без вашего ведома. В сообщении об ошибке есть кнопка «Открыть API ключи провайдеров». Исправьте ключ или выключите переключатель «Использовать ключ» — тогда ход пойдёт через WorkAI и спишет Ⓦ. Выключенный или удалённый ключ ход не блокирует: модели OpenAI, Anthropic и xAI работают через WorkAI.

## Что списывается и что нет

| Операция | Ⓦ |
|---|---|
| Основной ход агента по вашему ключу | не списываются |
| Сжатие длинной истории у OpenAI, xAI, Anthropic | не списываются: платную сводку WorkAI для этих провайдеров не делает |
| Сжатие длинной истории у провайдеров без собственного сжатия (OpenAI-совместимые сервисы) | списываются, если хватает баланса: сводку делает модель WorkAI; при нехватке Ⓦ сводку оплачивает платформа |
| Служебные вызовы: заголовок чата, оценка риска инструмента | не списываются: идут за счёт платформы |

Механика сводки описана в разделе «Сводка длинного разговора» на странице [Модели и цены](/docs/models-and-pricing).

## Где хранится ключ

Ключ уходит на сервер WorkAI и хранится там в зашифрованном виде (AES-256-GCM). Клиент ключ не хранит. «Свой ключ» не значит, что запрос минует WorkAI: текст запроса и фрагменты кода уходят к провайдеру через наши серверы. Подробнее — на странице [Приватность и данные](/docs/privacy).

## Другой провайдер, совместимый с OpenAI

В группе «Другой провайдер (OpenAI-совместимый)» нажмите «Добавить модель» и заполните поля:

| Поле | Что вводить |
|---|---|
| Название модели | идентификатор модели у провайдера, например `moonshotai/kimi-k2.6` |
| Base URL | адрес API провайдера |
| API-ключ | ключ провайдера |
| Подпись | название в списке моделей, необязательно |
| Окно контекста, токенов | размер контекста модели; если не указать, берётся 128000 |

Пример для OpenRouter: у него OpenAI-совместимый API, Base URL `https://openrouter.ai/api/v1`. Сверено 18.10.2026 по <https://openrouter.ai/docs/quickstart>. Название модели берите из каталога OpenRouter.

Ограничение: Base URL должен быть публичным адресом с `https`. Адреса `localhost`, loopback и частных сетей (`10.x`, `192.168.x`, `172.16–31.x`) сервер отклоняет, поэтому локальную Ollama напрямую подключить нельзя. Нужен публичный https-адрес с авторизацией, например прокси перед моделью.

## Частые ошибки

- **Провайдер отклонил ключ.** Ключ неверный, отозван или не имеет доступа к модели. Создайте новый ключ у провайдера и нажмите «Заменить».
- **Не указаны модель или Base URL.** Для OpenAI-совместимого провайдера оба поля обязательны.
- **Адрес не https.** Укажите адрес вида `https://...`.
- **Адрес в частной сети или localhost.** Такой адрес не принимается, см. ограничение выше.
- **Ход не отправился с сообщением о неработающем ключе.** Проверьте ключ кнопкой «Проверить» или выключите переключатель «Использовать ключ».