Description

n8n-nodes-kie-pro


25 n8n community nodes for 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)

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

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 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), veo3fast (Veo 3.1 Fast), veo3lite (Veo 3.1 Lite)

Key parameters:

• prompt, model — veo3, veo3fast, or veo3lite
• 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: V55 ✨, V5, V45PLUS, V45ALL, V45, V4, V3_5

Key parameters:

• prompt — style/lyric prompt
• modelVersion — V5, V45PLUS, V45ALL, V45, V4, or V35
• 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
• Kie.ai API Docs
• npm package
• GitHub Repository

—

Changelog

See 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