# 피치 및 템포

> 음성이나 노래의 피치를 반음 단위로 올리거나 내리고, 피치는 그대로 둔 채 빠르게 또는 느리게 하세요. 오디오와 동영상 소리 모두에 쓸 수 있습니다.

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

**피치 및 템포** 노드는 오디오의 피치와 템포를 따로따로 바꿉니다. **피치**는 소리를 반음 단위로 올리거나 내리며, 길이는 그대로입니다. **템포**는 소리를 빠르게 또는 느리게 하며, 피치는 그대로입니다. 오디오를 연결하면 오디오가 반환되고, 동영상을 연결하면 소리를 바꾼 같은 동영상이 반환됩니다.

## 사용 시기
- 노래나 멜로디를 다른 조로 옮깁니다.
- 목소리를 더 낮거나 높게 하면서 자연스럽게 유지합니다.
- 목소리의 피치를 바꾸지 않고 클립을 느리게 또는 빠르게 해서 정해진 길이에 맞춥니다.
- 캐릭터용 다람쥐 목소리나 거인 목소리를 만듭니다.

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

### 미디어 연결
오디오 노드나 동영상 노드를 **미디어** 입력에 연결하세요.

### 피치와 템포 설정
설정 패널을 여세요. <strong>피치(반음)</strong>, **템포** 중 하나 또는 둘 다 설정하세요.

### 실행
노드에서 **실행**을 클릭하세요. 오디오이면 결과가 **오디오** 출력에 나타납니다. 동영상이면 **동영상** 출력에 나타납니다.

Workflow: 내레이션을 더 낮은 목소리로 바꾼 다음 동영상에 병합합니다.

- 텍스트 음성 변환 → 피치 및 템포 (미디어)
- 피치 및 템포 → 동영상 및 오디오 병합 (오디오)

## 입력과 출력
| 입력 | 연결할 수 있는 노드 | 설명 |
| --- | --- | --- |
| **미디어** | 오디오 노드와 동영상 노드 | 소리를 바꿀 오디오, 또는 소리를 바꿀 동영상입니다. |

출력은 입력을 따릅니다. 오디오이면 출력은 **오디오**이며, MP3 파일입니다. 동영상이면 출력은 **동영상**입니다. 화면은 그대로 복사하고 소리만 바꾼 같은 동영상입니다. 오디오는 화면이 끝나는 시점에 정확히 끝납니다.

노드는 파일 자체를 읽어 오디오인지 동영상인지 판단합니다. 오디오만 있는 파일은 동영상 연결로 들어와도 오디오로 처리됩니다.

## 설정
| 설정 | 설명 |
| --- | --- |
| **피치(반음)** | -12~12이며, 0.1 단위입니다. 기본값은 0입니다. 12는 한 옥타브 위, -12는 한 옥타브 아래입니다. |
| **템포** | 0.5~2이며, 0.05 단위입니다. 기본값은 1입니다. 0.5는 절반 속도로 재생하며 오디오 길이가 두 배가 됩니다. 2는 두 배 속도로 재생합니다. 피치는 바뀌지 않습니다. |
| **포먼트 유지(자연스러운 목소리)** | 기본적으로 켜져 있습니다. 피치가 바뀌어도 같은 사람의 목소리로 들리게 합니다. 다람쥐 목소리나 거인 목소리를 만들려면 끄세요. |

