Generate Music · V4.5

A full song from a text box, sitting on your canvas as a purple node. That's the pitch, and it's real: this node posts to KIE.ai's Suno endpoint and hands you back a normal ComfyUI AUDIO object you can wire into SaveAudio, a music video pipeline, or a lip-sync stage. The catch is that nothing runs on your machine - no checkpoint, no VRAM, no download - and every run costs credits.

What it actually does

KIE.ai is one of the resellers that proxy closed models behind a single API key, and Suno is the one job where the API still clearly beats open weights: best-in-class songs with clean vocals is the thing local music models haven't closed yet (ACE-Step gets close on instrumentals, still mumbles on lead vocals). This node is the pack's one-model-per-page approach applied to that endpoint - the Suno V4.5 version, split into its own node rather than hiding behind a dropdown.

Under the hood the node builds the request body, sends it to POST /api/v1/jobs/createTask, then blocks and polls the Suno record-info endpoint every 2.5 seconds until the task succeeds or timeout_seconds (default 1200 - twenty minutes) runs out. Music jobs take a couple of minutes, so that default is generous on purpose. KIE's transport model for this call is ai-music-api/generate; your version choice rides along as model: V4_5 inside the input payload.

The three switches that decide everything

Suno's V4.5 request shape is fussier than it looks, and the tooltips spell it out properly:

• custom_mode (default true) - advanced mode. Your prompt becomes exact lyrics rather than a description.
• instrumental (default true) - no vocals. In custom mode that means style and title are all that's required.
• prompt - in custom mode with instrumental on, your text is basically inert. Want it sung? Set instrumental off and write lyrics in prompt or in the lyrics field.

So the honest starting recipe is: pick a style ("lo-fi jazz, brushed drums, warm tape"), give it a title, flip instrumental off, and paste lyrics. Everything else - style_weight, weirdness_constraint, audio_weight, negative_tags, vocal_gender - is seasoning. vocal_gender is worth knowing about: the doc admits it "only increases probability" and cannot guarantee male/female output. It's a nudge, not a control.

The reference sockets (image_urls, audio_1–audio_3, video_1–video_3) are the interesting ones - Suno calls this inspiration mode. They also come with a trap, see below.

Outputs

Seven of them, and you'll use two. audio is the decoded track, ready for SaveAudio or a video node. all_urls_json holds every result URL - Suno typically returns two takes per generation, and audio is the first one, so if you prefer the other take, that's where it is. The rest are plumbing: url, task_id, raw_json, plus credits_consumed and credits_left, which also render on the node face after each run so you can watch your balance bleed.

Installing

In ComfyUI Manager, search the pack title ComfyUI-KIE-Nodes-Next ("KIE.ai Nodes Next"). Manual route:

cd ComfyUI/custom_nodes
git clone https://github.com/felipederosilva/ComfyUI-KIE-Nodes-Next
# restart ComfyUI

Dependencies are just requests, Pillow, numpy and PyYAML - no models, no CUDA. Then set your key once, in Settings → KIE.ai Nodes Next → Connection → Paste / replace KIE.ai API key. It validates the key against KIE before saving, stores it outside your workflow JSON, and shows a masked fingerprint plus a ✅ CONNECTED status. Servers can use the KIE_API_KEY env var instead; it wins over the saved key.

Where people get burned

Connect an image and your widgets quietly vanish. The pack deliberately forces custom_mode=false whenever an image_urls socket is filled, and strips the custom-only fields (style, title, duration, style_weight, persona_id, instrumental and friends) before submitting. You'll see a console line explaining it. It's protecting you from a provider-side rejection, but it does mean the image path and the style path don't mix.

Half the widgets are no-ops on V4.5. duration, persona_model and non-custom variety are documented as valid only for V5.5/V6/V6_MINI/V6_WILD. Turning them does nothing here.

The version is legacy. KIE's parameter docs tag V4, V4.5, V4.5PLUS, V4.5ALL, V5 and V5.5 as (Discontinued), with V6/V6_MINI/V6_WILD current. This node exists because the docs still publish it - but starting fresh, use the V6 sibling in the same folder.

persona_id ships a placeholder. It defaults to the literal string persona_123. Clear it if you're not using one; empty optionals get dropped before submission.