Nodaro ドキュメント
ドキュメントノードリファレンスモデルAI エージェント(MCP)開発者向けセルフホスティングリサーチ
ツールリファレンス

音楽

Suno などの音楽モデルで曲やインストゥルメンタルを作り、Nodaro の MCP 音楽ツールで延長、カバー、マッシュアップ、編集、分割、変換を行います。

音楽ツールを使うと、アシスタントは Nodaro で音楽を作成、編集できます。generate_music はプロンプトからトラックを作るか、MiniMax Music でリファレンストラックをもとに作ります。suno_ で始まるツールでは、Suno の機能をすべて使えます。自分の歌詞を使った曲、カバー、延長、マッシュアップ、セクションの置き換え、ステム、WAV ファイル、ミュージックビデオです。どのツールにも workflows:execute 権限が必要で、ジョブ ID を返します。

ツール機能クレジット
generate_musicプロンプトからトラックを作成Suno では 30、MiniMax では 180
suno_generateSuno のすべてのコントロールで曲を作成30
suno_lyricsテーマから歌詞を作成10
suno_style_boost短い説明から、より豊かなスタイルタグを作成10
suno_extendSuno の曲の続きを作成30
suno_upload_extendアップロードしたトラックの続きを作成30
suno_cover同じ曲を新しいスタイルで作成30
suno_mashup2 つのトラックをブレンド30
suno_replace_sectionSuno の曲の一部を再生成20
suno_add_vocalsSuno のインストゥルメンタルにボーカルを追加30
suno_add_instrumentalSuno の曲にインストゥルメンタルのレイヤーを追加30
suno_separate_stemsSuno の曲を、ボーカルとインストゥルメンタル、またはステムに分割40
suno_convert_wavSuno の曲を WAV に変換10
suno_music_videoSuno の曲からミュージックビデオを作成10

Suno の曲を編集するツールには、Suno で作った曲の Nodaro のジョブ ID を audio_asset_id として渡します。ツールに必要な Suno の ID は、サーバー側で取得されます。

generate_music

プロンプトから音楽トラックを作成します。デフォルトの Suno のモデルでは、Suno 生成(Suno Create Music)ノードと同じように動作します。minimax では、音楽生成(Generate Music)ノードと同じように MiniMax Music を実行します。その場合は、リファレンストラックが必要です。

権限:workflows:execute。クレジット:Suno のモデルでは 30、MiniMax では 180。

パラメーター型説明
promptstring作りたい音楽の説明で、最大 2,000 文字です。プリセットがこの値を指定する場合を除き、必須です。
modelstringsuno-v6(デフォルト。ディテールが豊かで、ボーカルが自然)、suno-v6_wild(より大胆で、予測しにくい)、suno-v6_mini(より高速)、suno-v5_5、suno-v5、suno、またはリファレンストラックをもとに作る minimax(MiniMax Music)です。
reference_audio_urlstringminimax で使います。MiniMax Music がもとにする曲、声、インストゥルメンタルの公開 URL です。
reference_audio_asset_idstringminimax で使います。もとにするオーディオの結果の、Nodaro のジョブ ID です。reference_audio_url が設定されていない場合に使われます。
lyricsstring歌わせる歌詞そのもので、最大 2,000 文字です。[Verse] や [Chorus] などのセクションタグは、それぞれ単独の行に書きます。歌詞を渡すと Suno はカスタムモードに切り替わり、書いたとおりに歌います。歌詞がない場合は、モデルが歌詞を書きます。
titlestring曲のタイトルで、最大 80 文字です。カスタムモードではタイトルが必要です。指定しない場合、タイトルは「Untitled」になります。
instrumentalbooleanボーカルのない音楽にします。
genre, moodstringジャンルとムードです。
durationnumber最大 30 秒です。Suno では、V6 系のモデルのカスタムモードでだけ機能し、10 秒未満の長さは 10 秒に引き上げられます。instrumental のトラックでは、title か duration を指定すると、自動でカスタムモードになります。MiniMax Music では無視されます。
presetIdstring勉強用 Lo-fi、シネマティックな予告編、EDM ドロップなどのプリセットです。

