n8n-nodes-kie-ai

Интеграция Kie AI для n8n - генерация видео, аудио и изображений с помощью искусственного интеллекта.

Описание

Эта нода позволяет интегрировать мощные возможности Kie AI API в ваши рабочие процессы n8n. С помощью этой ноды вы можете генерировать высококачественные видео, аудио и изображения, используя передовые модели искусственного интеллекта.

Поддерживаемые сервисы

Runway Video

Генерация видео из текстовых описаний
Анимация изображений в видео
Расширение существующих видео
Поддержка различных форматов и качества

Veo 3 Video

Генерация видео с помощью модели Veo 3
Высококачественные результаты
Проверка статуса генерации

Suno Audio

Генерация музыки и аудио из текста
Различные музыкальные стили
Асинхронная обработка

Image Generation

Генерация изображений из текстовых описаний
Поддержка различных стилей
Быстрая обработка

Установка

Из npm (рекомендуется)

npm install n8n-nodes-kie-ai

Из исходного кода

Клонируйте репозиторий:

git clone https://github.com/your-username/n8n-nodes-kie-ai.git
cd n8n-nodes-kie-ai

Установите зависимости:
```
npm install
```
Соберите проект:
```
npm run build
```
Установите ноду в n8n:
```
npm link
```

Установка в n8n

После установки пакета, перезапустите n8n. Нода "Kie AI" появится в списке доступных нод в категории "AI".

Настройка

Получение API ключа

Зарегистрируйтесь на kie.ai
Перейдите в панель управления
Найдите раздел "API-ключ"
Скопируйте ваш API ключ

Настройка credentials в n8n

В n8n перейдите в раздел "Credentials"
Нажмите "Create New"
Выберите "Kie AI API"
Введите ваш API ключ
Сохраните credentials

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

Генерация видео с Runway

Добавьте ноду "Kie AI" в ваш workflow
Выберите Resource: "Runway Video"
Выберите Operation: "Generate Video"
Настройте параметры:
- Prompt: Описание желаемого видео
- Duration: Длительность (5 или 8 секунд)
- Quality: Качество (720p или 1080p)
- Aspect Ratio: Соотношение сторон
- Image URL (опционально): URL изображения для анимации
- Watermark (опционально): Текст водяного знака

Проверка статуса генерации

Используйте Operation: "Get Video Status"
Введите Task ID, полученный при генерации
Получите информацию о статусе и ссылку на готовое видео

Расширение видео

Выберите Operation: "Extend Video"
Введите Task ID оригинального видео
Добавьте новый prompt для продолжения
Настройте параметры качества и длительности

Примеры использования

Простая генерация видео

{
  "resource": "runwayVideo",
  "operation": "generate",
  "prompt": "A cat dancing in a colorful room with disco lights",
  "duration": 5,
  "quality": "720p",
  "aspectRatio": "16:9"
}

Анимация изображения

{
  "resource": "runwayVideo",
  "operation": "generate",
  "prompt": "The person in the image starts walking forward",
  "imageUrl": "https://example.com/image.jpg",
  "duration": 5,
  "quality": "1080p",
  "aspectRatio": "16:9"
}

Генерация музыки

{
  "resource": "sunoAudio",
  "operation": "generate",
  "prompt": "Upbeat electronic music with synthesizers"
}

Параметры API

Общие параметры

Параметр	Тип	Обязательный	Описание
prompt	string	Да	Текстовое описание желаемого контента
callBackUrl	string	Нет	URL для получения уведомлений о завершении

Параметры Runway Video

Параметр	Тип	Значения	Описание
duration	number	5, 8	Длительность видео в секундах
quality	string	"720p", "1080p"	Качество видео (1080p только для 5 сек)
aspectRatio	string	"16:9", "9:16", "1:1", "4:3", "3:4"	Соотношение сторон
imageUrl	string	-	URL изображения для анимации
waterMark	string	-	Текст водяного знака

Обработка ошибок

Нода автоматически обрабатывает основные ошибки API:

400: Неверные параметры запроса
401: Неверный или отсутствующий API ключ
402: Недостаточно кредитов на аккаунте
422: Ошибка валидации параметров
429: Превышен лимит запросов
500: Внутренняя ошибка сервера

Лимиты и ограничения

Максимальная длительность видео: 8 секунд
Качество 1080p доступно только для 5-секундных видео
Сгенерированные видео хранятся 14 дней
Лимиты запросов зависят от вашего тарифного плана

Разработка

Требования

Node.js >= 20.15
npm
n8n

Локальная разработка

Клонируйте репозиторий
Установите зависимости: npm install
Запустите в режиме разработки: npm run dev
Соберите проект: npm run build

Тестирование

npm run lint
npm run format

Поддержка

Email: support@kie.ai
Документация: docs.kie.ai
GitHub Issues: Создать issue

Лицензия

MIT License - см. файл LICENSE для подробностей.

Changelog

v1.0.0

Первый релиз
Поддержка Runway Video API
Поддержка Veo 3 Video API
Поддержка Suno Audio API
Поддержка Image Generation API
Полная интеграция с n8n credentials system

Package detail

n8n-nodes-karpix-veo3

readme