NodaroAccount
Nodaro Docs
DocumentationNode ReferenceModelsTemplatesAI Agents (MCP)DevelopersSelf-hostingResearchCompare
Tools reference

Music

Create songs and instrumentals with Suno and other music models, then extend, cover, mash up, edit, split and convert them with Nodaro's MCP music tools.

The music tools let an assistant make and edit music in Nodaro. generate_music creates a track from a prompt, or follows a reference track with MiniMax Music. The suno_ tools use Suno's full feature set: songs with your own lyrics, covers, extensions, mashups, section replacement, stems, WAV files and music videos. Every tool needs the workflows:execute permission and returns a job id.

ToolWhat it doesCredits
generate_musicA track from a prompt33 with Suno, 198 with MiniMax
suno_generateA song with Suno's full controls33
suno_lyricsSong lyrics from a theme11
suno_style_boostRicher style tags from a short description11
suno_extendContinues a Suno song33
suno_upload_extendContinues an uploaded track33
suno_coverThe same song in a new style33
suno_mashupBlends two tracks33
suno_replace_sectionGenerates one part of a Suno song again22
suno_add_vocalsAdds vocals to a Suno instrumental33
suno_add_instrumentalAdds an instrumental layer to a Suno song33
suno_separate_stemsSplits any audio into vocals and instrumental, stems, or one instrument44, 143 for all the stems in one run, or 88 for one instrument
suno_convert_wavConverts a Suno song to WAV11
suno_music_videoMakes a music video from a Suno song11

The tools that edit a Suno song need the Nodaro job id of a song made with Suno, passed as audio_asset_id. The Suno ids they need are looked up on the server.

generate_music

Creates a music track from a prompt. With a Suno model, the default, it works like the Suno Create Music node. With minimax, it runs MiniMax Music like the Generate Music node, and it needs a reference track.

Permission: workflows:execute. Credits: 33 with a Suno model, 198 with MiniMax.

ParameterTypeNotes
promptstringThe music you want, up to 2,000 characters. Required unless a preset supplies it.
modelstringsuno-v6 (default, rich detail and natural vocals), suno-v6_wild (bolder, less predictable), suno-v6_mini (faster), suno-v5_5, suno-v5, suno, or minimax (MiniMax Music), which follows a reference track. suno-v5-5 is also accepted for suno-v5_5.
reference_audio_urlstringWith minimax: the public URL of the song, voice or instrumental that MiniMax Music follows.
reference_audio_asset_idstringWith minimax: the Nodaro job id of an audio result to follow. It is used when reference_audio_url is not set.
lyricsstringThe exact words to sing, up to 2,000 characters, with section tags such as [Verse] and [Chorus] on their own lines. Lyrics switch Suno to custom mode, where they are sung as written. Without lyrics, the model writes its own.
titlestringThe song title, up to 80 characters. Custom mode needs one; without it, the title is "Untitled".
instrumentalbooleanMusic without vocals.
genre, moodstringThe genre and the mood.
durationnumberThe length of a short track, up to 30 seconds. Without it, the model chooses the length. For a set length of up to 360 seconds, use suno_generate. With Suno, duration works only in custom mode on a V6 model, and a length under 10 seconds is raised to 10. On an instrumental track, a title or a duration turns on custom mode by itself. MiniMax Music ignores it.
presetIdstringA preset such as Lo-fi Study, Cinematic Trailer or EDM Drop.

With minimax, pass reference_audio_url or reference_audio_asset_id. Without a reference, the tool returns an error that asks for one, and no job starts. The Suno models need no reference and ignore both parameters.

Returns: a job id.

suno_generate

Creates an original song with Suno, with every Suno control. It works like the Suno Create Music node. The job output holds the Suno ids that the other suno_ tools use.

Permission: workflows:execute. Credits: 33.