동영상이면 **템포**는 1로 고정되고 설정이 꺼지므로, 소리가 화면과 계속 맞습니다. 동영상의 속도를 바꾸려면 [속도 조절](https://nodaro.ai/docs/nodes/video/adjust-speed)을 사용하세요.

## 크레딧
피치 및 템포는 **입력의 시작된 1분마다 22크레딧**이 들며, 1분부터 최대 30분까지입니다. 45초짜리 클립은 1분으로, 3분 10초짜리 클립은 4분으로 청구됩니다. 노드는 실행 전에 정확한 가격을 보여 줍니다.

가격은 입력 길이로만 정해집니다. 피치, 템포, 느리게 해서 길어진 출력은 가격을 바꾸지 않습니다. 노드는 크레딧을 청구하기 전에 입력 길이를 측정하므로, 같은 입력은 항상 같은 가격입니다.

## 팁
- **자연스러운 말소리는 4반음 안쪽으로 유지하세요.** 그보다 크게 바꾸면 <strong>포먼트 유지(자연스러운 목소리)</strong>를 켜 두어도 목소리가 가공된 소리로 들립니다.
- **노래의 조는 음정만큼 바꾸세요.** 예를 들어 -2로 설정하면 노래가 온음 하나만큼 내려갑니다.
- **템포를 조금씩 바꿔 클립을 정해진 길이에 맞추세요.** 템포를 0.9로 하면 클립이 약 11% 길어지고, 목소리의 피치는 그대로입니다.
- **목소리는 병합하기 전에 바꾸세요.** 피치 및 템포를 [동영상 및 오디오 병합](https://nodaro.ai/docs/nodes/video/merge-video-audio)이나 [오디오 믹스](https://nodaro.ai/docs/nodes/audio/mix-audio) 앞에 두세요.

## 문제 해결
| 메시지 | 해결 방법 |
| --- | --- |
| 입력이 30분보다 깁니다 | 먼저 [오디오 자르기](https://nodaro.ai/docs/nodes/audio/trim-audio)로 자른 다음, 짧아진 클립으로 노드를 실행하세요. 크레딧은 청구되지 않습니다. |
| 입력 길이를 읽을 수 없습니다 | 파일이 열리는지, 일반적인 오디오 또는 동영상 형식인지 확인하세요. 크레딧은 청구되지 않습니다. |
| 미디어에 바꿀 오디오 트랙이 없습니다 | 동영상에 소리가 없습니다. 먼저 [동영상 및 오디오 병합](https://nodaro.ai/docs/nodes/video/merge-video-audio) 등으로 소리를 넣으세요. 크레딧은 환불됩니다. |

## API에서 사용
`POST /v1/pitch-tempo`는 `audioUrl`과 `videoUrl` 중 정확히 하나와 함께 선택 항목인 `semitones`, `tempo`, `preserveFormants`를 받습니다. SDK 메서드는 `client.audio.pitchTempo`, CLI 명령은 `nodaro audio pitch-tempo`, MCP 도구는 `pitch_tempo`입니다. [보이스 및 미디어](https://nodaro.ai/docs/developers/api/voice-and-media)를 참고하세요.

## 자주 묻는 질문

### 속도는 그대로 두고 목소리의 피치만 바꾸려면 어떻게 하나요?

피치(반음)를 설정하고 템포는 1로 두세요. 오디오 길이는 그대로입니다. 같은 사람의 목소리로 들리도록 포먼트 유지를 켜 두세요.

### 오디오를 느리게 하면서 소리가 낮아지지 않게 할 수 있나요?

네. 템포를 1보다 작게, 예를 들어 0.8로 설정하세요. 오디오가 길어지고 피치는 그대로입니다.

### 피치 및 템포는 동영상에도 쓸 수 있나요?

네, 피치는 바꿀 수 있습니다. 노드는 동영상의 소리를 바꾸고 화면은 그대로 둔 같은 동영상을 반환합니다. 소리가 화면과 계속 맞도록 동영상의 템포는 1로 고정됩니다.

### 피치 및 템포는 몇 크레딧이 드나요?

입력의 시작된 1분마다 22크레딧이 들며, 1분부터 30분까지입니다. 가격은 입력 길이로만 정해지며 설정과는 관계없습니다.

### 다람쥐 목소리나 거인 목소리는 어떻게 만드나요?

포먼트 유지를 끄세요. 그런 다음 다람쥐 목소리는 피치를 올리고, 거인 목소리는 피치를 내리세요.