# 음악

> Suno와 다른 음악 모델로 노래와 연주곡을 만들고, Nodaro MCP 음악 도구로 연장, 커버, 매시업, 편집, 분리, 변환까지 하세요.

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

**음악 도구**를 사용하면 어시스턴트가 Nodaro에서 음악을 만들고 편집할 수 있습니다. `generate_music`은 프롬프트로 트랙을 만들거나, MiniMax Music으로 레퍼런스 트랙을 따라 만듭니다. `suno_` 도구는 Suno의 모든 기능을 사용합니다. 내 가사로 만든 노래, 커버, 연장, 매시업, 구간 교체, 스템, WAV 파일, 뮤직비디오가 있습니다. 모든 도구에는 `workflows:execute` 권한이 필요하며, 작업 ID를 반환합니다.

| 도구 | 하는 일 | 크레딧 |
| --- | --- | --- |
| [`generate_music`](#generate_music) | 프롬프트로 트랙 생성 | Suno는 33크레딧, MiniMax는 198크레딧 |
| [`suno_generate`](#suno_generate) | Suno의 모든 컨트롤로 노래 생성 | 33크레딧 |
| [`suno_lyrics`](#suno_lyrics) | 주제로 노래 가사 작성 | 11크레딧 |
| [`suno_style_boost`](#suno_style_boost) | 짧은 설명으로 더 풍부한 스타일 태그 생성 | 11크레딧 |
| [`suno_extend`](#suno_extend) | Suno 노래 이어 만들기 | 33크레딧 |
| [`suno_upload_extend`](#suno_upload_extend) | 업로드한 트랙 이어 만들기 | 33크레딧 |
| [`suno_cover`](#suno_cover) | 같은 노래를 새 스타일로 | 33크레딧 |
| [`suno_mashup`](#suno_mashup) | 두 트랙 섞기 | 33크레딧 |
| [`suno_replace_section`](#suno_replace_section) | Suno 노래의 한 부분을 다시 생성 | 22크레딧 |
| [`suno_add_vocals`](#suno_add_vocals) | Suno 연주곡에 보컬 추가 | 33크레딧 |
| [`suno_add_instrumental`](#suno_add_instrumental) | Suno 노래에 반주 레이어 추가 | 33크레딧 |
| [`suno_separate_stems`](#suno_separate_stems) | Suno 노래를 보컬과 반주, 또는 스템으로 분리 | 44크레딧, 악기마다 나누면 143크레딧 |
| [`suno_convert_wav`](#suno_convert_wav) | Suno 노래를 WAV로 변환 | 11크레딧 |
| [`suno_music_video`](#suno_music_video) | Suno 노래로 뮤직비디오 제작 | 11크레딧 |

Suno 노래를 편집하는 도구에는 Suno로 만든 노래의 Nodaro 작업 ID를 `audio_asset_id`로 넘겨야 합니다. 도구에 필요한 Suno ID는 서버에서 찾아 줍니다.

## `generate_music`
프롬프트로 음악 트랙을 만듭니다. 기본값인 Suno 모델에서는 [**Suno 음악 생성**](https://nodaro.ai/docs/nodes/audio/suno-create-music) 노드처럼 동작합니다. `minimax`에서는 [**음악 생성**](https://nodaro.ai/docs/nodes/audio/generate-music) 노드처럼 MiniMax Music을 실행하며, 레퍼런스 트랙이 필요합니다.

**권한:** `workflows:execute`. **크레딧:** Suno 모델은 33크레딧, MiniMax는 198크레딧.

| 매개변수 | 타입 | 설명 |
| --- | --- | --- |
| `prompt` | string | 원하는 음악으로, 최대 2,000자입니다. 프리셋이 제공하지 않는 한 필수입니다. |
| `model` | string | `suno-v6`(기본값, 풍부한 디테일과 자연스러운 보컬), `suno-v6_wild`(더 과감하고 예측하기 어려움), `suno-v6_mini`(더 빠름), `suno-v5_5`, `suno-v5`, `suno`, 또는 레퍼런스 트랙을 따라 만드는 `minimax`(MiniMax Music)입니다. `suno-v5_5` 대신 `suno-v5-5`도 받습니다. |
| `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초입니다. 없으면 모델이 길이를 정합니다. 최대 360초까지 길이를 정하려면 [`suno_generate`](#suno_generate)를 사용하세요. Suno에서 `duration`은 V6 모델의 사용자 지정 모드에서만 작동하며, 10초 미만은 10초로 올라갑니다. `instrumental` 트랙에서는 `title`이나 `duration`만 있어도 사용자 지정 모드가 켜집니다. MiniMax Music은 이 값을 무시합니다. |
| `presetId` | string | **공부용 로파이**, **시네마틱 예고편**, **EDM 드롭** 같은 프리셋입니다. |

`minimax`에서는 `reference_audio_url`이나 `reference_audio_asset_id`를 넘기세요. 레퍼런스가 없으면 도구가 레퍼런스를 요청하는 오류를 반환하며, 작업은 시작되지 않습니다. Suno 모델은 레퍼런스가 필요 없으며 두 매개변수를 모두 무시합니다.

**반환값:** 작업 ID입니다.

## `suno_generate`
모든 Suno 컨트롤로 Suno 오리지널 노래를 만듭니다. [**Suno 음악 생성**](https://nodaro.ai/docs/nodes/audio/suno-create-music) 노드처럼 동작합니다. 작업 출력에는 다른 `suno_` 도구가 사용하는 Suno ID가 담깁니다.

**권한:** `workflows:execute`. **크레딧:** 33크레딧.

| 매개변수 | 타입 | 설명 |
| --- | --- | --- |
| `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`
“여름의 이별을 노래하는 발라드” 같은 주제로 노래 가사를 씁니다. 결과는 사용자 지정 모드의 `suno_generate`에서 `lyrics`로 사용하세요.

**권한:** `workflows:execute`. **크레딧:** 11크레딧.

| 매개변수 | 타입 | 설명 |
| --- | --- | --- |
| `prompt` | string | **필수.** 주제로, 최대 1,000자입니다. |

**반환값:** 작업 ID입니다. 가사는 작업 출력에 있으며, 카드에 **복사** 버튼과 함께 표시됩니다.

## `suno_style_boost`
“로파이 칠” 같은 짧은 스타일 설명을 더 풍부한 스타일 태그로 바꿉니다. 결과는 `suno_generate`에서 `style`로 사용하세요.

**권한:** `workflows:execute`. **크레딧:** 11크레딧.

| 매개변수 | 타입 | 설명 |
| --- | --- | --- |
| `content` | string | **필수.** 다듬을 스타일로, 최대 5,000자입니다. |

**반환값:** 작업 ID입니다. 개선된 스타일은 작업 출력에 있습니다.

## `suno_extend`
Suno로 만든 노래를 이어 만듭니다.

**권한:** `workflows:execute`. **크레딧:** 33크레딧.

| 매개변수 | 타입 | 설명 |
| --- | --- | --- |
| `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`. **크레딧:** 33크레딧.

| 매개변수 | 타입 | 설명 |
| --- | --- | --- |
| `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`. **크레딧:** 33크레딧.

| 매개변수 | 타입 | 설명 |
| --- | --- | --- |
| `prompt` | string | **필수.** 커버의 스타일로, 최대 5,000자입니다. |
| `audio_url` 또는 `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`
두 트랙을 섞어 매시업을 만듭니다.

**권한:** `workflows:execute`. **크레딧:** 33크레딧.

| 매개변수 | 타입 | 설명 |
| --- | --- | --- |
| `audio_url_1` 또는 `audio_asset_id_1` | string | 첫 번째 트랙입니다. |
| `audio_url_2` 또는 `audio_asset_id_2` | string | 두 번째 트랙입니다. |
| `custom_mode`, `style`, `negative_style`, `title`, `vocal_gender` | | `suno_generate`와 같습니다. |

**반환값:** 작업 ID입니다.

## `suno_replace_section`
Suno 노래의 한 부분을 다시 생성하고, 나머지는 그대로 둡니다.

**권한:** `workflows:execute`. **크레딧:** 22크레딧.

| 매개변수 | 타입 | 설명 |
| --- | --- | --- |
| `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`. **크레딧:** 33크레딧.

| 매개변수 | 타입 | 설명 |
| --- | --- | --- |
| `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`. **크레딧:** 33크레딧.

| 매개변수 | 타입 | 설명 |
| --- | --- | --- |
| `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`. **크레딧:** `separate_vocal`은 44크레딧, `split_stem`은 143크레딧.

| 매개변수 | 타입 | 설명 |
| --- | --- | --- |
| `audio_asset_id` | string | **필수.** Suno 노래의 Nodaro 작업 ID입니다. |
| `type` | string | 보컬과 반주로 나누려면 `separate_vocal`(기본값), 악기마다 나누려면 `split_stem`입니다. |

**반환값:** 작업 ID입니다.

## `suno_convert_wav`
Suno 노래를 무손실 WAV 파일로 변환합니다.

**권한:** `workflows:execute`. **크레딧:** 11크레딧.

| 매개변수 | 타입 | 설명 |
| --- | --- | --- |
| `audio_asset_id` | string | **필수.** Suno 노래의 Nodaro 작업 ID입니다. |

**반환값:** 작업 ID입니다.

## `suno_music_video`
Suno 노래로 MP4 뮤직비디오를 만듭니다. 영상은 오디오를 바탕으로 만들어지며, 설정할 스타일이나 프롬프트는 없습니다. [**뮤직비디오**](https://nodaro.ai/docs/nodes/video/music-video) 노드처럼 동작합니다.

**권한:** `workflows:execute`. **크레딧:** 11크레딧.

| 매개변수 | 타입 | 설명 |
| --- | --- | --- |
| `audio_asset_id` | string | **필수.** Suno 노래의 Nodaro 작업 ID입니다. MiniMax나 ElevenLabs 같은 다른 모델로 만든 노래는 사용할 수 없습니다. |

**반환값:** 작업 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는 Nodaro에서 Suno로 만든 노래에만 사용할 수 있습니다. 다른 오디오에는 Demucs로 보컬과 악기를 분리하는 separate_audio를 사용하세요.

### 내 가사로 노래를 만들려면 어떻게 하나요?

custom_mode를 true로 설정하고, [Verse]와 [Chorus] 같은 구간 태그를 붙인 가사와 스타일을 넣어 suno_generate를 호출하세요. generate_music에서도 가사를 넘기면 같은 사용자 지정 모드로 바뀝니다.