n8n-nodes-musicgpt

Official n8n community node for MusicGPT - AI-powered audio processing, music generation, and voice transformation.

Features

• 🎵 Audio Generation: Create music from text prompts or lyrics
• 🎙️ Text-to-Speech: Convert text to natural-sounding speech in 10+ languages
• 🎤 Voice Transformation: Change voices in audio files with 100+ voice options
• 🎸 Stem Separation: Extract vocals, instruments, and 20+ individual stems
• 🎛️ Audio Processing: Denoise, deecho, dereverb, master, trim, speed, convert
• 🎹 Advanced Generation: Remix, extend, inpaint, add vocals, generate sound effects
• 🔍 Voice Search: Find and list available voices dynamically
• ⚡ Triggers: Monitor conversions and automate workflows
• 🌐 Webhook Support: Async processing with callbacks
• 📦 Binary File Handling: Process files from previous nodes seamlessly

Quick Start

Installation

Via n8n Community Nodes (Recommended)

1. Open your n8n instance
2. Go to Settings → Community Nodes
3. Click Install
4. Enter: n8n-nodes-musicgpt
5. Click Install

Via npm (Self-Hosted)

cd ~/.n8n/nodes
npm install n8n-nodes-musicgpt

Setup Credentials

1. Get your API key from musicgpt.com
2. In n8n, go to Credentials → New
3. Search for "MusicGPT API"
4. Enter your API key

Your First Workflow

Manual Trigger →
MusicGPT (Generate Audio):
  - Prompt: "Upbeat electronic dance music"
→ Wait (45 seconds) →
MusicGPT (Get Conversion by ID) →
Process result

Operations Overview

📦 What's Included

• 1 Action Node: MusicGPT (25 operations across 4 resources)
• 1 Trigger Node: MusicGPT Trigger (2 trigger types)

Audio Generation (6 operations)

| Operation | Description | Processing Time | |-----------|-------------|----------------| | Generate Audio | Create music from prompts or lyrics | 30-60s | | Text to Speech | Convert text to speech (10+ languages) | 15-25s | | Voice Changer | Transform voices in audio | 20-40s | | Cover Song | Create AI covers with different voices | 40-70s | | Extraction | Separate 20+ stems (vocals, instruments, etc.) | 40-90s | | Denoise | Remove background noise | 15-25s |

Audio Processing (9 operations)

| Operation | Description | Processing Time | |-----------|-------------|----------------| | Deecho | Remove echo | 20-30s | | Dereverb | Remove reverb | 20-30s | | Audio Mastering | Master to professional quality | 30-50s | | Trim Audio | Cut to time range | 5-15s | | Change Speed | Adjust playback speed | 10-20s | | Audio to MIDI | Convert to MIDI notation | 30-45s | | Extract Key/BPM | Detect key and tempo | 10-20s | | File Convert | Convert formats/sample rates | 15-30s | | Transcribe | Speech to text (10+ languages) | 15-40s |

Advanced Generation (6 operations)

| Operation | Description | Processing Time | |-----------|-------------|----------------| | Remix | AI-powered remixing | 60-120s | | Extend | Extend audio duration | 60-100s | | Inpaint | Replace audio sections | 40-70s | | Sing Over Instrumental | Add vocals to instrumentals | 60-100s | | Sound Generator | Generate sound effects | 20-40s | | Prompt to Lyrics | Generate lyrics | 5-15s |

Searches (4 operations)

| Operation | Description | |-----------|-------------| | Get All Voices | List available voices with pagination | | Search Voices | Search voices by name | | Get Conversion by ID | Check status and retrieve results | | Get Conversions by User | Get user history with filters |

Triggers (2 types)

| Trigger | Description | |---------|-------------| | Get Conversion | Poll specific conversion until complete | | New Conversions | Trigger on new user conversions |

Documentation

| Resource | Description | |----------|-------------| | Full Documentation | Complete API reference with parameters, examples, and patterns | | Quick Reference | Fast lookup for all operations and parameters |

Usage Examples

