# ピッチとテンポ

> 声や曲のピッチを半音単位で上げ下げしたり、ピッチを変えずに速くしたり遅くしたりします。オーディオにも、動画の音にも使えます。

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

**ピッチとテンポ**ノードは、オーディオのピッチとテンポを別々に変更します。**ピッチ**は音を半音単位で上げ下げし、長さは変えません。**テンポ**は音を速くしたり遅くしたりし、ピッチは変えません。オーディオを接続するとオーディオが返り、動画を接続すると、音をシフトした同じ動画が返ります。

## 使いどころ
- 曲やメロディーを別のキーに移します。
- 声を低くしたり高くしたりして、自然さを保ちます。
- 声のピッチを変えずにクリップを遅くしたり速くしたりして、決まった時間枠に合わせます。
- キャラクター用に、チップマンクのような声や巨人のような声を作ります。

## クイックスタート
### ノードを追加する
キャンバス上で Tab を押し、**オーディオ › オーディオ編集 › ピッチとテンポ**を選びます。

### メディアを接続する
オーディオノードか動画ノードを、**メディア**入力に接続します。

### ピッチとテンポを設定する
設定パネルを開きます。**ピッチ（半音）**、**テンポ**、またはその両方を設定します。

### 実行する
ノードの**実行**をクリックします。オーディオの場合、結果は**オーディオ**出力に表示されます。動画の場合は、**動画**出力に表示されます。

Workflow: ナレーションの声を低くしてから、動画に結合します。

- テキストから音声 → ピッチとテンポ (メディア)
- ピッチとテンポ → 動画とオーディオを結合 (オーディオ)

## 入力と出力
| 入力 | 接続できるノード | 説明 |
| --- | --- | --- |
| **メディア** | オーディオノードと動画ノード | オーディオ、または音を変更したい動画です。 |

出力は入力に応じて変わります。オーディオの場合、出力は**オーディオ**で、MP3 ファイルです。動画の場合、出力は**動画**です。映像はそのままコピーされ、音だけがシフトされた同じ動画になります。オーディオは、映像の終わりとぴったり同時に終わります。

ノードは、ファイル自体を読み取って、オーディオか動画かを判断します。オーディオだけのファイルは、動画の接続から届いた場合でも、オーディオとして扱われます。

## 設定
| 設定 | 説明 |
| --- | --- |
| **ピッチ（半音）** | -12〜12 で、0.1 刻みです。デフォルトは 0 です。12 で 1 オクターブ上がり、-12 で 1 オクターブ下がります。 |
| **テンポ** | 0.5〜2 で、0.05 刻みです。デフォルトは 1 です。0.5 では半分の速さで再生され、オーディオの長さは 2 倍になります。2 では 2 倍の速さで再生されます。ピッチは変わりません。 |
| **フォルマントを保持（自然な声）** | デフォルトはオンです。ピッチを変えても、声が同じ人の声のまま聞こえるようにします。チップマンクのような声や巨人のような声にするには、オフにします。 |

動画の場合、**テンポ**は 1 に固定され、設定は無効になります。そのため、音は映像と合ったままです。動画の速さを変えるには、[**速度調整**](https://nodaro.ai/docs/nodes/video/adjust-speed)を使います。

## クレジット
ピッチとテンポの料金は、**入力 1 分ごとに 22 クレジット**です（1 分未満は切り上げ）。数える範囲は 1〜30 分です。45 秒のクリップは 1 分、3 分 10 秒のクリップは 4 分として課金されます。ノードは、実行前に正確な料金を表示します。

料金は、入力の長さだけで決まります。ピッチ、テンポ、遅くしたことで長くなった出力は、料金に影響しません。ノードは課金の前に入力の長さを測るので、同じ入力の料金は常に同じです。

## ヒント
- **自然な話し声には、およそ 4 半音以内にとどめる**：それより大きくシフトすると、**フォルマントを保持（自然な声）**がオンでも、声が加工されたように聞こえます。
- **曲のキーは音程の幅で変える**：たとえば -2 にすると、曲が全音 1 つ分下がります。
- **時間枠に合わせるには、テンポを少しだけ変える**：テンポを 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` のどちらか 1 つと、任意の `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 分未満は切り上げ）。数える範囲は 1〜30 分です。料金は入力の長さだけで決まり、設定には左右されません。

### チップマンクのような声や、巨人のような声にするにはどうすればよいですか？

「フォルマントを保持（自然な声）」をオフにします。そのうえで、チップマンクのような声にはピッチを上げ、巨人のような声にはピッチを下げます。
