We automate AI music workflows. For a living.

We have successfully delivered AI-powered automation for numerous clients across music production, content creation, media agencies, and SaaS platforms. From prompt-to-publish pipelines to full music generation factories - we build production-ready workflows that run 24/7.

This node exists because we needed it for real client projects. We built it from the official Suno API documentation, we maintain it, and we own the intellectual property.

If you're using Suno AI and looking to automate your music generation workflows - AI music creation, lyrics generation, audio processing, vocal separation, video generation - we've done it before and would be happy to do it for you.

What you get

| Node | Type | What it does | |------|------|-------------| | Suno | Action Node | Full coverage across 11 resources with 24 operations covering all 28 Suno API endpoints - music generation, lyrics, audio processing, vocal separation, MIDI, video, file upload, and more |

AI Agent ready - Works with usableAsTool: true, so you can plug it directly into n8n AI Agent workflows for intelligent music automation.

Complete API Coverage (28 Endpoints)

Music Generation (6 operations)

| Operation | Endpoint | Description | |-----------|----------|-------------| | Generate Music | POST /api/v1/generate | Generate AI music from prompt with V4/V4.5/V5 models | | Extend Music | POST /api/v1/generate/extend | Continue existing tracks from a timestamp | | Upload & Cover | POST /api/v1/generate/upload-cover | Create new music based on uploaded audio | | Upload & Extend | POST /api/v1/generate/upload-extend | Extend music from uploaded audio | | Mashup | POST /api/v1/generate/mashup | Blend two audio tracks into a mashup | | Replace Section | POST /api/v1/generate/replace-section | Replace a segment of an existing track |

Vocals (2 operations)

| Operation | Endpoint | Description | |-----------|----------|-------------| | Add Vocals | POST /api/v1/generate/add-vocals | Add vocal layers to instrumental tracks | | Add Instrumental | POST /api/v1/generate/add-instrumental | Add instrumental accompaniment to vocals |

Lyrics (2 operations)

| Operation | Endpoint | Description | |-----------|----------|-------------| | Generate Lyrics | POST /api/v1/lyrics | AI-powered lyrics generation from prompt | | Get Timestamped Lyrics | POST /api/v1/generate/get-timestamped-lyrics | Word-level timing data with waveform |

Audio Processing (6 operations)

| Operation | Endpoint | Description | |-----------|----------|-------------| | Separate Vocals | POST /api/v1/vocal-removal/generate | Split into 2 stems or 12 stems | | Convert to WAV | POST /api/v1/wav/generate | Lossless WAV conversion | | Generate MIDI | POST /api/v1/midi/generate | Per-instrument MIDI note data | | Create Music Video | POST /api/v1/mp4/generate | MP4 with synced visualizations | | Boost Style | POST /api/v1/style/generate | Enhance music style descriptions | | Generate Cover Image | POST /api/v1/suno/cover/generate | AI cover artwork (2 variations) |

Persona (1 operation)

| Operation | Endpoint | Description | |-----------|----------|-------------| | Generate Persona | POST /api/v1/generate/generate-persona | Create reusable music personas |

Task Details (7 operations)

| Operation | Endpoint | Description | |-----------|----------|-------------| | Get Music Details | GET /api/v1/generate/record-info | Poll music generation status | | Get Lyrics Details | GET /api/v1/lyrics/record-info | Poll lyrics generation status | | Get WAV Details | GET /api/v1/wav/record-info | Poll WAV conversion status | | Get Vocal Separation Details | GET /api/v1/vocal-removal/record-info | Poll separation status + stem URLs | | Get Video Details | GET /api/v1/mp4/record-info | Poll video generation status | | Get MIDI Details | GET /api/v1/midi/record-info | Poll MIDI generation + note data | | Get Cover Details | GET /api/v1/suno/cover/record-info | Poll cover image status |

Account (1 operation)

| Operation | Endpoint | Description | |-----------|----------|-------------| | Get Credits | GET /api/v1/generate/credit | Check remaining API credits |

File Upload (3 operations)

| Operation | Endpoint | Description | |-----------|----------|-------------| | Upload Base64 | POST /api/file-base64-upload | Upload via base64 encoding | | Upload Stream | POST /api/file-stream-upload | Upload via binary stream | | Upload URL | POST /api/file-url-upload | Upload from remote URL |

AI Model Support

| Model | Max Duration | Description | |-------|-------------|-------------| | V5 | 8 min | Superior musical expression, fastest generation | | V4.5 Plus | 8 min | Richer sound, new creation methods | | V4.5 All | 8 min | Better song structure | | V4.5 | 8 min | Superior genre blending, faster output | | V4 | 4 min | Best audio quality, refined structure |

Enterprise Security

