# 오디오 믹스

> 여러 오디오 트랙을 트랙마다 0~200% 볼륨으로 겹쳐 파일 하나로 만드세요. 내레이션이 말하는 동안 음악 볼륨을 자동으로 낮출 수도 있습니다.

Source: https://nodaro.ai/ko/docs/nodes/audio/mix-audio

**오디오 믹스** 노드는 여러 오디오 트랙을 트랙마다 0~200%의 볼륨으로 겹쳐 파일 하나로 만듭니다. 배경 음악 위에 내레이션을, 앰비언스 위에 효과음을 얹은 다음 믹스를 [동영상 및 오디오 병합](https://nodaro.ai/docs/nodes/video/merge-video-audio)으로 보내세요.

**볼륨 낮추기 기준 트랙**을 설정하면 트랙 하나(보통 음성)가 클 때 다른 모든 트랙의 볼륨이 낮아집니다. 다른 트랙은 그 트랙이 멈추면 다시 올라갑니다. 그러면 배경 음악이 말소리 아래에 깔리고, 볼륨을 직접 조절할 필요가 없습니다.

- Found in: Audio › Edit Audio
- Output: audio
- API type: `mix-audio`

## 사용 시기
- 배경 음악 위에 내레이션을 얹습니다.
- 효과음과 음악 트랙을 함께 넣습니다.
- 영화 같은 장면을 위해 대사와 앰비언스를 믹스합니다.
- 생성한 트랙 여러 개로 오디오 베드를 만듭니다.

## 빠른 시작
### 노드 추가
캔버스에서 Tab을 누르고 **오디오 › 오디오 편집 › 오디오 믹스**를 선택하세요.

### 트랙 연결
오디오 노드를 두 개 이상 **오디오** 입력에 연결하세요.

### 볼륨 설정
설정 패널을 여세요. 연결한 트랙마다 0~200%의 볼륨 슬라이더가 있습니다. 트랙이 여러 개이면 드래그해 순서를 바꿀 수도 있습니다.

### 실행
노드에서 **실행**을 클릭하세요. 믹스가 플레이어와 함께 노드에 나타납니다.

Workflow: 음악을 낮은 음량으로 깔고 그 위에 내레이션을 믹스한 다음, 믹스를 동영상에 병합합니다.

- 텍스트 음성 변환 → 오디오 믹스 (오디오)
- Suno 음악 생성 → 오디오 믹스 (오디오)
- 오디오 믹스 → 동영상 및 오디오 병합 (오디오)
- 동영상 생성 → 동영상 및 오디오 병합 (동영상)

## 입력과 출력
| 입력 | 연결할 수 있는 노드 | 설명 |
| --- | --- | --- |
| **오디오** | 오디오 또는 동영상 노드 두 개 이상 | 겹칠 트랙입니다. 연결한 노드는 각각 트랙 목록에 나타납니다. 연결한 동영상도 트랙으로 셉니다. 동영상의 소리가 믹스되며, 소리가 없는 동영상은 그 길이만큼 무음을 더합니다. |

출력인 **오디오**는 믹스한 파일 하나입니다.

## 설정
| 설정 | 설명 |
| --- | --- |
| 트랙 순서 | 연결한 트랙을 노드 이름으로 보여 줍니다. 드래그해 순서를 바꾸세요. |
| 트랙별 볼륨 | 0~200%입니다. 기본값은 100%입니다. |
| **볼륨 낮추기 기준 트랙** | 다른 트랙이 볼륨을 낮출 기준 트랙입니다. 기본값은 **끄기**로, 일반 믹스입니다. 이 설정은 트랙을 두 개 이상 연결하면 나타납니다. |
| **볼륨 낮추는 정도** | 다른 트랙의 볼륨을 얼마나 낮출지 0~100으로 정합니다. 기본값은 75입니다. 이 설정은 기준 트랙을 설정하면 나타납니다. |
| **믹스 끝내기** | 믹스한 파일이 끝나는 지점입니다. **가장 긴 트랙에 맞춰**(기본값) 또는 **목소리가 끝날 때**이며, **목소리가 끝날 때**는 **볼륨 낮추기 기준 트랙**이 끝날 때 믹스를 멈춥니다. 이 설정은 기준 트랙을 설정하면 나타납니다. 볼륨 낮추기를 끄면 초기화됩니다. |

## 음성 아래로 음악 낮추기
볼륨 낮추기는 트랙 하나가 클 때 다른 트랙의 볼륨을 낮춥니다. **볼륨 낮추기 기준 트랙**의 음량이 다른 모든 트랙에 걸린 컴프레서를 제어합니다. 그 트랙이 -30dBFS보다 크면 다른 트랙의 볼륨이 낮아집니다. 그 트랙이 조용해지면 다른 트랙은 원래 레벨로 돌아갑니다.

**볼륨 낮추는 정도**는 임계값을 넘은 음성 레벨 중 얼마만큼을 다른 트랙에서 뺄지 정합니다. 값이 클수록 더 깊이 낮아집니다.

| 볼륨 낮추는 정도 | 컴프레서 비율 |
| --- | --- |
| 0 | 1, 낮추지 않음 |
| 50 | 2 |
| 75, 기본값 | 4 |
| 90 | 10 |
| 95~100 | 20, 최댓값 |

비율은 `1 / (1 − amount / 100)`이며 최댓값은 20입니다. 기본값 75에서 비율은 4입니다. 음악은 음성이 시작되고 약 20ms 안에 낮아지기 시작하고, 음성이 멈춘 뒤 약 500ms에 걸쳐 돌아옵니다.

- **음성은 원래 레벨을 유지합니다.** 일반 믹스는 모든 트랙을 트랙 수로 나눕니다. 볼륨을 낮추는 믹스는 대신 트랙을 더하고, 리미터가 합계의 클리핑을 막습니다.
- **목소리로 믹스를 끝내지 않으면 음악은 끝까지 재생됩니다.** 기준 트랙이 다른 트랙보다 먼저 끝나면, 다른 트랙은 원래 볼륨으로 돌아가 각자의 끝까지 재생됩니다. 기준 트랙이 끝날 때 믹스 전체를 멈추려면 **믹스 끝내기**를 **목소리가 끝날 때**로 설정하세요. 그러면 긴 배경 음악이 에피소드와 함께 끝납니다.
- **요금은 같습니다.** 볼륨 낮추기를 쓰든 쓰지 않든 실행 요금은 같습니다.

나중에 기준 트랙의 연결을 끊으면 노드는 일반 믹스를 만듭니다.

## 팁
- **말소리를 또렷하게 유지하세요.** 내레이션은 100%로 두고 배경 음악은 30%~50% 사이로 설정하세요. 또는 **볼륨 낮추기 기준 트랙**을 내레이션으로 설정하면 음성이 말하는 동안에만 음악이 낮아집니다.
- **음악이 아니라 음성을 기준으로 하세요.** **볼륨 낮추기 기준 트랙**에서 음성 트랙을 선택하세요. 음악이 여전히 말소리와 겹치면 **볼륨 낮추는 정도**를 높이세요.
- **소리를 키울 때는 주의하세요.** 100%를 넘는 볼륨은 클리핑과 왜곡을 일으킬 수 있습니다. 작은 소리는 먼저 [볼륨 조절](https://nodaro.ai/docs/nodes/audio/adjust-volume)로 음량을 맞추세요.
- **계획을 세워 겹치세요.** 음성부터 시작한 다음 음악, 그다음 효과음을 더하세요.
- **다음 단계로 가기 전에 들어 보세요.** 다음 노드에 연결하기 전에 노드에서 믹스를 확인하세요.
- **트랙이 하나뿐인가요?** 트랙 하나의 볼륨만 바꾸려면 [볼륨 조절](https://nodaro.ai/docs/nodes/audio/adjust-volume)을 쓰세요.

## API에서 사용
`POST /v1/mix-audio`는 트랙 2~20개의 목록인 `audioUrls`와 선택 항목인 `trackVolumes`, `duck`, `endAt`을 받습니다. `endAt`은 `"longest"`(기본값) 또는 `"voice"`이며, `"voice"`는 `duck.under` 트랙이 끝날 때 믹스를 끝냅니다. `"voice"`에는 `duck`이 필요하며, 없으면 요청이 `400 validation_error`로 거부됩니다. `duck`은 다른 트랙이 볼륨을 낮출 기준 트랙의 0부터 시작하는 인덱스인 `under`와 선택 항목인 `amount`(기본값 75)를 받습니다. 다음 세부 조정 항목도 받으며, 노드에서는 항상 기본값을 씁니다.

| 필드 | 기본값 | 범위 |
| --- | --- | --- |
| `thresholdDb` | -30dBFS | -60~0 |
| `attackMs` | 20 | 1~2000 |
| `releaseMs` | 500 | 10~9000 |
| `ratio` | `amount`에서 계산 | 1~20. 지정하면 `amount`보다 우선합니다. |

MCP 도구는 `mix_audio`이며, 같은 설정을 `end_at`으로 씁니다. [보이스 및 미디어](https://nodaro.ai/docs/developers/api/voice-and-media)를 참고하세요.

## 자주 묻는 질문

### 내레이션 아래 배경 음악은 얼마나 크게 해야 하나요?

내레이션은 100%로 두고 음악은 30%~50% 사이로 설정하세요. 그러면 음악 위에서도 말소리가 또렷하게 들립니다.

### 트랙을 원래보다 크게 만들 수 있나요?

네, 최대 200%까지 가능합니다. 100%를 넘는 값은 클리핑과 왜곡을 일으킬 수 있으므로 주의해서 쓰세요.

### 오디오 믹스와 오디오 합치기는 어떻게 다른가요?

오디오 믹스는 트랙을 서로 겹쳐 동시에 재생합니다. 오디오 합치기는 클립을 하나씩 차례로 재생합니다.

### 트랙은 몇 개까지 믹스할 수 있나요?

오디오 노드를 두 개 이상 연결하세요. API에서는 믹스 하나에 트랙을 2~20개 넣을 수 있습니다.

### 내레이션이 말하는 동안 음악 볼륨을 자동으로 낮출 수 있나요?

네. 볼륨 낮추기 기준 트랙을 내레이션 트랙으로 설정하세요. 음성이 클 때 다른 모든 트랙의 볼륨이 낮아지고, 음성이 멈추면 다시 올라갑니다. 음악을 얼마나 낮출지는 볼륨 낮추는 정도로 정하며, 기본값은 75입니다.