Центр помощи

Подключение ИИ-провайдера

Пресеты, ключи, проверка подключения и как читать ошибки.

2 мин чтения

NovelKnow не привязана ни к одному поставщику моделей — вы используете собственный API-ключ, а какую модель выбрать и сколько это будет стоить, решаете сами.

Быстрый путь

Настройки ИИ → выберите пресет провайдера → вставьте ключ → проверьте подключение → сохраните.

Пресет заполняет базовый URL, модель по умолчанию и размер контекстного окна. Именно в этих трёх вещах чаще всего ошибаются, и обычно из-за них настройка не работает.

Встроенные пресеты: DeepSeek, OpenRouter, OpenAI, Kimi / Moonshot, Qwen / DashScope, SiliconFlow и локальный Ollama.

Подойдёт любая конечная точка, совместимая с OpenAI — выберите пользовательский вариант и введите базовый URL самостоятельно.

Списки моделей

После сохранения «Синхронизировать модели» загружает у провайдера актуальный список моделей. После этого выпадающие списки моделей заполняются из него, поэтому название модели не придётся вводить вручную.

Отмечайте те, которыми часто пользуетесь, как избранные — они будут подниматься наверх.

Как читать ошибки

Проверка подключения и ошибки генерации включают ответ самого провайдера, поэтому вы сможете различать такие случаи:

Ошибка содержитОбычно означает
401 / Incorrect API keyНеверный или просроченный ключ
404 / model does not existНазвание модели указано неверно, или у вашего аккаунта нет к ней доступа
429Сработало ограничение частоты запросов, или на аккаунте закончились средства
fetch failed / ECONNREFUSEDСервер не может связаться с провайдером — см. примечание о прокси ниже

Исходящий прокси

Если ваше развёртывание не может связаться с провайдером, включите исходящий прокси в диалоге настроек ИИ.

Этот адрес определяется с сервера развёртывания, а не с вашего компьютера. Указывать в нём 127.0.0.1:7890 имеет смысл, только если прокси запущен на самом сервере.

Как хранится ваш ключ

Ключи шифруются ключом, полученным из вашего аккаунта, и возвращаются в браузер только в замаскированном виде. Полный ключ вы больше никогда не увидите — чтобы изменить его, вставьте новый.

Мы используем аналитические cookie, чтобы видеть, какие страницы помогают авторам находить нас.

Никогда не касается вашей рукописи — страницы в рабочей области письма не отслеживаются. Политика конфиденциальности