# 音声を差し替え

> 動画の話し声はそのままに新しい音楽を付けるか、すべての音を差し替えます。音楽はファイルから使うか、プロンプトから作り、1 回の実行で完了します。

Source: https://nodaro.ai/ja/docs/nodes/video/replace-audio

**音声を差し替え**ノードは、動画の中で人が話している内容を失わずに、動画に新しいサウンドトラックを付けます。動画の音から話し声をほかのすべての音と分離し、その下に新しい音楽を敷き、そのミックスを元の音の代わりに動画に乗せます。音楽は誰かが話している間は下がり、話の合間には元の音量に戻ります。

新しい音楽は、接続したファイルか、プロンプトから作られるトラックのどちらかです。すべてが 1 つのジョブとして、1 つの料金と 1 回の返還で実行されます。どれかのステップが失敗すると、実行全体が返還されます。

音声を差し替えは Nodaro Cloud でのみ実行されます。セルフホスティングのインストールではこのノードは提供されず、このノードを含むワークフローは実行できません。

## 使いどころ
- トーキングヘッドのクリップ、インタビュー、チュートリアルに、声を失わずに新しい音楽を付けます。
- 不要なサウンドトラックや著作権のあるサウンドトラックを、ライセンス済みのものや生成したものに替え、会話は残します。
- 一連のクリップに、同じ BGM を付けます。
- 音楽のプロンプトから、雰囲気の違う広告のバージョンを作ります。

## クイックスタート
### ノードを追加する
キャンバス上で Tab を押し、**動画 › 動画のサウンド › 音声を差し替え**を選びます。

### 動画を接続する
音を差し替えたい動画を、**動画**入力に接続します。

### 音楽を選ぶ
ファイルを使うには、音声、またはその音が使われる動画を、**音楽**入力に接続します。代わりに音楽を作るには、設定パネルで**音楽**を**プロンプトから作成**にし、**音楽のプロンプト**に説明を書きます。

### 実行する
ノードの**実行**をクリックします。新しい音の付いた動画がノードに表示されます。

Workflow: インタビューの声はそのままに、ライセンス済みのトラックが音楽を差し替えます。

- 動画アップロード → 音声を差し替え (動画)
- オーディオアップロード → 音声を差し替え (音楽)

## 入力
| 入力 | 受け付けるもの | 役割 |
| --- | --- | --- |
| **動画** | 動画ノード | 音を差し替える動画です。必須です。 |
| **音楽** | オーディオノードと動画ノード | 新しい音楽で、音声、またはその音が使われる動画です。ソースを 1 つ接続します。音楽をプロンプトから作る場合は空のままにします。 |

## 出力
出力の**動画**は、新しい音の付いた動画です。動画とちょうど同じ長さで、短い音楽はその後が無音になり、長い音楽はカットされます。

実行は、独自の 3 本のトラックも保持し、ノードの下とジョブに表示されます。最終的な**ミックス**、新しい**音楽**、そして話し声を残した場合は、分離した**話し声**です。

## 設定
| 設定 | 役割 |
| --- | --- |
| **モード** | **話し声を残す**（デフォルト）は、話し声を残して音楽を差し替えます。**すべての音を差し替える**は、話し声も含めて、新しい音楽を動画の唯一の音にします。 |
| **音楽** | 新しい音楽をどこから取るかです。**接続した音楽**（デフォルト）または**プロンプトから作成**です。 |
| **音楽のプロンプト** | 作る音楽を言葉で説明したもので、1,000 文字までです。たとえば「warm lo-fi piano, slow, gentle」（温かみのある lo-fi のピアノ、ゆっくり、やさしく）です。**プロンプトから作成**のときだけ使います。結果は、動画と同じ長さのインストゥルメンタルです。 |
| **音楽の音量** | 新しい音楽の大きさで、0%〜200% です。デフォルトは 80% です。 |
| **話し声の音量** | 残した話し声の大きさで、0%〜200% です。デフォルトは 100% です。 |
| **話し声の間の音楽の下げ幅** | 誰かが話している間に音楽をどれだけ下げるかで、0〜100 です。デフォルトは 70 です。0 では音楽の音量は変わりません。「話し声を残す」モードのみです。 |

