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

音楽

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

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

ツール機能クレジット
generate_musicプロンプトからトラックを作成Suno では 33、MiniMax では 198
suno_generateSuno のすべてのコントロールで曲を作成33
suno_lyricsテーマから歌詞を作成11
suno_style_boost短い説明から、より豊かなスタイルタグを作成11
suno_extendSuno の曲の続きを作成33
suno_upload_extendアップロードしたトラックの続きを作成33
suno_cover同じ曲を新しいスタイルで作成33
suno_mashup2 つのトラックをブレンド33
suno_replace_sectionSuno の曲の一部を再生成22
suno_add_vocalsSuno のインストゥルメンタルにボーカルを追加33
suno_add_instrumentalSuno の曲にインストゥルメンタルのレイヤーを追加33
suno_separate_stemsどんなオーディオも、ボーカルとインストゥルメンタル、ステム、または 1 つの楽器に分割44、1 回の実行ですべてのステムに分ける場合は 143、1 つの楽器の場合は 88
suno_convert_wavSuno の曲や、Suno の分離のステム 1 つを WAV に変換11
suno_music_videoSuno の曲からミュージックビデオを作成11
suno_speech1 行の概要や自分の台本から話し声を作成、1 回の実行で 2 テイク1 回の実行につき一律の料金

Suno の曲を編集するツールには、Suno で作った曲の Nodaro のジョブ ID を audio_asset_id として渡します。ツールに必要な Suno の ID は、サーバー側で取得されます。suno_speech のテイクは曲ではなく話し声なので、suno_extend、suno_separate_stems、suno_convert_wav は、ID で渡されたテイクを拒否します。クレジットはかかりません。

generate_music

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

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

パラメーター型説明
promptstring作りたい音楽の説明で、最大 2,000 文字です。プリセットがこの値を指定する場合を除き、必須です。
modelstringsuno-v6(デフォルト。ディテールが豊かで、ボーカルが自然)、suno-v6_wild(より大胆で、予測しにくい)、suno-v6_mini(より高速)、suno-v5_5、suno-v5、suno-v4_5plus、suno-v4_5all、suno-v4_5、suno、またはリファレンストラックをもとに作る minimax(MiniMax Music)です。suno-v5_5 は suno-v5-5 とも指定できます。
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 秒です。指定しない場合は、モデルが長さを決めます。最大 360 秒の長さを指定するには、suno_generate を使います。Suno では、duration は 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。クレジット:33。

パラメーター型説明
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。クレジット:11。

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

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

suno_style_boost

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

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

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

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

suno_extend

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

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

パラメーター型説明
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。クレジット:33。

パラメーター型説明
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。クレジット:33。

パラメーター型説明
promptstring必須。カバーのスタイルで、最大 5,000 文字です。
audio_url または audio_asset_idstring元のトラックです。
task_id, audio_idstringNodaro で作った自分の Suno の曲を、Suno のタスク ID とトラック ID の組で指定します。audio_url も audio_asset_id もない場合、Suno はその ID で曲をカバーし、アップロードし直しません。料金は同じです。オーディオも渡した場合は、そのオーディオがカバーされ、ID は使われません。それぞれ最大 200 文字です。
instrumentalbooleanボーカルのない、インストゥルメンタルのカバーにします。
lyricsstring新しい歌詞です。指定しない場合、Suno は元の音源から聞き取った歌詞を使います。
custom_mode, style, title, vocal_gender, modelsuno_generate と同じです。

ID によるカバーは、設定が合うときだけ使えます。シンプルモードではプロンプトがスタイルとして送られ、カスタムモードではプロンプトが歌詞として歌われます。合わないリクエストは実行前に拒否され、クレジットはかかりません。メッセージは、代わりにオーディオを渡すよう求めます。ID で Suno の曲をカバーするを参照してください。

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

suno_mashup

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

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

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

戻り値:ジョブ ID です。

suno_replace_section

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

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

パラメーター型説明
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。クレジット:33。

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

戻り値:ジョブ ID です。

suno_add_instrumental

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

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

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

戻り値:ジョブ ID です。

suno_separate_stems

Suno で、どんなオーディオも、ボーカルとインストゥルメンタル、楽器ごとのステム、または指定した 1 つの楽器とそれを除いた曲に分割します。オーディオには、Suno の曲、アップロード、生成した任意のオーディオを使えます。Suno は、商業的にリリースされた録音と、20 MB を超えるオーディオを拒否します。そうしたオーディオには、fallback_to_demucs を設定するか、separate_audio を使います。Suno 音源分離ノードと同じように動作します。

権限:workflows:execute。クレジット:separate_vocal では 44、split_stem では 143、split_stem_advanced では 88。Demucs に切り替わった実行には、代わりに音源分離の料金がかかります。

