n8n-nodes-kie

This n8n community node enables seamless integration of Kie.ai in your n8n workflows. Access powerful AI models for image generation, video creation, image upscaling, and more.

Features

• Multiple AI Image Generation Models: Seedream, Flux-2 Pro, Qwen, Z-Image, Google Nano Banana Pro
• Image Upscaling: Topaz and Recraft Crisp AI enhancement
• Video Upscaling: Topaz AI video enhancement
• Video Generation: Veo3, Wan 2.6, Hailuo, Seedance, Grok Imagine text/image/video-to-video models
• Video Enhancement: Veo3 1080P/4K upgrades and video extension
• Storyboard Creation: Sora 2 Pro multi-shot dynamic scene transitions
• Audio-to-Video: Infinitalk talking head video generation
• Character Management: Sora 2 reusable character animation system
• Watermark Removal: Sora 2 professional watermark removal
• File Management: Upload files to Kie.ai storage
• Task Status Tracking: Monitor and retrieve generation results

Installation

Follow the installation guide in the n8n community nodes documentation.

Quick Install

npm install n8n-nodes-kie

Credentials

You'll need a Kie.ai API key to use these nodes:

1. Sign up at kie.ai
2. Navigate to API Key Management
3. Generate a new API key
4. Add the API key to your n8n credentials

Available Nodes

Image Generation

Kie Seedream

Generate or edit images using Seedream 4.5 models.

• Text-to-Image: Create images from text descriptions
• Image Editing: Transform existing images based on prompts
• Auto Mode Selection: Automatically chooses the right model based on input
• Aspect Ratios: 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
• Quality Options: Basic, High

Kie Flux-2 Pro

High-quality image generation using Flux-2 Pro models.

• Text-to-Image: Generate images from text prompts
• Image-to-Image: Transform existing images (1-8 images)
• Aspect Ratios: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, auto
• Resolution: 1K, 2K
• Prompt Length: 3-5000 characters

Kie Qwen

Advanced image generation with operation modes.

• Generate/Transform: Text-to-image or image-to-image with strength control
• Edit Mode: Specific image modifications
• Image Sizes: square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
• Strength Parameter: Control transformation intensity (image-to-image)
• Usage Hints: Built-in interface guidance

Kie Z-Image

Simple text-to-image generation.

• Text-to-Image Only: Generate images from text descriptions
• Aspect Ratios: 1:1, 4:3, 3:4, 16:9, 9:16
• Streamlined Interface: Quick and easy image generation

Kie Google Nano Banana Pro

Google's advanced image-to-image model.

• Optional Input Images: Supports both text-to-image and image-to-image
• Multiple Aspect Ratios: 1:1, 9:16, 16:9, 4:3, 3:4
• Resolution Options: 1K, 2K, 4K
• Output Formats: PNG, JPEG, WebP

Image Enhancement

Kie Image Upscaler

AI-powered image upscaling with dual engines.

• Topaz AI: Configurable upscale factors (1x, 2x, 4x, 8x)
• Recraft Crisp: Automatic intelligent upscaling
• Supported Formats: JPEG, PNG, WebP (max 10MB)
• Service Selection: Choose the best upscaler for your needs

Video Enhancement

Kie Video Upscaler

AI-powered video upscaling using Topaz.

• Topaz Video Enhancement: Professional video upscaling
• Upscale Factors: 1x, 2x, 4x
• Supported Formats: MP4, QuickTime, Matroska (max 10MB)
• Use Cases: Video quality enhancement, content restoration, resolution upgrades

Video Generation

Kie Sora 2 Pro

Professional video generation with character integration.

• Text-to-Video: Generate videos from text descriptions (max 10,000 characters)
• Image-to-Video: Create videos from images with optional text guidance
• Character Integration: Use up to 5 character IDs from Sora 2 Characters node
• Aspect Ratios: Landscape, Portrait
• Duration: 10 or 15 seconds
• Quality: Standard or High
• Watermark Removal: Optional watermark elimination
• Use Cases: Professional content, character-driven stories, multi-scene productions

