Professional Freepik AI integration for ComfyUI workflows

Bring Freepik's powerful AI capabilities directly into your ComfyUI workflows with seamless integration, smart caching, and pay-as-you-go pricing.

• 🎨 Mystic AI - Photorealistic text-to-image generation
• 🔍 Creative Upscaler - Magnific.ai powered prompt-guided enhancement (2x-16x)
• 🎯 Precision Upscaler - High-fidelity upscaling without hallucinations
• ✂️ Background Removal - Instant AI-powered background removal
• 💾 Smart Caching - Automatic result caching (30-day retention)
• 💰 Cost Management - Real-time cost estimation before execution
• 🔄 Async Processing - Non-blocking task management with progress tracking

1. Clone or download into your ComfyUI custom nodes directory:

cd ComfyUI/custom_nodes
git clone https://github.com/yourusername/ComfyUI-Freepik.git
cd ComfyUI-Freepik

2. Install dependencies:

pip install -r requirements.txt

3. Get your API key:

   • Visit Freepik API Dashboard
   • Sign up and create an API key
   • Get $5 free credits to start

4. Restart ComfyUI and look for nodes under Freepik/ category

1. Add Freepik Mystic node
2. Enter your API key
3. Write a prompt
4. Connect to Preview Image or Save Image
5. Queue prompt!

Generate photorealistic 2K images from text prompts.

Features:

• Multiple aspect ratios (16:9, 1:1, 9:16, 4:3, 21:9)
• LoRA style support
• Seed control for reproducibility
• Cost: €0.10 per image

Outputs:

• square_1_1: 2048×2048
• widescreen_16_9: 2752×1536
• social_story_9_16: 1536×2752

AI-powered upscaling with prompt guidance (Powered by Magnific.ai)

Features:

• Upscale factors: 2x, 4x, 8x, 16x
• Prompt-guided enhancement
• Creativity control (0.0-1.0)
• Detail level control (0.0-1.0)
• Cost: €0.10 - €1.60+ depending on output size

Best for:

• Architectural renders (creativity: 0.3-0.5)
• Interior design (detail: 0.6-0.7)
• Concept art enhancement

High-fidelity upscaling without AI hallucinations

Features:

• Faithful to original content
• Perfect for logos, UI, technical drawings
• Denoise strength control
• Sharpen control
• Same cost structure as Creative

Instant background removal with alpha mask output

Features:

• Returns image + alpha mask
• Fast and reliable
• Minimal cost

ComfyUI-Freepik is more cost-effective when:

• ✅ You process < 90 upscales/month → Save 33-89%
• ✅ You need automation and complex workflows
• ✅ Usage is variable month-to-month
• ✅ You prefer pay-as-you-go with no monthly commitment

Breakeven Analysis:

For most users (< 90/month): ComfyUI-Freepik saves 33-89%

📊 Read full cost analysis

Freepik Mystic → Preview Image

Freepik Mystic (2K, 16:9) → 
Freepik Upscaler Creative (4x) → 
Save Image

Output: 2752×1536 → 11008×6144

Freepik Mystic (architectural prompt) → 
Freepik Upscaler Precision (2x-4x) → 
Post-processing nodes → 
Final delivery

Load Image → 
Freepik Remove Background → 
Composite with new background

ComfyUI_Freepik/
├── __init__.py              # Node registration
├── requirements.txt         # Dependencies
├── api/
│   ├── client.py           # HTTP client with retry logic
│   └── tasks.py            # Async task manager
├── nodes/
│   ├── generation/
│   │   └── mystic_node.py  # Text-to-image
│   ├── editing/
│   │   └── upscaler_nodes.py # Upscalers
│   └── utilities/
│       └── remove_bg_node.py # Background removal
└── utils/
    ├── cache.py            # Caching system
    └── image_utils.py      # Image conversions

• Smart Caching: MD5-based parameter matching with automatic cleanup
• Async Processing: Non-blocking execution with configurable intervals
• Error Recovery: Exponential backoff retry strategy (3 retries)
• Multi-format Support: JSON + multipart/form-data requests
• Progress Tracking: Real-time status updates during processing
• Cost Transparency: Estimation before execution

• Python 3.9+
• ComfyUI (latest version recommended)
• Internet connection
• Freepik API key

Python Dependencies:

• requests
• Pillow
• torch

Recommended for Architecture:

• Creativity: 0.3-0.5
• Detail Level: 0.6-0.7
• Prompt: "enhance architectural details, photorealistic render, natural lighting"

📖 Full parameter reference

# Process multiple images automatically
for image in image_list:
    mystic_node.generate(
        api_key=api_key,
        prompt=prompt,
        aspect_ratio="widescreen_16_9"
    )

Integrate with other ComfyUI nodes for complex pipelines:

• Pre-processing with ControlNet
• Post-processing with color correction
• Automated client delivery systems

• Enable caching to avoid redundant API calls
• Batch similar operations
• Use appropriate resolution for your needs

• Mystic outputs fixed ~2K resolution (aspect ratio determines dimensions)
• Some Magnific parameters not available (Resemblance, Fractality, Engine)
• Rate limits apply (check Freepik API documentation)

• ❌ No Resemblance slider
• ❌ No Fractality slider
• ❌ No Engine selection
• ✅ But: Full workflow automation
• ✅ And: Pay-as-you-go pricing

• Video Generation nodes (Kling v2.5, PixVerse V5)
• Image Relighting
• Style Transfer
• Image-to-Prompt utility
• LoRA Training nodes
• Batch processing manager
• Credit tracker dashboard

• Remove debug prints
• Add architectural preset system
• Optimize cache management
• Progress bars in UI
• Better error messages

• Installation Guide
• Cost Analysis
• Parameter Reference
• Changelog

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

MIT License - see LICENSE file for details

Developer: Felipe @ Pixelflakes
Built for: Architectural visualization workflows
Powered by: Freepik API + Magnific.ai technology

Special thanks to:

• ComfyUI community
• Freepik API team
• Magnific.ai for upscaling technology

• Freepik API Documentation
• Freepik Developer Dashboard
• ComfyUI
• Magnific.ai

• Issues: GitHub Issues
• API Docs: https://docs.freepik.com
• Freepik Support: https://support.freepik.com

Made with ❤️ for the ComfyUI community

If you find this useful, please ⭐ star the repository!