minimax では、reference_audio_url か reference_audio_asset_id を渡します。リファレンスがない場合、ツールはリファレンスを求めるエラーを返し、ジョブは開始されません。Suno のモデルにはリファレンスが不要で、この 2 つのパラメーターは無視されます。

戻り値:ジョブ ID です。

suno_generate

Suno のすべてのコントロールを使って、Suno でオリジナルの曲を作成します。Suno 生成ノードと同じように動作します。ジョブの出力には、ほかの suno_ ツールが使う Suno の ID が含まれます。

権限:workflows:execute。クレジット:30。

パラメーター型説明
promptstring必須。曲、または曲のインスピレーションで、最大 5,000 文字です。カスタムモードでは、スタイルを説明します。
modelstringV6(デフォルト)、V6_WILD、V6_MINI、V5_5、V5、V4_5PLUS、V4_5ALL、V4_5、V4 のいずれかです。
custom_modebooleanlyrics と style を、書いたとおりに使います。
lyricsstring歌詞全体で、最大 5,000 文字です。カスタムモードでのみ使います。
stylestringlo-fi hip-hop, melancholy, piano のようなスタイルタグで、最大 500 文字です。
negative_stylestring避けたいスタイルで、最大 500 文字です。
titlestring最大 80 文字です。
instrumentalbooleanボーカルのない音楽にします。
vocal_genderstringmale か female です。
durationnumber曲の長さで、10〜360 秒です。V6 系のモデルで、カスタムモードのときだけ機能します。
style_weight, weirdness, audio_weightnumber0〜1 です。それぞれ、スタイルを適用する強さ、結果の奇抜さ、オーディオ入力の重みです。

戻り値:ジョブ ID です。

suno_lyrics

「a heartbreak ballad about summer」のようなテーマから、曲の歌詞を書きます。結果は、カスタムモードの suno_generate で lyrics として使います。

権限:workflows:execute。クレジット:10。

パラメーター型説明
promptstring必須。テーマで、最大 1,000 文字です。

戻り値:ジョブ ID です。歌詞はジョブの出力に含まれ、カードには歌詞とコピーボタンが表示されます。

suno_style_boost

「lo-fi chill」のような短いスタイルの説明を、より豊かなスタイルタグにします。結果は、suno_generate の style として使います。

権限:workflows:execute。クレジット:10。

パラメーター型説明
contentstring必須。充実させたいスタイルで、最大 5,000 文字です。

戻り値:ジョブ ID です。改善されたスタイルは、ジョブの出力に含まれます。

suno_extend

Suno で作った曲の続きを作ります。

権限:workflows:execute。クレジット:30。

パラメーター型説明
audio_asset_idstring必須。Suno の曲の Nodaro のジョブ ID です。
continue_atnumber延長を始める、曲の中の位置(秒)です。
prompt, style, titlestring延長部分の方向性を指定します。
vocal_genderstringmale か female です。
modelstringV6(デフォルト)か、ほかの Suno のバージョンです。

戻り値:ジョブ ID です。

suno_upload_extend

Suno 以外で作ったトラックの続きを、公開 URL から作ります。Suno の曲には、suno_extend を使います。

権限:workflows:execute。クレジット:30。

パラメーター型説明
audio_urlstring必須。トラックの公開 URL です。
continue_atnumber必須。Suno が続きを始める位置(秒)です。
style, negative_style, title, vocal_gender, modelsuno_generate と同じです。
use_default_paramsbooleantrue にすると、Suno がスタイルとタイトルを選びます。デフォルトの false では、指定した style と title を使います。

戻り値:ジョブ ID です。

suno_cover

トラックのカバーを作ります。メロディーと歌詞はそのままで、音楽のスタイルが新しくなります。元の音源は、Suno の曲に限らず、Nodaro のどのオーディオでもかまいません。

権限:workflows:execute。クレジット:30。