Example 1: Text-to-Speech Podcast Generator

Schedule Trigger (weekly) →
Fetch Script (HTTP Request) →
Text to Speech:
  - Text: {{ $json.script }}
  - Language: English
  - Voice: Professional narrator
→ Wait (20s) →
Get Conversion →
Upload to Podcast Host →
Notify Team (Slack)

Example 2: AI Cover Song API

Webhook (receive song URL + artist) →
Search Voices (find artist voice) →
Cover Song (generate with voice) →
Respond (task_id)

(Separate Webhook)
Completion Callback →
Upload to Storage →
Notify User

Example 3: Audio Processing Pipeline

File Upload Trigger →
Parallel Processing:
  ├─ Denoise
  ├─ Extract Key/BPM
  └─ Transcribe
→ Merge Results →
Audio Mastering →
Save to Database

Example 4: Music Production Workflow

Manual Trigger →
Generate Audio (from lyrics) →
Wait (45s) →
Get Conversion →
Extraction (separate stems) →
Wait (60s) →
Remix (transform style) →
Download & Archive

Example 5: Automated Content Creation

MusicGPT Trigger (New Conversions) →
Filter (music_generation, completed) →
Auto-Master Audio →
Convert to Multiple Formats →
Upload to CDN →
Update Database →
Email Notification

Supported Formats & Features

Audio Formats

• Input: MP3, WAV, FLAC, OGG, AAC, WEBM, M4A
• Output: MP3, WAV, FLAC, OGG, AAC, WEBM

Languages (TTS & Transcription)

English, Spanish, French, German, Italian, Portuguese, Chinese, Japanese, Korean, Auto-detect

Available Stems (Extraction)

• Vocals: vocals, male_vocal, female_vocal, lead_vocal, back_vocal
• Rhythm: drums, kick, snare, toms, hi-hat, ride, crash
• Strings: guitar, bass, rhythm_guitar, solo_guitar, acoustic_guitar, electric_guitar
• Keys: piano, keys, strings, winds
• Full: instrumental (all instruments)

Sample Rates

8kHz, 16kHz, 22.05kHz, 24kHz, 32kHz, 44.1kHz (CD), 48kHz (Pro), 96kHz (Hi-Res), 192kHz (Ultra)

Advanced Features

Webhook Callbacks

Enable async processing for long operations:

{
  "webhook_url": "https://your-webhook.com/callback"
}

Receive completion notifications:

{
  "event": "conversion.completed",
  "task_id": "task_abc123",
  "status": "completed",
  "output_url": "https://cdn.musicgpt.com/result.mp3"
}

Binary File Processing

Process files from previous nodes:

HTTP Request (download) →
  └─ Response: File
MusicGPT:
  └─ Audio Source: File
  └─ Binary Property: "data"

Dynamic Voice Loading

Voice selection fields dynamically load 100+ available voices from the API, with search and filter capabilities.

Troubleshooting

| Issue | Solution | |-------|----------| | "Authentication failed" | Verify API key in credentials | | "Conversion not found" | Increase wait time (operations vary: 15s-120s) | | "Invalid voice_id" | Use "Get All Voices" to see valid IDs | | "File too large" | Compress or split audio files | | "Rate limit exceeded" | Add delays between requests or upgrade plan | | "Binary data error" | Ensure previous node outputs file data |

Contributing

Contributions are welcome! See the GitHub repository for development setup and guidelines.

Support

• 📖 Documentation: DOCUMENTATION.md
• ⚡ Quick Reference: API-REFERENCE.md
• 💬 Community: n8n Forum
• 📧 Email: [email protected]

Resources

• MusicGPT API Docs: docs.musicgpt.com
• n8n Documentation: docs.n8n.io
• Creating n8n Nodes: docs.n8n.io/integrations/creating-nodes
• n8n Community: community.n8n.io

License

MIT License - see LICENSE file for details.

Credits

• MusicGPT API: musicgpt.com
• n8n Platform: n8n.io

Made with ❤️ for the n8n community