パラメーター型説明
audio_url または audio_asset_idstringどちらか 1 つだけを指定します。audio_url は、リンクで指定する任意のオーディオです。audio_asset_id は、Nodaro のオーディオのジョブか、アップロードしたオーディオファイルです。Suno の曲は、Suno の ID で分離されます。
typestringボーカルとインストゥルメンタルに分けるには separate_vocal(デフォルト)、すべての楽器に分けるには split_stem、1 つの楽器には split_stem_advanced を指定します。
stem_namestringsplit_stem_advanced のみ。Suno の楽器名の 1 つで、Piano や Lead Vocal(デフォルト)などです。
fallback_to_demucsbooleanSuno が拒否したときに、代わりに Demucs を実行し、その料金を課金します。ボーカルとフルステムのみです。デフォルトは false です。

戻り値:ジョブ ID です。split_stem_advanced では、ジョブの isolatedUrl と withoutUrl に 1 つ目のテイクが、isolated2Url と without2Url に 2 つ目のテイクが入ります。

suno_convert_wav

Suno の曲や、suno_separate_stems ジョブのステム 1 つを、ロスレスの WAV ファイルに変換します。Suno WAV 変換ノードと同じように動作します。

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

パラメーター型説明
audio_asset_idstring必須。Suno の曲、または Suno の分離の Nodaro のジョブ ID です。
stemstring分離の場合のみ。変換するステムです。出力の vocals、instrumental、isolated、without のいずれか、または drumsUrl、bassUrl、isolatedUrl などの分離の結果フィールドです。それ以外の値はエラーになります。

Demucs が行った分離や、ステムの ID を残していない分離は実行前に拒否され、クレジットはかかりません。Suno 音源分離のステムを変換するを参照してください。

戻り値:ジョブ ID です。

suno_music_video

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

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

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

戻り値:ジョブ ID です。

suno_speech

Suno スピーチで、トーン、リズム、感情のこもった話し声を作ります。背景音楽を加えることもできます。決まった声の音声合成ではなく、どの実行でも 2 つのテイクを作ります。Suno スピーチノードと同じように動作します。

権限:workflows:execute。クレジット:モードにかかわらず、2 つのテイク込みで 1 回の実行につき一律の料金です。GET /v1/credits/model-cost?model=suno-speech で料金がわかります。

パラメーター型説明
modestringbrief(デフォルト):Suno が prompt から台本を書いて演じます。script:Suno が script を話します。
promptstring「概要」モード:シーンを 1 行で説明します。最大 3,000 文字です。
scriptstring「台本」モード:話す文章です。最大 5,000 文字で、改行はそのまま使われます。
tonestring「台本」モード:トーン、リズム、感情、場面です。アクセントや音楽のスタイルなどで、最大 1,000 文字です。
varietyinteger「台本」モード:2 つのテイクの違いの大きさで、0(スタイルどおり)から 4(極端に多彩)までです。指定しない場合は、モデルが決めます。
vocal_genderstring「台本」モード:female または male です。指定しない場合は、モデルが選びます。
background_musicboolean「台本」モード:背景音楽を加えます。

上限の文字数は、前後の空白を除いてから数えます。空のテキストや上限を超えるテキストは実行前に拒否され、クレジットはかかりません。もう一方のモードのフィールドは無視されます。

戻り値:ジョブ ID です。完了したジョブの audioUrl は最初のテイクで、audioUrls には両方のテイクが、sunoTracks には各テイクの ID、タイトル、長さが入ります。

よくある質問

generate_music と suno_generate の違いは何ですか?

generate_music は、プロンプトからトラックを作るシンプルなツールです。デフォルトは Suno V6 です。minimax モデルの MiniMax Music は、reference_audio_url か reference_audio_asset_id で渡したリファレンストラックをもとに曲を作ります。suno_generate では、Suno 独自のコントロールを使えます。たとえば、自分の歌詞とスタイルを使うカスタムモード、奇抜さ、スタイルの重み、ネガティブスタイルです。

Suno の曲を作るには、何クレジットかかりますか?

どの Suno のバージョンでも、1 回の生成につき 33 クレジットです。歌詞、スタイルブースト、WAV への変換、ミュージックビデオは 11 クレジット、セクションの置き換えは 22 クレジットです。

どんな曲でもステムに分割できますか?

はい。suno_separate_stems は、Suno の曲、アップロード、リンクなど、20 MB までのどんなオーディオも受け付けます。Suno は、商業的にリリースされた録音を拒否します。そうした録音には、Demucs で実行される separate_audio を使うか、fallback_to_demucs を設定してください。

自分で書いた歌詞で曲を作るにはどうすればよいですか?

suno_generate を呼び出し、custom_mode を true にして、[Verse] や [Chorus] などのセクションタグを付けた歌詞と、スタイルを渡します。generate_music でも、歌詞を渡すと同じカスタムモードに切り替わります。

アシスタントに Suno でナレーションを作らせることはできますか?

はい。suno_speech は、Suno スピーチで話し声を作ります。mode を brief にすると、Suno が 1 行のシーンから台本を書いて演じます。mode を script にすると、自分の文章を、任意のトーン、バリエーション、声の性別、背景音楽付きで話します。どの実行でも 2 つのテイクが返ります。

最終更新

目次