npm package: @hienhoceo/n8n-nodes-zukijourney
Description: Professional n8n community node for Zukijourney AI - Free multi-model AI capabilities including Chat, Image Generation & Upscaling, Text-to-Speech, and Translation. OpenAI-compatible API with enterprise-ready integration by DPS.MEDIA JSC. (restart n8n aft
Author: hienhoceo
Latest version: 0.3.5

# @hienhoceo/n8n-nodes-zukijourney

![Zukijourney Logo](https://avatars.githubusercontent.com/u/169627354?s=200&v=4)

**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](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/](https://dps.media/)  
📧 [contact@dps.media](mailto:contact@dps.media)

## 💝 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](https://paypal.me/hoquanghien)

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

## 📄 License

MIT License - see [LICENSE](LICENSE) file for details.

## 🤝 Community & Support

- **Discord Community**: [https://discord.gg/zukijourney](https://discord.gg/zukijourney)
- **GitHub Issues**: [https://github.com/hienhoceo-dpsmedia/n8n-nodes-zukijourney/issues](https://github.com/hienhoceo-dpsmedia/n8n-nodes-zukijourney/issues)
- **n8n Community**: [https://community.n8n.io/](https://community.n8n.io/)
- **Zukijourney Documentation**: [https://docs.zukijourney.com](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