<!-- /docs/n8n (ru) -->

# n8n

Официальный пакет `@apergrex/n8n-nodes-franklab`. В npm на 08.09.2026 опубликована версия **0.2.4**. Пакет включает 25 нод для генерации и обработки медиа, текста и управления ресурсами.

## Установка в свой n8n

1. Войдите в самостоятельно размещённый n8n как Owner или Admin.
2. Откройте Settings → Community Nodes → Install.
3. Укажите `@apergrex/n8n-nodes-franklab@0.2.4`.
4. Ознакомьтесь с предупреждением n8n о сторонних пакетах и подтвердите установку.
5. Дождитесь появления пакета в списке. Добавьте нужную ноду FrankLab в свой workflow.

Если Community Nodes недоступен, проверьте роль пользователя и настройки вашего экземпляра. Инструкция относится к self-hosted n8n; доступность в n8n Cloud проверяется отдельно.

## Подключение

Создайте credential FrankLab и вставьте API-ключ в поле API Key. Пакет 0.2.4 принимает Base URL `https://franklab.ru/franklab/api` или `https://franklab.ru`. Произвольный адрес, включая `apergrex.ru`, в этой версии не поддерживается.

Ключ храните в credentials n8n. Не вставляйте его в prompt, экспорт workflow или обычные текстовые поля.

## Первый workflow

1. Добавьте Manual Trigger и FrankLab MARS.
2. Выберите Text to Video, Duration = 5 и Aspect Ratio = 16:9. В Additional JSON укажите `{"model_name":"mars-v1-5","mode":"std"}`. Поле Model оставьте пустым: полный контракт передаётся через Additional JSON.
3. Впишите текст сцены и выберите credential FrankLab.
4. До запуска проверьте баланс и оценку цены по [инструкции первой генерации](/docs).
5. Один запуск создаёт платную задачу. Сохраните идентификатор и используйте Get Text Video Status; повтор создания при таймауте может создать вторую задачу.
6. При успешном завершении возьмите ссылку на видео из результата. При неопределённом статусе проверьте существующую задачу и обратитесь в поддержку.

## Какие ноды входят

HOLST, KLEY, PLASTINKA, VOLNA, C2PA, SUFLER, TextSticker, ORKESTR, JUPITER, MARS, SATURN, MOON, VENUS, X, MiniMax, DOLA, Alibaba, OMNI, KUSOK, MERCURY, NEPTUNE, PLUTO, ARIES, TITAN и Hot Coffe.

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

## Материалы

[Пакет в npm](https://www.npmjs.com/package/@apergrex/n8n-nodes-franklab)

[Исходники и описание операций](https://github.com/d906090-rgb/n8n-nodes-franklab)

[Инструкция n8n по установке](https://docs.n8n.io/integrations/community-nodes/installation-and-management/gui-installation)