ParameterTypeNotes
promptstringRequired. The song, or the inspiration for it, up to 5,000 characters. In custom mode, it describes the style.
modelstringV6 (default), V6_WILD, V6_MINI, V5_5, V5, V4_5PLUS, V4_5ALL, V4_5 or V4.
custom_modebooleanUses your lyrics and style exactly as written.
lyricsstringThe full lyrics, up to 5,000 characters. Custom mode only.
stylestringStyle tags, such as lo-fi hip-hop, melancholy, piano, up to 500 characters.
negative_stylestringStyles to avoid, up to 500 characters.
titlestringUp to 80 characters.
instrumentalbooleanMusic without vocals.
vocal_genderstringmale or female.
durationnumberThe song length, from 10 to 360 seconds. Only in custom mode on a V6 model.
style_weight, weirdness, audio_weightnumberFrom 0 to 1: how strongly the style applies, how unusual the result is, and the weight of the audio input.

Returns: a job id.

suno_lyrics

Writes song lyrics from a theme, such as "a heartbreak ballad about summer". Use the result as lyrics in suno_generate with custom mode.

Permission: workflows:execute. Credits: 11.

ParameterTypeNotes
promptstringRequired. The theme, up to 1,000 characters.

Returns: a job id. The lyrics are in the job output, and the card shows them with a Copy button.

suno_style_boost

Turns a short style description, such as "lo-fi chill", into richer style tags. Use the result as style in suno_generate.

Permission: workflows:execute. Credits: 11.

ParameterTypeNotes
contentstringRequired. The style to enhance, up to 5,000 characters.

Returns: a job id. The improved style is in the job output.

suno_extend

Continues a song made with Suno.

Permission: workflows:execute. Credits: 33.

ParameterTypeNotes
audio_asset_idstringRequired. The Nodaro job id of the Suno song.
continue_atnumberThe second of the song where the extension starts.
prompt, style, titlestringSteer the extension.
vocal_genderstringmale or female.
modelstringV6 (default) or another Suno version.

Returns: a job id.

suno_upload_extend

Continues a track that was not made with Suno, from a public URL. For a Suno song, use suno_extend.

Permission: workflows:execute. Credits: 33.

ParameterTypeNotes
audio_urlstringRequired. The public URL of the track.
continue_atnumberRequired. The second where Suno continues.
style, negative_style, title, vocal_gender, modelAs on suno_generate.
use_default_paramsbooleantrue lets Suno choose the style and title. The default, false, uses your style and title.

Returns: a job id.

suno_cover

Makes a cover of a track: the same melody and lyrics in a new musical style. The source can be any Nodaro audio, not only a Suno song.

Permission: workflows:execute. Credits: 33.

ParameterTypeNotes
promptstringRequired. The style of the cover, up to 5,000 characters.
audio_url or audio_asset_idstringThe source track.
instrumentalbooleanAn instrumental cover, without vocals.
lyricsstringNew lyrics. Without them, Suno reuses the lyrics it hears in the source.
custom_mode, style, title, vocal_gender, modelAs on suno_generate.

Returns: a job id. Only cover audio you own; the song-from-reference recipe explains how to make a similar song from someone else's track. See Content recipes.

suno_mashup

Blends two tracks into a mashup.

Permission: workflows:execute. Credits: 33.

ParameterTypeNotes
audio_url_1 or audio_asset_id_1stringThe first track.
audio_url_2 or audio_asset_id_2stringThe second track.
custom_mode, style, negative_style, title, vocal_genderAs on suno_generate.

Returns: a job id.

suno_replace_section

Generates one part of a Suno song again, and keeps the rest.

Permission: workflows:execute. Credits: 22.

ParameterTypeNotes
audio_asset_idstringRequired. The Nodaro job id of the Suno song.
infill_start_s, infill_end_snumberRequired. The part to replace, in seconds. It must last 6 to 60 seconds and at most half of the song.
promptstringRequired. What the new part should contain, up to 5,000 characters.
tagsstringRequired. Style tags for the new part, up to 500 characters.
negative_tagsstringStyles to keep out of the new part.
full_lyricsstringThe lyrics of the whole song after the change, both changed and unchanged parts.
titlestringUp to 80 characters.