## 制限
- 動画は 10 分まで、音楽をプロンプトから作る場合は 6 分までです。
- ファイルは 500 MB までです。
- 読み取れないファイル、映像のない動画、音のない音楽は、課金の前に拒否されます。

## クレジット
音声を差し替えは、実行ごとに 1 つの料金で、モードと音楽をどこから取るかで決まります。動画の長さでは料金は変わりません。

- **話し声を残す**は、先に話し声を分離するため、**すべての音を差し替える**より高くなります。
- **プロンプトから作る音楽**は、実行の中で音楽を作るため、音楽ファイルより高くなります。
- 実行の料金は、実際に行う処理で決まります。音のない動画での**話し声を残す**には残す話し声がないため、**すべての音を差し替える**として実行され、その料金になります。
- どれかのステップが失敗すると、実行全体が返還されます。

ノードは、実行ごとの料金を設定パネルと**実行**ボタンに表示します。

## ヒント
- **声には「話し声を残す」を使う**：トーキングヘッドのクリップ、インタビュー、チュートリアル、ナレーション付きの広告には、**話し声を残す**を使います。新しい音楽の上でも、声ははっきり聞こえます。
- **音楽だけのクリップはすべて差し替える**：元の音を何も残さなくてよい場合、たとえば音が音楽やノイズだけのクリップには、**すべての音を差し替える**を使います。
- **下げ幅を調整する**：音楽が声とぶつかる場合は、**話し声の間の音楽の下げ幅**を上げます。BGM をしっかり聞かせたい場合は下げます。
- **長い音楽でも問題ない**：動画より長い音楽ファイルは、動画の終わりでカットされます。
- **複数のトラックには動画とオーディオを結合を使う**：ナレーション、音楽、効果音をそれぞれの開始時間で加えるには、[**動画とオーディオを結合**](https://nodaro.ai/docs/nodes/video/merge-video-audio)を使います。

## API から
`POST /v1/replace-audio` は、`videoUrl` と、ちょうど 1 つの音楽のソース（`musicUrl` または `musicPrompt`）を受け取り、任意で `mode`（`keep-speech` または `replace-all`）、`musicVolume`、`speechVolume`、`duckAmount` も受け取ります。`{ jobId }` を返すので、`GET /v1/jobs/:jobId` でポーリングします。`Idempotency-Key` ヘッダーを付けると、再試行にはすでに開始したジョブが返されます。上限を超えるファイルは `413`、読み取れないファイルは `422` で、どちらも課金の前に返されます。

SDK のメソッドは `client.media.replaceAudio`、MCP のツールは `replace_audio` です。[音声とメディア](https://nodaro.ai/docs/developers/api/voice-and-media)を参照してください。

## よくある質問

### 音声を差し替えは何をするノードですか？

音声を差し替えは、動画に新しいサウンドトラックを付けます。「話し声を残す」モードでは、話し声をほかの音から分離し、その下に新しい音楽を敷き、誰かが話している間は音楽の音量を下げます。「すべての音を差し替える」モードでは、新しい音楽だけが音になります。

### 新しい音楽はどこから取りますか？

「音楽」入力に接続したファイル（音声、またはその音が使われる動画）か、プロンプトから作られるトラックのどちらかです。プロンプトから作られるトラックは、動画と同じ長さのインストゥルメンタルです。

### 結果の長さはどうなりますか？

結果は動画とちょうど同じ長さです。動画より短い音楽は、その後が無音になり、動画より長い音楽は、動画の終わりでカットされます。

### 音声を差し替えには何クレジットかかりますか？

実行ごとに 1 つの料金で、モードと音楽をどこから取るかで決まります。動画の長さでは変わりません。「話し声を残す」は「すべての音を差し替える」より高く、プロンプトから作る音楽はファイルより高くなります。「実行」ボタンに料金が表示されます。

### セルフホスティングのインストールで音声を差し替えを使えますか？

いいえ。音声を差し替えは Nodaro Cloud でのみ実行されます。セルフホスティングのインストールではこのノードは提供されず、このノードを含むワークフローは実行できません。
