> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# Использование BeatAPI в n8n

> Подключите модели и данные BeatAPI к n8n и импортируйте рабочий процесс для своей задачи, учитывая границы выполненных проверок.

# Использование BeatAPI в n8n

Выберите способ подключения под свою задачу. Учётные данные модели, HTTP-процесс и опубликованный шаблон n8n — разные вещи.

| Задача                                   | Компонент n8n                                             | Интерфейс BeatAPI                                             |
| ---------------------------------------- | --------------------------------------------------------- | ------------------------------------------------------------- |
| Текст в AI Agent или LLM Chain           | Встроенный OpenAI Chat Model                              | `https://api.beatapi.io/v1` и точный ID из `GET /v1/models`   |
| Social Data или исследование веба        | HTTP Request с Header Auth                                | Проверенная возможность или документированный метод Data/Web  |
| Изображение, видео или музыкальное видео | HTTP Request, Wait и цикл проверки статуса с ограничением | Создайте задачу один раз, сохраните её ID и проверяйте статус |

## Настройте учётные данные

Для OpenAI Chat Model создайте учётные данные OpenAI с ключом BeatAPI и базовым адресом `https://api.beatapi.io/v1`. Для узлов HTTP Request создайте Header Auth с заголовком `Authorization` и значением `Bearer <your BeatAPI key>`. Храните настоящие ключи в учётных данных n8n, а не в экспортируемом JSON.

## Импортируйте рабочий процесс

[Примеры BeatAPI для n8n](https://github.com/BeatAPI/beatapi-examples/tree/codex/n8n-capabilities/integrations/n8n) содержат процесс работы с возможностями, три общедоступных исследовательских процесса Social Data и процесс создания музыкального видео. Актуальные изменения Social Data находятся в [PR #20](https://github.com/BeatAPI/beatapi-examples/pull/20). Этот pull request — материал для проверки, а не подтверждение принятого релиза или публикации в n8n Marketplace.

1. Загрузите JSON рабочего процесса и импортируйте его в n8n.
2. Откройте **Configure Inputs** и замените примерные значения.
3. Назначьте свои учётные данные Header Auth каждому узлу HTTP Request, обращающемуся к BeatAPI.
4. До платного запуска проверьте входные и выходные данные, цену и инструкции выполнения выбранной возможности.
5. Проверьте одно выполнение и сохраните ID запроса или задачи BeatAPI вместе с ID выполнения n8n.

Для асинхронной работы повторяйте чтение статуса, не создавая новую оплачиваемую задачу. Завершайте цикл при успехе, ошибке или достижении заданного тайм-аута. Тайм-аут в n8n не доказывает, что задача BeatAPI завершилась ошибкой.

## Статус проверки

По состоянию на 26 сентября 2026 года три JSON-файла Social Data были импортированы в локальный n8n. Процесс поиска по ключевым словам в X успешно выполнился локально; для Instagram и YouTube проверены API и импорт, но не полное выполнение в n8n. Шаблон X был отправлен в n8n Creator Portal на ручную проверку. Актуальное состояние публикации смотрите в [PR #20](https://github.com/BeatAPI/beatapi-examples/pull/20) и каталоге шаблонов n8n.

Для этих примеров достаточно встроенных узлов. Отдельный community node BeatAPI для n8n не опубликован.