Returns: a job id.

suno_add_vocals

Adds vocals to a Suno instrumental.

Permission: workflows:execute. Credits: 33.

ParameterTypeNotes
audio_asset_idstringRequired. The Nodaro job id of the Suno instrumental.
modelstringV6 (default), V6_WILD, V6_MINI, V4_5PLUS, V5 or V5_5.

Returns: a job id.

suno_add_instrumental

Adds an instrumental layer to a Suno song.

Permission: workflows:execute. Credits: 33.

ParameterTypeNotes
audio_asset_idstringRequired. The Nodaro job id of the Suno song.
modelstringV6 (default), V6_WILD, V6_MINI, V4_5PLUS, V5 or V5_5.

Returns: a job id.

suno_separate_stems

Splits any audio with Suno into vocals and instrumental, into a stem for each instrument, or into one named instrument and the song without it. The audio can be a Suno song, an upload or any generated audio. Suno refuses commercially released recordings and audio over 20 MB. For those, set fallback_to_demucs, or use separate_audio. It works like the Suno Separate node.

Permission: workflows:execute. Credits: 44 with separate_vocal, 143 with split_stem, 88 with split_stem_advanced. A run that falls back to Demucs is charged the Audio Separation price instead.

ParameterTypeNotes
audio_url or audio_asset_idstringExactly one of the two. audio_url is any audio by link. audio_asset_id is a Nodaro audio job or an uploaded audio file. A Suno song is separated by its Suno ids.
typestringseparate_vocal (default) for vocals and instrumental, split_stem for every instrument, or split_stem_advanced for one instrument.
stem_namestringsplit_stem_advanced only. One of Suno's instrument names, such as Piano or Lead Vocal (default).
fallback_to_demucsbooleanWhen Suno refuses, run Demucs instead and charge its price. Vocals and full stems only. Default false.

Returns: a job id. With split_stem_advanced, the job's isolatedUrl and withoutUrl hold the first take, and isolated2Url and without2Url the second.

suno_convert_wav

Converts a Suno song to a lossless WAV file.

Permission: workflows:execute. Credits: 11.

ParameterTypeNotes
audio_asset_idstringRequired. The Nodaro job id of the Suno song.

Returns: a job id.

suno_music_video

Makes an MP4 music video from a Suno song. The pictures come from the audio, and there is no style or prompt to set. It works like the Music Video node.

Permission: workflows:execute. Credits: 11.

ParameterTypeNotes
audio_asset_idstringRequired. The Nodaro job id of a Suno song. Songs from other models, such as MiniMax or ElevenLabs, cannot be used.

Returns: a job id.

Frequently asked questions

What is the difference between generate_music and suno_generate?

generate_music is the simple tool for a track from a prompt, with Suno V6 by default. Its minimax model, MiniMax Music, follows a reference track that you pass as reference_audio_url or reference_audio_asset_id. suno_generate exposes Suno's own controls, such as custom mode with your lyrics and style, weirdness, style weight and negative styles.

How much does a Suno song cost?

33 credits per generation, on every Suno version. Lyrics, style boost, WAV conversion and music videos cost 11 credits, and replacing a section costs 22.

Can I split any song into stems?

Yes. suno_separate_stems takes any audio, a Suno song, an upload or a link, up to 20 MB. Suno refuses commercially released recordings. For those, use separate_audio, which runs Demucs, or set fallback_to_demucs.

How do I make a song with my own lyrics?

Call suno_generate with custom_mode set to true, your lyrics with section tags such as [Verse] and [Chorus], and a style. With generate_music, passing lyrics switches to the same custom mode.

Last updated on

On this page