@hienhoceo/n8n-nodes-zukijourney

Introducing @hienhoceo/n8n-nodes-zukijourney, a community node for n8n that integrates Zukijourney's powerful, free, and multi-model AI capabilities into your workflows. This package provides an OpenAI-compatible API, making it easy to leverage a wide range of advanced AI functions. Developed by DPS.MEDIA JSC, a trusted leader in digital marketing solutions since 2017, this tool is designed for professional and enterprise-ready automation.

🚀 Key Features

Free and Flexible AI Access

Connect to a vast library of AI models, including popular ones like GPT-4o, Llama, and Claude. Zukijourney's API stands out by offering a powerful freemium model, allowing you to access these diverse and cutting-edge models without initial cost.

Comprehensive AI Operations

A single consolidated node architecture gives you a complete suite of AI tools:

• AI Chat: Engage with advanced conversational models that support tool/function calling and vision capabilities (image analysis)
• AI Image Generation & Upscaling: Create high-quality images and enhance their resolution with sophisticated AI algorithms
• AI Text to Speech: Convert text into natural-sounding speech for accessibility and content creation
• Google Translate: Get intelligent, multilingual text translation with automatic language detection

Enterprise-Ready Integration

• OpenAI-compatible API: Seamlessly integrate with existing workflows that use OpenAI's API structure
• Dynamic Model Loading: The node automatically handles model selection and fallbacks, ensuring reliable performance
• Simplified Workflows: A single, consolidated node reduces complexity, making your automations cleaner and more efficient

📦 Installation & Configuration

Quick Setup

1. In n8n, go to Settings → Community Nodes
2. Search for @hienhoceo/n8n-nodes-zukijourney and click Install
3. ⚠️ Important: A full restart of n8n is required after installation or updates

API Key Setup

1. Join the Zukijourney Discord Server: https://discord.gg/zukijourney
2. Use the command /user get-key in any channel (e.g., #ask-staff) to get your free API key
3. Create a new Zukijourney API credential in n8n with your API key and the base URL https://api.zukijourney.com/v1

🎯 Use Cases

Business Applications

• Power intelligent chatbots with advanced AI capabilities
• Automate content creation with AI image and text generation
• Implement content moderation with AI classification systems
• Enhance customer service with multilingual support

Technical Integration

• Advanced workflow automation for tasks like podcast transcription
• Content localization and translation services
• Building recommendation engines with AI embeddings
• Creating accessible content with text-to-speech capabilities

🔧 Available Operations

AI Chat

• Advanced conversational AI with tool/function calling
• Vision capabilities for image analysis
• Multiple model support with automatic fallback

AI Generate Image

• Create images from text prompts
• Multiple size and quality options
• Various model support (DALL-E, Stable Diffusion, etc.)

AI Upscale Image

• Enhance image resolution with AI
• Support for multiple image formats
• Batch processing capabilities

AI Text to Speech

• Natural-sounding voice synthesis
• Multiple voice options
• Various audio formats supported

Google Translate

• Automatic language detection
• Translation to English
• High-quality translation models

⚙️ Configuration

API Credential Configuration

Create a new Zukijourney API credential with:

• API Key: Your Zukijourney API key (obtained from Discord)
• Base URL: https://api.zukijourney.com/v1
• Organization: Optional organization ID

Node Configuration

Each operation includes optimized parameters for:

• Model selection with dynamic loading
• Quality and performance settings
• Error handling and retry logic
• Comprehensive output options

🛡️ Security & Compliance

• API Key Security: Credentials are securely stored using n8n's credential management system
• Data Privacy: All API calls are made directly to Zukijourney's servers
• Rate Limiting: Built-in retry logic with exponential backoff
• Error Handling: Comprehensive error handling with informative messages

🔍 Troubleshooting

Common Issues

"Unrecognized node type" Error

• This usually means you need to restart n8n completely
• Docker users: restart your container
• npm users: restart your n8n service

API Key Issues

• Check your API key is correct (without "zu-" prefix)
• Verify your base URL is accessible
• Try refreshing credentials in n8n

Performance Issues

• Enable retry/backoff for high-volume operations
• Monitor API usage and rate limits
• Use appropriate model settings for your use case

🏢 About DPS.MEDIA JSC

Since 2017, DPS.MEDIA JSC has been a leading provider of digital marketing and AI automation solutions. With a focus on comprehensive digital transformation, we have served over 5,400 SME customers, helping them leverage cutting-edge technology for business growth.

Our Expertise:

• Digital Marketing Strategy & Implementation
• AI & Automation Solutions
• Enterprise Workflow Integration
• Content Creation & Management
• E-commerce Optimization

Why Choose Us:

• ✅ 7+ years industry experience
• ✅ 5,400+ satisfied customers
• ✅ Expert team of digital specialists
• ✅ Cutting-edge technology solutions
• ✅ Results-driven approach

📍 56 Nguyễn Đình Chiểu, Phường Tân Định, Thành phố Hồ Chí Minh, Việt Nam
📞 0961545445
🌐 https://dps.media/
📧 [email protected]

💝 Support the Developer

If you find this package valuable for your automation projects, please consider supporting its continued development:

Nếu package này hữu ích cho dự án automation của bạn, có thể ủng hộ tác giả:

🤝 Donation Options

PayPal

• https://paypal.me/hoquanghien

Your support helps maintain and improve this package, enabling new features and community support!

📄 License

MIT License - see LICENSE file for details.

🤝 Community & Support

• Discord Community: https://discord.gg/zukijourney
• GitHub Issues: https://github.com/hienhoceo-dpsmedia/n8n-nodes-zukijourney/issues
• n8n Community: https://community.n8n.io/
• Zukijourney Documentation: https://docs.zukijourney.com

📋 Changelog

v0.3.4

• Updated node naming for consistency and professional branding
• Added comprehensive documentation with security information
• Enhanced feature descriptions and use cases
• Added donation information

v0.3.3

• Added AI Image Upscale functionality
• Support for multiple image input types (URL, binary data, properties)
• Form-data multipart upload implementation

v0.1.0

• Initial release
• Support for all Zukijourney API endpoints
• Comprehensive test coverage
• OpenAI-compatible API integration