| Protection | Implementation | |-----------|---------------| | SSRF Prevention | All URL fields (callback, upload, file) validated against private IPs, localhost, IPv6 private ranges. HTTPS-only enforcement. | | ID Injection | All task/audio IDs validated with assertSafeId - alphanumeric + hyphens only, path traversal blocked | | Input Validation | Model-dependent length limits on prompt (500-5000), style (200-1000), title (80-100). Weight fields bounded 0.00-1.00. | | Error Safety | Error messages truncated to 1000 chars, raw user input never echoed, API keys never logged | | Rate Limiting | 429/430 codes trigger automatic retry with exponential backoff + jitter | | Request Timeout | 30-second timeout on all API calls | | Path Sanitization | Percent-decoded traversal detection, safe character allowlist |

489 Tests Passing

| Test Suite | Tests | Coverage | |-----------|-------|---------| | Transport Layer | 80 | SSRF, retry, error parsing, ID validation | | Validators | 58 | Model-dependent limits, weights, durations | | Phase 1 Handlers | 25 | Music generation, vocals, lyrics | | Phase 2 Handlers | 16 | Vocal separation, conversion, style boost, cover | | Phase 3 Handlers | 18 | Task details, credits, file upload, persona | | Security | 269 | ID injection, SSRF vectors, error leakage | | Error Handling | 27 | All 14 Suno error codes mapped correctly | | Compliance | 21 | HTTPS enforcement, protocol rejection, OWASP |

Installation

From n8n (Recommended)

1. Go to Settings > Community Nodes
2. Enter n8n-nodes-suno
3. Click Install

Manual

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

Quick Setup

1. Install the node in n8n
2. Get your API key from the Suno API Key Management Page
3. Add Suno API credentials in n8n with your API key
4. Start building music generation workflows

Why this node?

• Complete API coverage - all 28 endpoints, every single field, zero gaps
• Enterprise security - SSRF protection, ID injection prevention, input validation, error safety
• 489 tests with security, compliance, and handler coverage
• AI Agent compatible - usableAsTool: true for n8n AI Agent workflows
• Full TypeScript with strict typing
• Model-aware validation - prompt/style/title limits enforced per AI model version
• Dual base URL support - API and file upload endpoints handled transparently
• Production-tested - used in real client automation workflows
• Actively maintained by the team that built it

Need more than a node?

This community node covers the complete Suno API. But if you need:

• Custom workflow design - prompt-to-publish, batch music generation, content pipelines
• Suno + other AI tools integration (Eleven Labs, OpenAI, Midjourney)
• AI-powered content factories, music-on-demand platforms, automated publishing
• Advanced integrations - CMS publishing, social media distribution, analytics
• Ongoing maintenance and monitoring of your automation

We've delivered all of this for our clients and would be happy to discuss your specific requirements.

License

Fair Use Code License (FUCL)

Copyright (c) 2026 Mirza Iqbal / next8n. All rights reserved.

This node is published as an n8n community node for the benefit of the Suno AI + n8n ecosystem. However, the intellectual property, source code, and all associated rights are owned exclusively by the copyright holder.

Permitted:

• Install and use this node for your own internal workflows and business automation

Prohibited without explicit written consent:

• Copying, forking, or reproducing the source code in any form
• Commercial redistribution, resale, sublicensing, or white-labeling
• Creating derivative works or competing products based on this code
• Public redistribution of modified or unmodified versions
• Using the Software as part of a commercial service offering
• Removing or altering copyright notices or attribution

Attribution: This node was developed and is actively maintained by next8n. Attribution must be preserved in all copies.

This software is provided "as is", without warranty of any kind, express or implied.

We built this code for the community. We reserve the rights to our code only -- not to any names, logos, or trademarks.

Trademark & legal notice: "Suno" and the Suno logo are trademarks of Suno, Inc. We do not claim ownership of the Suno brand, name, or logo. This community node is not affiliated with, endorsed by, or sponsored by Suno, Inc. All trademarks, service marks, trade names, and logos referenced herein belong to their respective owners. This node was developed independently as a community contribution, using publicly available API documentation, for the sole purpose of enabling interoperability between n8n and the Suno API -- as permitted under EU Directive 2009/24/EC (Software Directive, Article 6) and applicable law. No Suno proprietary code is included; all interactions use publicly documented REST API endpoints. This is an original, independently authored work; the source code of this integration node is the intellectual property of the copyright holder, and is the only thing covered by the FUCL license above. The use of third-party APIs for interoperability purposes does not constitute infringement under EU or international law (see also Google LLC v. Oracle America, Inc., 593 U.S. 1 (2021) on API fair use).

Interested in collaborating or contributing? We're open to partnerships. Let's talk.

For commercial licensing, partnership, or custom development: services.next8n.com