KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

n8n-nodes-kie

★ 2 Open GitHub ↗

n8n community nodes for Kie.ai — Flux, Sora 2, Kling 3.0, Veo3, Runway Gen4, Wan, Hailuo, Seedream, GPT-Image-1.5, Ideogram, Recraft, Topaz, ElevenLabs, Suno and more

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# n8n-nodes-kie-pro

[![npm version](https://img.shields.io/npm/v/n8n-nodes-kie-pro?color=blue)](https://www.npmjs.com/package/n8n-nodes-kie-pro)
[![npm downloads](https://img.shields.io/npm/dm/n8n-nodes-kie-pro)](https://www.npmjs.com/package/n8n-nodes-kie-pro)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**25 n8n community nodes for [Kie.ai](https://kie.ai)** — the unified AI API covering image generation, video generation, audio, music, chat, and upscaling. One API key. All models.

> Includes Flux-2 Pro, Flux Kontext, Sora 2, Kling 3.0, Veo3, Wan 2.6, Hailuo 2.3, Runway Gen4, Google Imagen4, Nano Banana, Seedream 5.0, Seedance/Bytedance, Qwen Image 2.0, GPT-Image-1.5, Grok Imagine (incl. video + extend), Ideogram v3, Recraft, Topaz, ElevenLabs, Suno V5.5 (incl. Sounds + Mashup), ZImage, InfineTalk, **Gemini** (2.5/3/3.1), **Claude** (4 series), **OpenAI Chat** (GPT-5/Codex), **Midjourney** (Niji 7).

---

## Installation

### Via n8n GUI (Recommended)

1. Open your n8n instance → **Settings → Community Nodes**
2. Click **Install**
3. Enter: `n8n-nodes-kie-pro`
4. Click **Install** and restart n8n

### Docker (CLI)

```bash
docker exec -u node n8n sh -c "
  mkdir -p /home/node/.n8n/nodes &&
  cd /home/node/.n8n/nodes &&
  npm install n8n-nodes-kie-pro
"
docker restart n8n
```

### Bare Metal

```bash
cd ~/.n8n/nodes
npm install n8n-nodes-kie-pro
```

After restarting n8n, search for node names in the node picker (e.g. "Kling", "Suno", "Veo", "Flux").

---

## API Key Setup

1. Visit [kie.ai/api-key](https://kie.ai/api-key) to generate your API key
2. In n8n → **Credentials → New Credential → Kie API**
3. Paste your API key and save

---

## Available Nodes (25 Total)

### 🎬 Video Generation

#### Sora 2 Pro
Operations: Text-to-Video, Image-to-Video, Characters, Storyboard, Remove Watermark, Query Task Status

Models: `sora-2-pro-text-to-video`, `sora-2-text-to-video`, `sora-2-characters-pro`, `sora-2-characters`

Key parameters:
- `prompt` — text description of the video
- `imageUrl` — source image for I2V
- `model` — model variant
- `seed` — reproducibility seed (0 = random)
- `replyUrl` / `replyRef` — webhook callback URL and custom reference
- `waitForCompletion` — poll until done (default: true)

---

#### Kling
Operations: Text-to-Video, Image-to-Video, Video-to-Video (Motion Control), AI Avatar, Query Task Status

Models (T2V): `kling-3.0/video` ✨, `kling-2.6/text-to-video`, `kling/v2-5-turbo-text-to-video-pro`, `kling/v2-1-master-text-to-video`

Models (I2V): `kling-2.6/image-to-video` ✨, `kling/v2-5-turbo-image-to-video-pro`, `kling/v2-1-master-image-to-video`, `kling/v2-1-pro`, `kling/v2-1-standard`

Models (V2V): `kling-3.0/motion-control`, `kling-2.6/motion-control`

Key parameters:
- `prompt`, `imageUrl`
- `model` / `modelI2V` — model variant
- `ratio` — aspect ratio (16:9, 9:16, 1:1)
- `duration` — 5 or 10 seconds (Kling 3.0 supports 3–15s)
- `generationMode` — `std` or `pro` (Kling 3.0 only)
- `enableSound` — boolean, enables native audio (Kling 3.0 only)
- `replyUrl` / `replyRef` — webhook
- `waitForCompletion`

---

#### Seedance
Operations: Text-to-Video, Image-to-Video, Query Task Status

Models: `bytedance/seedance-2`, `bytedance/seedance-2-fast`, `bytedance/seedance-1.5-pro`, `bytedance/v1-pro-text-to-video`, `bytedance/v1-lite-text-to-video`, `bytedance/v1-pro-image-to-video`, `bytedance/v1-lite-image-to-video`, `bytedance/v1-pro-fast-image-to-video`

Key parameters:
- `prompt`, `imageUrl`
- `model`, `ratio`, `duration` (4/8/12/15s)
- `seed`, `lastFrameUrl`, `resolution`, `generateAudio`, `returnLastFrame`, `webSearch`
- `referenceImageUrls`, `referenceVideoUrls`, `referenceAudioUrls`
- `replyUrl`, `replyRef`, `captchaToken`
- `waitForCompletion`

---

#### Veo
Operations: Generate, Extend, Get 1080p Video, Get 4K Video, Query Task Status

Models: `veo3` (Veo 3.1 Quality), `veo3_fast` (Veo 3.1 Fast), `veo3_lite` (Veo 3.1 Lite)

Key parameters:
- `prompt`, `model` — `veo3`, `veo3_fast`, or `veo3_lite`
- `imageUrl` — source image for I2V
- `referenceUrls` — multiple reference images
- `endImageUrl` — end frame
- `ratio` — `16:9`, `9:16`, or `Auto`
- `generationType` — auto, first/last frame, or reference-to-video
- `duration` — 5 or 8 seconds
- `seed`, `watermark`, `replyUrl`, `replyRef`
- `waitForCompletion`

---

#### Wan
Operations: Text-to-Video, Image-to-Video, Video-to-Video, Speech-to-Video, Animate, Image, Query Task Status

Models (T2V): `wan/2-6-text-to-video`, `wan/2-5-text-to-video`, `wan/2-2-a14b-text-to-video-turbo`

Models (I2V): `wan/2-6-image-to-video`, `wan/2-6-flash-image-to-video` ✨, `wan/2-5-image-to-video`, `wan/2-2-a14b-image-to-video-turbo`

Models (V2V): `wan/2-6-video-to-video`, `wan/2-6-flash-video-to-video` ✨, `wan/2-2-animate-move`, `wan/2-2-animate-replace`

Models (Image): `wan/2-7-image`, `wan/2-7-image-pro`

Key parameters:
- `prompt`, `imageUrl`, `videoUrl`
- `model`, `ratio`, `duration`
- `seed`, `endImageUrl`, `replyUrl`, `replyRef`, `captchaToken`
- `imagePrompt`, `inputImageUrl`, `additionalInputImageUrls`
- `imageCount`, `enableSequential`, `imageResolution`, `thinkingMode`, `imageWatermark`, `imageSeed`
- `waitForCompletion`

---

#### Hailuo
Operations: Text-to-Video, Image-to-Video, Query Task Status

Models (T2V): `hailuo/02-text-to-video-pro`, `hailuo/02-text-to-video-standard`

Models (I2V): `hailuo/2-3-image-to-video-pro` ✨, `hailuo/2-3-image-to-video-standard` ✨, `hailuo/02-image-to-video-pro`

Key parameters:
- `prompt`, `imageUrl`
- `model`, `ratio`, `duration`
- `seed`, `endImageUrl`, `replyUrl`, `replyRef`, `captchaToken`
- `waitForCompletion`

---

#### Runway
Operations: Generate, Extend, Aleph Generate, Query Task Status

Models: `gen4_turbo` (Gen4 Turbo), `gen4` (Gen4)

Key parameters:
- `prompt`, `imageUrl`, `endImageUrl`
- `model` — `gen4_turbo` or `gen4`
- `quality` — `720p` or `1080p` (required by Runway API)
- `ratio` — aspect ratio
- `duration` — 5 or 10 seconds
- `seed`, `replyUrl`, `replyRef`
- `waitForCompletion`

---

#### GrokImagine
Operations: Text-to-Image, Image-to-Image, Text-to-Video, Image-to-Video, Upscale, Extend Video ✨, Query Task Status

Models: `grok-imagine/text-to-image`, `grok-imagine/image-to-image`, `grok-imagine/text-to-video`, `grok-imagine/image-to-video`, `grok-imagine/upscale`, `grok-imagine/extend`

Key parameters:
- `prompt`, `imageUrl`
- `aspectRatio`, `videoAspectRatio`, `mode`, `duration`, `resolution`, `seed`
- `outputFormat` — JPEG or PNG
- `replyUrl`, `replyRef`
- `waitForCompletion`

---

### 🖼️ Image Generation

#### Flux
Operations: Text-to-Image, Image-to-Image, Kontext Generate/Edit, Query Task Status

Models (T2I): `flux-2/pro-text-to-image`, `flux-2/flex-text-to-image`

Models (I2I): `flux-2/pro-image-to-image`, `flux-2/flex-image-to-image`

Models (Kontext): `flux-kontext-pro`, `flux-kontext-max`

Key parameters:
- `prompt`, `inputImage`
- `model`, `aspectRatio`, `resolution` — 1K or 2K (T2I/I2I)
- `steps` — inference steps (Kontext)
- `strength` — image strength for I2I (0–1)
- `seed`, `outputFormat` (JPEG/PNG/WebP)
- `replyUrl`, `replyRef`
- `waitForCompletion`

---

#### Seedream
Operations: Text-to-Image, Image Edit, Image-to-Image, Query Task Status

Models: `seedream/5-lite-text-to-image`, `seedream/4.5-text-to-image`, `bytedance/seedream-v4-text-to-image`, `seedream/4.5-edit`, `bytedance/seedream-v4-edit`, `seedream/5-lite-image-to-image`

Key parameters:
- `prompt`, `imageUrl`
- `model`, `aspectRatio`
- `seed`, `outputFormat`
- `replyUrl`, `replyRef`
- `waitForCompletion`

---

#### Google (Imagen4 + Nano Banana)
Operations: Generate, Edit, Image-to-Image, Query Task Status

Models: `google/imagen4-ultra`, `google/imagen4`, `google/imagen4-fast`, `nano-banana-pro`, `nano-banana-2`, `google/nano-banana`, `google/nano-banana-edit`

Key parameters:
- `prompt`, `imageUrl`
- `model`, `aspectRatio`
- `seed`, `outputFormat`, `quality`
- `replyUrl`, `replyRef`
- `waitForCompletion`

---

#### Ideogram
Operations: Generate (V3), Edit (V3) ✨, Remix (V3) ✨, Reframe (V3) ✨, Character, Character Edit, Character Remix, Query Task Status

Models: `ideogram/v3-text-to-image`, `ideogram/v3-edit`, `ideogram/v3-remix`, `ideogram/v3-reframe`, `ideogram/character`, `ideogram/character-edit`, `ideogram/character-remix`

Key parameters:
- `prompt`, `imageUrl`
- `model`, `aspectRatio`
- `renderingSpeed` — TURBO/DEFAULT/QUALITY
- `seed`, `outputFormat`
- `referenceUrls`, `maskUrl`
- `replyUrl`, `replyRef`
- `waitForCompletion`

---

#### Qwen
Operations: Text-to-Image, Image-to-Image, Image Edit, Query Task Status

Models: `qwen2/text-to-image`, `qwen/text-to-image`, `qwen2/image-to-image` ✨, `qwen/image-to-image`, `qwen/image-edit`, `qwen2/image-edit`

Key parameters:
- `prompt`, `imageUrl`
- `model`, `aspectRatio`
- `seed`, `outputFormat`
- `replyUrl`, `replyRef`
- `waitForCompletion`

---

#### GptImage15
Operations: Text-to-Image, Image-to-Image, Query Task Status

Models: `gpt-image/1.5-text-to-image`, `gpt-image/1.5-image-to-image`

Key parameters:
- `prompt`, `imageUrl`
- `aspectRatio`, `quality` (standard/hd)
- `seed`, `outputFormat`
- `replyUrl`, `replyRef`
- `waitForCompletion`

---

#### FourOImage
Operations: Generate, Query Task Status

Models: `gpt-4o-image`, `gpt-4o-image-standard`, `gpt-4o-image-hd`

Key parameters:
- `prompt`, `model`, `aspectRatio`
- `seed`, `outputFormat`
- `replyUrl`, `replyRef`
- `waitForCompletion`

---

#### ZImage
Operations: Generate, Query Task Status

Model: `z-image`

Key parameters:
- `prompt`, `aspectRatio`
- `seed`, `outputFormat`
- `replyUrl`, `replyRef`
- `waitForCompletion`

---

#### Recraft
Operations: Remove Background, Crisp Upscale, Query Task Status

Models: `recraft/remove-background`, `recraft/crisp-upscale`

Key parameters:
- `imageUrl`, `seed`, `outputFormat`
- `replyUrl`, `replyRef`
- `waitForCompletion`

---

#### Topaz
Operations: Image Upscale, Video Upscale, Query Task Status

Models: `topaz/image-upscale`, `topaz/video-upscale`

Key parameters:
- `imageUrl` / `videoUrl`, `scale`
- `outputFormat`
- `replyUrl`, `replyRef`
- `waitForCompletion`

---

### 🎵 Audio & Music

#### ElevenLabs
Operations: Text-to-Speech, Text-to-Dialogue V3 ✨, Speech-to-Text, Sound Effects, Audio Isolation, Query Task Status

Models: `elevenlabs/text-to-speech-turbo-2-5`, `elevenlabs/text-to-speech-multilingual-v2`, `elevenlabs/text-to-dialogue-v3`

Key parameters:
- `text` — text to speak
- `ttsModel`, `voice` (Rachel, Aria, Roger, Sarah, Laura, etc.)
- `stability`, `similarityBoost`
- `dialogue` — array of `{ voiceId, text }` turns (Text-to-Dialogue)
- `waitForCompletion`

---

#### Suno
Operations: Generate Music, Extend Music, Upload & Cover Audio, Upload & Extend Audio, Add Instrumental, Add Vocals, Replace Music Section, Generate Lyrics, Boost Style, Convert to WAV, Separate Vocals, Generate MIDI, Create Music Video, **Generate Sound** ✨, **Music Mashup** ✨, Query Task Status

Models: `V5_5` ✨, `V5`, `V4_5PLUS`, `V4_5ALL`, `V4_5`, `V4`, `V3_5`

Key parameters:
- `prompt` — style/lyric prompt
- `modelVersion` — `V5`, `V4_5PLUS`, `V4_5ALL`, `V4_5`, `V4`, or `V3_5`
- `tags` — style tags (e.g. "pop, female vocals")
- `title`, `lyrics`, `style`, `instrumental`
- `sourceTaskId` — for extend/boost/midi/video operations
- `uploadUrl` — audio URL for upload operations
- `replyUrl`, `replyRef`
- `waitForCompletion`

---

#### InfineTalk
Operations: Dub from Audio, Query Task Status

Model: `infinetalk/from-audio`

Key parameters:
- `audioUrl` — source audio file
- `targetLanguage`
- `replyUrl`, `replyRef`
- `waitForCompletion`

---

### 💬 Chat / LLM

#### Claude (Kie.ai) ✨
Operations: Chat Completion

Models: `claude-opus-4-6` ✨, `claude-sonnet-4-6`, `claude-haiku-4-5`, `claude-sonnet-4-5`, `claude-opus-4-5`

Key parameters:
- `model` — Claude model to use
- `message` — user message
- `systemPrompt` — optional system instructions
- `chatHistory` — JSON array of `{role, content}` for multi-turn conversations
- `imageUrl` — optional image for multimodal inputs
- `temperature`, `maxTokens`
- Returns `reply` + `updatedHistory` for chaining

---

#### OpenAI Chat (Kie.ai) ✨
Operations: Chat Completion

Models: `chat/gpt-5-2` ✨, `market/codex/gpt-codex`

Key parameters:
- `model` — GPT-5.2 or GPT Codex
- `message`, `systemPrompt`, `chatHistory`
- `reasoningEffort` — low/medium/high
- `webSearch` — enable Google Search grounding
- Returns `reply` + `updatedHistory`

---

#### Gemini (Kie.ai) ✨
Operations: Chat Completion

Models: `gemini/gemini-3.1-pro` ✨, `gemini/gemini-3-pro`, `gemini/gemini-2.5-pro`, `gemini/gemini-2.5-flash`

Key parameters:
- `model`, `message`, `systemPrompt`, `chatHistory`
- `imageUrl` — multimodal support
- `googleSearch` — enable real-time search grounding
- `thinkingBudget` — reasoning tokens
- Returns `reply` + `updatedHistory`

---

### 🎨 Image Generation (continued)

#### Midjourney (Kie.ai) ✨
Operations: Text-to-Image, Image-to-Image, Query Task Status

Models: Midjourney Standard, Niji 7 (anime)

Key parameters:
- `prompt`, `imageUrl`
- `model` — Standard or Niji 7
- `mode` — relaxed / fast / turbo
- `aspectRatio`, `seed`
- `replyUrl`, `replyRef`
- `waitForCompletion`

---

## Features

- **`waitForCompletion`** on all create operations (on by default) — polls every 3s up to 5 min
- **`resultUrls`** surfaced at top level in every response for direct file access
- **Webhook support** via `replyUrl` + `replyRef` on all nodes
- **`seed`** parameter on all generation nodes for reproducible outputs
- **Bearer token auth** — single Kie.ai API key for all 22 nodes
- **Exponential backoff** on 429 rate limit errors (2s / 4s / 8s retries)
- **`continueOnFail`** support on all nodes

---

## Usage Pattern

1. Drop a node into your workflow (e.g. **Kling**)
2. Select the operation (e.g. **Text-to-Video**)
3. Choose a model variant and fill in the prompt
4. Execute — the node waits for completion and returns `resultUrls`

**Fire-and-forget:** Disable **Wait for Completion** and use **Query Task Status** later with the returned `taskId`.

---

## Rate Limits

Kie.ai enforces 20 requests per 10 seconds. When throttled, the API returns HTTP 429.

Automatic retry with exponential backoff:

| Retry | Delay |
|-------|-------|
| 1st   | 2 s   |
| 2nd   | 4 s   |
| 3rd   | 8 s   |

After 3 retries the error is propagated. For high-volume workflows, use `waitForCompletion: false` and manage concurrency at the n8n level.

---

## Links

- [Kie.ai](https://kie.ai)
- [Kie.ai API Docs](https://docs.kie.ai)
- [npm package](https://www.npmjs.com/package/n8n-nodes-kie-pro)
- [GitHub Repository](https://github.com/ArielleTolome/n8n-nodes-kie)

---

## Changelog

See [CHANGELOG.md](./CHANGELOG.md) for the full history.

| Version | Highlights |
|---------|-----------|
| **v0.13.0** | ✨ NEW: Claude node (Opus 4.6, Sonnet 4.6, Haiku 4.5), OpenAI Chat (GPT-5.2, Codex), Midjourney (Niji 7); Suno V5.5 + Sounds + Mashup operations; Grok multi-image support; auto-publish CI |
| **v0.12.2** | Fix Kling 3.0 `multi_shots cannot be empty` 422 — different API schema from v2.x now fully handled |
| **v0.12.1** | Fix Kling 3.0 `mode` field always required — fixes 500 error |
| **v0.12.0** | ✨ NEW: Gemini node (2.5 Flash/Pro, 3 Pro, 3.1 Pro) with multimodal + Google Search |
| **v0.11.0** | Deep audit: `negativePrompt`, `seed`, `numOutputs` added across 9 nodes (Hailuo, GrokImagine, Kling, Seedream, Wan, Seedance, Google, Ideogram, Flux) |
| **v0.10.0–v0.10.4** | GrokImagine aspect_ratio fix; Kling mode/sound fix; InfineTalk registration; Suno model format fix |
| v0.5.6 | Model ID audit; published as `n8n-nodes-kie-pro` |
| v0.4.5 | 36 API snake_case naming bugs fixed across 11 nodes |
| v0.4.0 | Kling 3.0 support; 429 retry with exponential backoff |
| v0.1.0 | Initial release — 21 nodes |

---

## License

MIT

n8n-nodes-kie

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README