# 音楽

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

Source: https://nodaro.ai/ja/docs/mcp/tools/music

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

| ツール | 機能 | クレジット |
| --- | --- | --- |
| [`generate_music`](#generate_music) | プロンプトからトラックを作成 | Suno では 30、MiniMax では 180 |
| [`suno_generate`](#suno_generate) | Suno のすべてのコントロールで曲を作成 | 30 |
| [`suno_lyrics`](#suno_lyrics) | テーマから歌詞を作成 | 10 |
| [`suno_style_boost`](#suno_style_boost) | 短い説明から、より豊かなスタイルタグを作成 | 10 |
| [`suno_extend`](#suno_extend) | Suno の曲の続きを作成 | 30 |
| [`suno_upload_extend`](#suno_upload_extend) | アップロードしたトラックの続きを作成 | 30 |
| [`suno_cover`](#suno_cover) | 同じ曲を新しいスタイルで作成 | 30 |
| [`suno_mashup`](#suno_mashup) | 2 つのトラックをブレンド | 30 |
| [`suno_replace_section`](#suno_replace_section) | Suno の曲の一部を再生成 | 20 |
| [`suno_add_vocals`](#suno_add_vocals) | Suno のインストゥルメンタルにボーカルを追加 | 30 |
| [`suno_add_instrumental`](#suno_add_instrumental) | Suno の曲にインストゥルメンタルのレイヤーを追加 | 30 |
| [`suno_separate_stems`](#suno_separate_stems) | Suno の曲を、ボーカルとインストゥルメンタル、またはステムに分割 | 40 |
| [`suno_convert_wav`](#suno_convert_wav) | Suno の曲を WAV に変換 | 10 |
| [`suno_music_video`](#suno_music_video) | Suno の曲からミュージックビデオを作成 | 10 |

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

## `generate_music`
プロンプトから音楽トラックを作成します。デフォルトの Suno のモデルでは、[**Suno 生成**（Suno Create Music）](https://nodaro.ai/docs/nodes/audio/suno-create-music)ノードと同じように動作します。`minimax` では、[**音楽生成**（Generate Music）](https://nodaro.ai/docs/nodes/audio/generate-music)ノードと同じように MiniMax Music を実行します。その場合は、リファレンストラックが必要です。

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

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

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

**戻り値**：ジョブ ID です。

## `suno_generate`
Suno のすべてのコントロールを使って、Suno でオリジナルの曲を作成します。[**Suno 生成**](https://nodaro.ai/docs/nodes/audio/suno-create-music)ノードと同じように動作します。ジョブの出力には、ほかの `suno_` ツールが使う Suno の ID が含まれます。

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

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `prompt` | string | **必須**。曲、または曲のインスピレーションで、最大 5,000 文字です。カスタムモードでは、スタイルを説明します。 |
| `model` | string | `V6`（デフォルト）、`V6_WILD`、`V6_MINI`、`V5_5`、`V5`、`V4_5PLUS`、`V4_5ALL`、`V4_5`、`V4` のいずれかです。 |
| `custom_mode` | boolean | `lyrics` と `style` を、書いたとおりに使います。 |
| `lyrics` | string | 歌詞全体で、最大 5,000 文字です。カスタムモードでのみ使います。 |
| `style` | string | `lo-fi hip-hop, melancholy, piano` のようなスタイルタグで、最大 500 文字です。 |
| `negative_style` | string | 避けたいスタイルで、最大 500 文字です。 |
| `title` | string | 最大 80 文字です。 |
| `instrumental` | boolean | ボーカルのない音楽にします。 |
| `vocal_gender` | string | `male` か `female` です。 |
| `duration` | number | 曲の長さで、10〜360 秒です。V6 系のモデルで、カスタムモードのときだけ機能します。 |
| `style_weight`, `weirdness`, `audio_weight` | number | 0〜1 です。それぞれ、スタイルを適用する強さ、結果の奇抜さ、オーディオ入力の重みです。 |

**戻り値**：ジョブ ID です。

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

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

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `prompt` | string | **必須**。テーマで、最大 1,000 文字です。 |

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

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

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

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

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

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

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

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `audio_asset_id` | string | **必須**。Suno の曲の Nodaro のジョブ ID です。 |
| `continue_at` | number | 延長を始める、曲の中の位置（秒）です。 |
| `prompt`, `style`, `title` | string | 延長部分の方向性を指定します。 |
| `vocal_gender` | string | `male` か `female` です。 |
| `model` | string | `V6`（デフォルト）か、ほかの Suno のバージョンです。 |

**戻り値**：ジョブ ID です。

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

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

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `audio_url` | string | **必須**。トラックの公開 URL です。 |
| `continue_at` | number | **必須**。Suno が続きを始める位置（秒）です。 |
| `style`, `negative_style`, `title`, `vocal_gender`, `model` | | `suno_generate` と同じです。 |
| `use_default_params` | boolean | `true` にすると、Suno がスタイルとタイトルを選びます。デフォルトの `false` では、指定した `style` と `title` を使います。 |

**戻り値**：ジョブ ID です。

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

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

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

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

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

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

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `audio_url_1` or `audio_asset_id_1` | string | 1 つ目のトラックです。 |
| `audio_url_2` or `audio_asset_id_2` | string | 2 つ目のトラックです。 |
| `custom_mode`, `style`, `negative_style`, `title`, `vocal_gender` | | `suno_generate` と同じです。 |

**戻り値**：ジョブ ID です。

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

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

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

**戻り値**：ジョブ ID です。

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

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

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `audio_asset_id` | string | **必須**。Suno のインストゥルメンタルの Nodaro のジョブ ID です。 |
| `model` | string | `V6`（デフォルト）、`V6_WILD`、`V6_MINI`、`V4_5PLUS`、`V5`、`V5_5` のいずれかです。 |

**戻り値**：ジョブ ID です。

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

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

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `audio_asset_id` | string | **必須**。Suno の曲の Nodaro のジョブ ID です。 |
| `model` | string | `V6`（デフォルト）、`V6_WILD`、`V6_MINI`、`V4_5PLUS`、`V5`、`V5_5` のいずれかです。 |

**戻り値**：ジョブ ID です。

## `suno_separate_stems`
Suno の曲を、ボーカルとインストゥルメンタルに分割するか、楽器ごとのステムに分割します。使えるのは Suno で作った曲だけです。それ以外のオーディオには、[`separate_audio`](https://nodaro.ai/docs/mcp/tools/audio#separate_audio) を使います。

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

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `audio_asset_id` | string | **必須**。Suno の曲の Nodaro のジョブ ID です。 |
| `type` | string | ボーカルとインストゥルメンタルに分けるには `separate_vocal`（デフォルト）、すべての楽器に分けるには `split_stem` を指定します。 |

**戻り値**：ジョブ ID です。

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

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

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `audio_asset_id` | string | **必須**。Suno の曲の Nodaro のジョブ ID です。 |

**戻り値**：ジョブ ID です。

## `suno_music_video`
Suno の曲から、MP4 のミュージックビデオを作ります。映像はオーディオから作られ、設定できるスタイルやプロンプトはありません。[**ミュージックビデオ**（Music Video）](https://nodaro.ai/docs/nodes/video/music-video)ノードと同じように動作します。

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

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

**戻り値**：ジョブ ID です。

## Frequently asked questions

### generate_music と suno_generate の違いは何ですか？

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

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

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

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

suno_separate_stems が使えるのは、Nodaro で Suno を使って作った曲だけです。それ以外のオーディオには separate_audio を使います。separate_audio は、Demucs でボーカルと楽器を分離します。

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

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