Содержание
Как подключить DeepSeek к n8n: пошаговая инструкция
Черновик готовит редакция с помощью ИИ. За стандарт издания отвечает главный редактор — Валерий Курземнек.
Материал редакции Зерокодера. Счёт по выдаче снят собственным прогоном 12 октября 2026 года; цитаты источников приведены дословно. Обновлено: октябрь 2026.
Как подключить DeepSeek к n8n: создайте аккаунт DeepSeek, получите API-ключ на странице API keys, добавьте его в n8n как credential типа DeepSeek, затем привяжите ноду DeepSeek Chat Model к корневому узлу — агенту или цепочке. Собственный прогон редакции 12 октября 2026 года: скачали подборку результатов веб-поиска по запросу «Как подключить DeepSeek к n8n»: текст отдали 6 из 10. Медиана объёма читаемого текста топа — 958 слов. Метку 2026 года несут 5 из 6 прочитанных страниц.
Перед началом пригодятся наши материалы: DeepSeek API key как получить: пошаговая инструкция, Как подключить DeepSeek к VSCode: три пути.
Что понадобится и где взять реквизиты
Документация n8n по credentials DeepSeek перечисляет шаги получения ключа. Сначала создайте аккаунт DeepSeek. Затем войдите в аккаунт и откройте страницу API keys. Там выберите Create new secret key, при желании задайте ключу имя. Скопируйте ключ и добавьте его как API Key в n8n. Документация отдельно ссылается на страницу Your First API Call для дополнительных сведений.
Поддерживаемый метод аутентификации в n8n — API-ключ. Документация n8n по credentials указывает, что эти учётные данные используются для аутентификации нод, и в списке стоит Chat DeepSeek. Для настройки credential нужен сам ключ, полученный на платформе DeepSeek.
В обзоре Hack’celeration отмечено: в n8n учётные данные живут в отдельном меню, независимо от workflow. Там же сказано, что это одинаково на n8n Cloud и на self-hosted инстансе, поэтому workflow, экспортированный из одного окружения, запускается в другом после появления credential на обеих сторонах. Стоимость API лежит на стороне DeepSeek: нода поставляется вместе с n8n, а вызовы API тарифицирует провайдер по своим условиям.
Практический порядок: зарегистрируйтесь на платформе DeepSeek, откройте раздел API keys, создайте секретный ключ и сохраните его в надёжном месте. Ключ показывается один раз — в уроке на Lilys.ai отмечено предупреждение не закрывать окно, пока ключ не скопирован. Дальше ключ вводится в n8n в поле API Key.
| Что нужно | Где взять | Куда вводится |
|---|---|---|
| Аккаунт DeepSeek | Регистрация на платформе DeepSeek | — |
| API-ключ | Страница API keys, кнопка Create new secret key | Поле API Key в credential n8n |
| Base URL | https://api.deepseek.com |
Поле Base URL при подключении через OpenAI-совместимый узел |
| Модель | Список, который n8n загружает из DeepSeek | Параметр Model в ноде Chat Model |
Пошаговая настройка по документации
Документация n8n описывает подключение так. Создайте аккаунт DeepSeek, войдите в него, откройте страницу API keys. Нажмите Create new secret key, при желании назовите ключ. Скопируйте ключ и вставьте его как API Key в n8n. Сохраните credential.
В интерфейсе n8n порядок такой. Откройте меню Credentials, выберите создание новых учётных данных, найдите тип DeepSeek. В открывшемся окне введите API-ключ. Сохраните запись. В уроке на Lilys.ai описано, что нода ищется по слову DeepSeek, при поиске появляется DeepSeek Chat Model, затем нажимается кнопка подключения новых Credentials, выбирается Create New Credentials и открывается окно ввода ключа.
Дальше нода привязывается к корневому узлу. В обзоре Hack’celeration сказано: в AI-схеме n8n корневой узел, например AI Agent или цепочка, принимает элементы workflow на основной вход, а суб-ноды подключаются к его портам — одна чат-модель, одна память, столько инструментов, сколько нужно. Нода DeepSeek Chat Model использует порт ai_languageModel.
Проверка списка моделей. В обзоре Hack’celeration отмечено: n8n обращается к DeepSeek с вашим credential и заполняет список моделями, доступными аккаунту. Документация n8n подтверждает: n8n динамически загружает модели из DeepSeek, и вы видите только те, что доступны вашему аккаунту. Сохраните workflow перед тестом — в обзоре Hack’celeration сказано, что иначе n8n запускает последнюю сохранённую версию.
| Шаг | Действие | Где в интерфейсе |
|---|---|---|
| 1 | Создать аккаунт DeepSeek | Платформа DeepSeek |
| 2 | Создать секретный ключ | Страница API keys |
| 3 | Открыть меню Credentials | n8n, отдельное меню |
| 4 | Создать credential DeepSeek | Create New Credentials |
| 5 | Вставить API Key | Поле API Key |
| 6 | Сохранить credential | Кнопка Save |
| 7 | Привязать Chat Model | Порт ai_languageModel корневого узла |
| 8 | Проверить список моделей | Параметр Model |
Самостоятельная учебная проверка
Соберите минимальную цепочку: Chat Trigger, затем Basic LLM Chain, к которому подключён DeepSeek Chat Model. Это предлагаемая учебная сборка. Цель — убедиться, что credential работает и модель отвечает.
Порядок проверки. Сохраните workflow. Откройте ноду Chat Model и посмотрите, загрузился ли список моделей. Выберите доступную вам модель. Отправьте в чат простой запрос и посмотрите, приходит ли ответ. Критерий результата: список моделей заполнился, ответ пришёл, ошибок авторизации нет.
Отдельно проверьте поведение выражений. Документация n8n по ноде Chat Model поясняет: большинство нод, включая корневые, принимают любое число элементов на вход, обрабатывают их и выдают результат; выражения могут ссылаться на входные элементы, и нода вычисляет выражение для каждого элемента по очереди. Для суб-нод выражение всегда разрешается в первый элемент: при входе из пяти значений {{ $json.name }} всегда даёт первое имя.
Это важно для сборок, где на вход чат-модели идёт несколько элементов. Если вы ожидаете обработку каждого элемента, проверьте, как ведёт себя выражение в вашей цепочке. Учебная проверка: подайте на вход несколько значений и посмотрите, какое из них попадает в запрос к модели.
Проверьте также параметры ответа. Документация n8n описывает Response Format: выбор Text или JSON, где JSON обеспечивает валидный JSON на выходе. Для проверки поставьте JSON и посмотрите, приходит ли структурированный ответ. Если цепочка собирается впервые, начните с Text и одного запроса.
Границы функций и отличия от соседних клиентов
Нода DeepSeek Chat Model применяется для работы чат-моделей DeepSeek с разговорными агентами. Документация n8n указывает, что нода служит для использования чат-моделей DeepSeek с conversational agents. Нода не запускается сама по себе: в обзоре Hack’celeration она описана как суб-нода, вспомогательный узел, который подключается к порту более крупной ноды.
Отличие от веб-чата. Веб-чат DeepSeek даёт диалог в браузере. Нода в n8n встраивает модель в автоматизацию: запрос приходит из workflow, ответ уходит дальше по цепочке. В шаблоне n8n DeepSeek V3 chat & R1 reasoning quick start показаны несколько способов работы с моделями DeepSeek в конвейере автоматизации, включая прямую интеграцию через API с DeepSeek Chat V3 и реализацию через HTTP-запрос в сыром и JSON-форматах.
Совместимость с OpenAI. Документация n8n отмечает: DeepSeek совместим с API OpenAI, поэтому можно обращаться к документации LangChain по OpenAI за дополнительной информацией о сервисе. Это объясняет альтернативный путь — подключение через OpenAI-совместимые credentials с указанием Base URL https://api.deepseek.com и ключа DeepSeek. В уроке на Lilys.ai этот метод описан как вариант, когда прямой ноды нет.
Локальный запуск. В шаблоне n8n упомянуто локальное развёртывание DeepSeek-R1 через Ollama и настройка локальных credentials в n8n. Это отдельный сценарий: модель работает на вашем железе.
Типичные сбои и что проверять
Сбой с ключом. Проверьте, что ключ скопирован полностью и вставлен в поле API Key без лишних пробелов. В уроке на Lilys.ai отмечено, что ключ виден только в момент создания. Если ключ утерян, создайте новый на странице API keys.
Сбой с провайдером. Проверьте, что аккаунт DeepSeek активен и API доступен. В уроке на Lilys.ai сказано, что API — платная услуга и требует пополнения счёта. Условия оплаты API отличаются от условий бесплатного веб-чата.
Сбой с моделью. Проверьте, загрузился ли список моделей. В обзоре Hack’celeration сказано: список не статичен, n8n обращается к DeepSeek с вашим credential и показывает только доступные аккаунту модели, поэтому два человека на одном инстансе видят разные варианты. Если список пуст, вернитесь к проверке credential.
Сбой с сохранением. В обзоре Hack’celeration отмечено: сохраните workflow перед тестом, иначе n8n запускает последнюю сохранённую версию. После правки credential или параметров ноды сохраните изменения и только потом запускайте.
Сбой с выражениями. Если в запрос попадает не тот элемент, вспомните правило суб-нод: выражение разрешается в первый элемент. Проверьте, какой элемент приходит на вход.
| Симптом | Что проверить | Где смотреть |
|---|---|---|
| Ошибка авторизации | Полнота API-ключа | Поле API Key в credential |
| Пустой список моделей | Активность аккаунта и ключа | Параметр Model |
| Ответ не приходит | Сохранён ли workflow | Кнопка Save |
| Не тот элемент в запросе | Правило первого элемента для суб-нод | Выражение в ноде |
| Неожиданный формат ответа | Response Format | Параметры ноды |
Параметры ноды, которые меняют поведение
Sampling Temperature, Top P, Timeout и Max Retries также входят в набор параметров. В обзоре Hack’celeration сказано, что нода несёт 9 параметров и подключается через порт ai_languageModel.
Практический подход к настройке: начните с выбора модели и Response Format Text. Для структурированных данных переключите Response Format на JSON. Для коротких ответов ограничьте Maximum Number of Tokens. Параметры повторов и новых тем трогайте, когда видите конкретную проблему в ответах.
Частые вопросы
Как подключить DeepSeek к n8n?
Создайте аккаунт DeepSeek, получите API-ключ на странице API keys, добавьте его в n8n как credential типа DeepSeek. Затем привяжите ноду DeepSeek Chat Model к корневому узлу через порт ai_languageModel. Сохраните workflow и проверьте, что список моделей загрузился.
Как подключить DeepSeek, если нет прямой ноды?
Используйте OpenAI-совместимый путь: DeepSeek совместим с API OpenAI, поэтому можно указать Base URL https://api.deepseek.com и API-ключ DeepSeek в OpenAI-совместимых credentials. В уроке на Lilys.ai этот метод описан как альтернатива. В шаблоне n8n показана реализация через HTTP-запрос.
Почему не загружается список моделей?
Проверьте полноту API-ключа и активность аккаунта DeepSeek. В обзоре Hack’celeration сказано, что n8n обращается к DeepSeek с вашим credential и показывает только доступные аккаунту модели. Если список пуст, пересоздайте credential и сохраните его.
Нужно ли пополнять счёт DeepSeek?
API — платная услуга. В уроке на Lilys.ai сказано, что для работы API необходимо пополнить счёт. Условия оплаты API отличаются от условий бесплатного веб-чата. Стоимость вызовов тарифицирует провайдер по своим условиям.
Почему ответ приходит не для того элемента?
Для суб-нод выражение всегда разрешается в первый элемент. Документация n8n поясняет: при входе из пяти значений {{ $json.name }} всегда даёт первое имя. Проверьте, какой элемент приходит на вход вашей цепочки, и при необходимости перестройте поток данных.