Kie Sora 2 Pro Storyboard

Multi-shot storyboard video creation with dynamic scene transitions.

• Dynamic Shots: Add 1-10 customizable shots with individual scene descriptions
• Precise Timing: Each shot has configurable duration (0.1-15 seconds)
• Duration Validation: Automatic validation ensures total shot durations match video length
• Video Durations: 10, 15, or 25 seconds total
• Single Image Source: One image used across all shots with scene-based transformations
• Aspect Ratios: Landscape, Portrait
• Flexible Storytelling: Create complex narratives with multiple scene transitions
• Use Cases: Storyboard previews, multi-scene content, narrative videos, presentation sequences

Kie Veo3

Google's Veo 3.1 professional video generation and enhancement.

• Generate Video: Text-to-video or image-to-video (1-2 images)
• Extend Video: Continue existing videos with new content
• 1080P Upgrade: Enhance 16:9 videos to 1080P (returns URL directly, 1-3 min processing)
• 4K Upgrade: Enhance 16:9/9:16 videos to 4K (returns taskId, 5-10 min processing, 2× credits)
• Models: Veo3 (quality) or Veo3 Fast (speed/cost-efficient)
• Aspect Ratios: 16:9, 9:16, 1:1 (upgrades only for 16:9 and 9:16)
• Customization: Seed control, watermarks, translation support
• Important: Extend videos before upgrading to 1080P/4K
• Use Cases: Professional video production, content extension, resolution enhancement

Kie Grok Imagine

AI-powered video generation with style modes.

• Text-to-Video: Generate videos from detailed text descriptions
• Image-to-Video: Transform external images or previously generated Grok images into dynamic videos
• Duration Options: 6 or 10 seconds
• Mode Options: Normal (balanced), Fun (creative/playful), Spicy (intense motion)
• Aspect Ratios: 2:3, 3:2, 1:1, 16:9, 9:16 (text-to-video)
• Image Sources: External image URLs OR task_id + index from previously generated Grok images
• Rate Limits: 30 concurrent tasks, 300 tasks/hour
• Video Validity: Generated URLs valid for 24 hours
• Use Cases: Dynamic content, social media videos, creative animations

Kie Seedance

ByteDance's versatile video generation model.

• Text-to-Video: Generate videos from text descriptions
• Image-to-Video: Animate 1-2 images with optional camera movements
• Auto Mode Detection: Automatically switches between text-to-video and image-to-video based on input
• Duration: Customizable video length (default 8 seconds)
• Fixed Lens: Optional stable camera positioning
• Audio Generation: Optional soundtrack creation (increases cost)
• Resolution: 720p
• Use Cases: Creative content, animations, image-based storytelling

Kie Hailuo

High-quality cinematic video generation.

• Text-to-Video: Generate videos from detailed text descriptions
• Image-to-Video: Create videos from images with text prompts
• Prompt Optimizer: Automatic prompt enhancement for better results
• End Frame Control: Optional ending image specification (image-to-video)
• Cinematic Support: Complex descriptions with camera movements and visual effects
• Use Cases: Professional video content, cinematic sequences, visual storytelling

Kie Wan 2.6

Versatile video generation with multiple modes.

• Text-to-Video: Generate videos from text descriptions only
• Image-to-Video: Create videos from images with text prompts
• Video-to-Video: Transform existing videos based on prompts
• Duration Options: 5, 10, or 15 seconds
• Resolution: 720p, 1080p
• Auto Model Selection: Automatically chooses the right model based on operation
• Use Cases: Content creation, video marketing, animation

Kie Infinitalk

Generate talking head videos from audio.

• Audio-to-Video: Animate static images with audio
• Input: Portrait image + audio file
• Resolution Options: 480p, 720p, 1080p
• Prompt Control: Describe desired animation style
• Use Cases: Avatars, presentations, content creation

Character & Asset Management

Kie Sora 2 Characters

Create reusable character animations from video.