パラメーター型説明
promptstring必須。カバーのスタイルで、最大 5,000 文字です。
audio_url or audio_asset_idstring元のトラックです。
instrumentalbooleanボーカルのない、インストゥルメンタルのカバーにします。
lyricsstring新しい歌詞です。指定しない場合、Suno は元の音源から聞き取った歌詞を使います。
custom_mode, style, title, vocal_gender, modelsuno_generate と同じです。

戻り値:ジョブ ID です。カバーするのは、自分が権利を持つオーディオだけにしてください。他人のトラックから似た曲を作る方法は、song-from-reference レシピで説明しています。コンテンツレシピを参照してください。

suno_mashup

2 つのトラックをブレンドして、マッシュアップを作ります。

権限:workflows:execute。クレジット:30。

パラメーター型説明
audio_url_1 or audio_asset_id_1string1 つ目のトラックです。
audio_url_2 or audio_asset_id_2string2 つ目のトラックです。
custom_mode, style, negative_style, title, vocal_gendersuno_generate と同じです。

戻り値:ジョブ ID です。

suno_replace_section

Suno の曲の一部だけを生成し直し、残りはそのまま保ちます。

権限:workflows:execute。クレジット:20。

パラメーター型説明
audio_asset_idstring必須。Suno の曲の Nodaro のジョブ ID です。
infill_start_s, infill_end_snumber必須。置き換える部分を秒で指定します。長さは 6〜60 秒で、曲の半分以下にする必要があります。
promptstring必須。新しい部分に入れたい内容で、最大 5,000 文字です。
tagsstring必須。新しい部分のスタイルタグで、最大 500 文字です。
negative_tagsstring新しい部分に入れたくないスタイルです。
full_lyricsstring変更後の曲全体の歌詞です。変更した部分と、変更していない部分の両方を含めます。
titlestring最大 80 文字です。

戻り値:ジョブ ID です。

suno_add_vocals

Suno のインストゥルメンタルにボーカルを追加します。

権限:workflows:execute。クレジット:30。

パラメーター型説明
audio_asset_idstring必須。Suno のインストゥルメンタルの Nodaro のジョブ ID です。
modelstringV6(デフォルト)、V6_WILD、V6_MINI、V4_5PLUS、V5、V5_5 のいずれかです。

戻り値:ジョブ ID です。

suno_add_instrumental

Suno の曲に、インストゥルメンタルのレイヤーを追加します。

権限:workflows:execute。クレジット:30。

パラメーター型説明
audio_asset_idstring必須。Suno の曲の Nodaro のジョブ ID です。
modelstringV6(デフォルト)、V6_WILD、V6_MINI、V4_5PLUS、V5、V5_5 のいずれかです。

戻り値:ジョブ ID です。

suno_separate_stems

Suno の曲を、ボーカルとインストゥルメンタルに分割するか、楽器ごとのステムに分割します。使えるのは Suno で作った曲だけです。それ以外のオーディオには、separate_audio を使います。

権限:workflows:execute。クレジット:40。

パラメーター型説明
audio_asset_idstring必須。Suno の曲の Nodaro のジョブ ID です。
typestringボーカルとインストゥルメンタルに分けるには separate_vocal(デフォルト)、すべての楽器に分けるには split_stem を指定します。

戻り値:ジョブ ID です。

suno_convert_wav

Suno の曲を、ロスレスの WAV ファイルに変換します。

権限:workflows:execute。クレジット:10。

パラメーター型説明
audio_asset_idstring必須。Suno の曲の Nodaro のジョブ ID です。

戻り値:ジョブ ID です。

suno_music_video

Suno の曲から、MP4 のミュージックビデオを作ります。映像はオーディオから作られ、設定できるスタイルやプロンプトはありません。ミュージックビデオ(Music Video)ノードと同じように動作します。

権限:workflows:execute。クレジット:10。

パラメーター型説明
audio_asset_idstring必須。Suno の曲の Nodaro のジョブ ID です。MiniMax や ElevenLabs など、ほかのモデルで作った曲は使えません。

戻り値:ジョブ ID です。

よくある質問

最終更新

目次