ИИ-модели: модель сервиса или своя
Чем модель Website Director отличается от своей, как подключить OpenAI, DeepSeek, YandexGPT, Anthropic или модель на своём сервере и что делать, если проверка не проходит.
ИИ-модели: модель сервиса или своя
Модель нужна кабинету для разбора — сейчас это приём обращений из чата Битрикс24, см. Битрикс24: обращения из чата с разбором ИИ. Выбрать можно одно из двух.
| Модель Website Director | Своя модель | |
|---|---|---|
| Ключ | не нужен | ваш ключ поставщика или ваш сервер |
| Кто платит поставщику | мы | вы |
| Как подключается | отдельно, по договорённости: лимит запросов в месяц | сами, на странице «ИИ-модели» |
| Куда уходит текст | поставщику модели сервиса | выбранному вами поставщику или на ваш сервер |
#Модель Website Director
Работает на нашей стороне, ключ не нужен. Подключается к кабинету отдельно — напишите нам, и мы включим лимит запросов в месяц.
- Один запрос — один разбор пачки сообщений чата, до восьми серий за раз.
- Расход за месяц виден на странице Ещё → ИИ-модели.
- Лимит исчерпан — разбор останавливается до первого числа. Через 20 минут бот заведёт ожидающие просьбы без разбора, а приём можно переключить на свою модель.
#Подключить свою модель
- Откройте Ещё → ИИ-модели.
- В блоке Подключить свою модель выберите поставщика — адрес и пример модели подставятся сами.
- При необходимости поправьте модель и впишите ключ API.
- Нажмите Подключить, затем Проверить: модель должна ответить за несколько секунд.
- В разделе Обращения из чата откройте чат, вкладку Настройки, и выберите эту модель в блоке «Кто решает, что это просьба».
#Поставщики
| Поставщик | Адрес API | Пример модели | Где взять ключ |
|---|---|---|---|
| OpenAI | https://api.openai.com/v1 |
gpt-4o-mini |
platform.openai.com → API keys |
| DeepSeek | https://api.deepseek.com |
deepseek-chat |
platform.deepseek.com |
| OpenRouter | https://openrouter.ai/api/v1 |
deepseek/deepseek-chat |
openrouter.ai → Keys |
| YandexGPT | https://llm.api.cloud.yandex.net/v1 |
gpt://<id каталога>/yandexgpt-lite/latest |
ключ API сервисного аккаунта с ролью ai.languageModels.user |
| Anthropic (Claude) | https://api.anthropic.com |
claude-opus-5 |
console.anthropic.com |
| Другой, совместимый с OpenAI | адрес до /chat/completions |
— | у поставщика |
Для YandexGPT способ передачи ключа по умолчанию — Api-Key. Если проверка не проходит, в Тонких настройках выберите Bearer.
Запросы к модели идут с нашего сервера в России. Если поставщик ограничивает доступ по стране, проверка покажет ошибку доступа.
#Своя модель на своём сервере
Подходят Ollama, LM Studio, vLLM, LocalAI — любой сервер с API, совместимым с OpenAI (адрес вида …/v1/chat/completions).
- Адрес должен быть доступен из интернета: наш сервер обращается к модели сам. Адреса внутренних сетей (
192.168.…,10.…,localhost) не принимаются. - Ключ по http не отправляется. Если модель защищена ключом, поставьте её за https — например, за nginx или Caddy с сертификатом.
- Порты почты, баз данных и удалённого входа (22, 25, 3306, 5432, 6379 и другие) не принимаются: модели на них не бывает.
- Ollama: адрес
http://ваш-сервер:11434/v1, модель — как вollama list, напримерqwen2.5:14b. По умолчанию Ollama слушает только локальный адрес: откройте её для сети переменнойOLLAMA_HOST=0.0.0.0и ограничьте доступ файрволом. - Размер модели. Маленькие модели чаще путают просьбу с разговором. Начните приём в режиме наблюдения и посмотрите на решения.
#Тонкие настройки
- Протокол — для поставщика «Другой».
- Как передавать ключ —
Authorization: Bearer(почти все поставщики) илиApi-Key(Yandex Cloud). - Ждать ответа — от 10 до 300 секунд, по умолчанию 90.
- Режим JSON — просить у модели ответ строго в JSON. Если сервер его не поддерживает, запрос сам повторится без него.
#Данные и безопасность
- Ключ хранится зашифрованным и после сохранения не показывается.
- Подключать модели может только владелец кабинета.
- Текст сообщений уходит выбранному поставщику. Если в переписке бывают персональные данные клиентов, выбирайте поставщика с учётом требований к их хранению — или свою модель.
- Расход каждой модели за месяц — запросы, ошибки, токены — виден на странице «ИИ-модели».
#Если проверка не проходит
| Ошибка | Причина | Что делать |
|---|---|---|
| «Ключ не принят поставщиком (код 401 или 403)» | Неверный или отозванный ключ, не тот способ передачи, доступ закрыт по стране | Впишите ключ заново; для Yandex Cloud попробуйте другой способ передачи |
| «У поставщика не оплачен счёт» | Кончились деньги на счёте поставщика | Пополните счёт |
| «Адрес или модель не найдены (код 404)» | Опечатка в адресе или имени модели | Сверьте адрес (до /chat/completions) и имя модели |
| «Поставщик просит сбавить темп» (код 429) | Лимит запросов у поставщика | Подождите или повысьте лимит у поставщика |
| «Не разрешается в публичный адрес» | Адрес во внутренней сети | Откройте модель в интернет |
| «Ключ нельзя отправлять по http» | Адрес на http, а ключ задан | Поставьте модель за https или уберите ключ |
| «Адрес модели отвечает переадресацией» | Указан не конечный адрес | Укажите адрес, на который ведёт переадресация |
| «Модель ответила не в том формате» | Модель не держит формат JSON | Включите режим JSON или возьмите модель крупнее |