• Character ID Generation: Upload video to create reusable character reference
• Video Requirements: 1-4 seconds, max 10MB, MP4/WebM/AVI formats
• Reusable Characters: character_id can be used in multiple animation jobs
• Optional Customization: Character prompt and safety instructions
• Storage Notice: Files stored for 14 days (use permanent storage for production)
• Use Cases: Consistent character animations, character libraries, multi-scene content

Kie Sora Watermark Remover

Remove watermarks from Sora 2 generated videos.

• OpenAI Sora 2 Only: Works exclusively with videos from sora.chatgpt.com
• URL Validation: Automatically validates Sora 2 video URLs
• Clean Results: Professional watermark-free videos
• Storage Notice: Processed videos stored for 14 days
• Use Cases: Professional content, commercial use, brand consistency

Utilities

Kie File Upload

Upload files to Kie.ai storage for use in other nodes.

• Binary File Support: Upload any file from n8n workflow
• URL Output: Returns hosted file URL for use in generation nodes
• Essential: Required before using local files in image/video nodes

Kie Task Status

Monitor and retrieve results from generation tasks.

• Task Monitoring: Query status of any Kie.ai generation job
• Result Retrieval: Get generated file URLs and metadata
• Clean Response: Automatically parses nested JSON responses
• Polling Support: Use in loops to wait for task completion

Workflow Examples

Basic Image Generation

1. Kie Seedream (Text-to-Image)
   - Prompt: "A beautiful sunset over mountains"
   - Aspect Ratio: 16:9
   - Quality: High
   ↓
2. Kie Task Status
   - Task ID: {{ $json.data.taskId }}
   - Wait for completion
   ↓
3. Download or use generated image

Image Upscaling Pipeline

1. Kie Seedream (Generate Image)
   ↓
2. Kie Task Status (Get Result URL)
   ↓
3. Kie Image Upscaler (Topaz 4x)
   - Image URL: {{ $json.result.output[0] }}
   ↓
4. Kie Task Status (Get Upscaled Result)

Audio-to-Video with File Upload

1. Read Binary File (Portrait Image)
   ↓
2. Kie File Upload (Upload Portrait)
   ↓
3. Kie Infinitalk
   - Image URL: {{ $json.data.url }}
   - Audio URL: [your audio URL]
   - Resolution: 1080p
   ↓
4. Kie Task Status (Get Video URL)

API Documentation

For detailed API documentation, visit docs.kie.ai

Supported Models

• seedream/4.5-text-to-image & seedream/4.5-edit
• flux-2/pro-text-to-image & flux-2/pro-image-to-image
• qwen/text-to-image, qwen/image-to-image & qwen/image-edit
• z-image
• nano-banana-pro
• topaz/image-upscale
• topaz/video-upscale
• recraft/crisp-upscale
• grok-imagine/text-to-video & grok-imagine/image-to-video
• bytedance/seedance-1.5-pro
• hailuo/02-text-to-video-pro & hailuo/02-image-to-video-pro
• wan/2-6-text-to-video, wan/2-6-image-to-video & wan/2-6-video-to-video
• sora-2-characters
• sora-2-pro-text-to-video & sora-2-pro-image-to-video
• infinitalk/from-audio

Callback URLs

All generation nodes support optional callback URLs for production use:

• Avoid polling delays
• Receive instant notifications when tasks complete
• Recommended for high-volume workflows

Error Handling

All nodes support n8n's "Continue On Fail" option:

• Enable in node settings to handle errors gracefully
• Failed items return error details in JSON
• Workflow continues processing remaining items

Compatibility

• n8n Version: 1.80.0 and above
• Node.js: 18.10 or higher
• Package Manager: pnpm 9.1 or higher

Development

# Install dependencies
pnpm install

# Build nodes
pnpm run build

# Watch mode for development
pnpm run dev

# Format code
pnpm run format

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Support

• Issues: GitHub Issues
• Documentation: Kie.ai Docs
• API Status: kie.ai

License

MIT

Author

Valics Lehel

• Email: [email protected]
• GitHub: @lvalics

Acknowledgments

• n8n - Workflow automation platform
• Kie.ai - AI model marketplace
• n8n community for support and feedback