> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# ByteDance2ReferenceNodeV2 - ComfyUI Built-in Node Documentation

> ByteDance Seedance 2.5 Reference to Video は、ByteDance Seedance モデル（Seedance 2.5、2.0、2.0 Fast、2.0 Mini）を使用して、テキストプロンプトと、オプションの参照画像・動画・音声、または以前にアップロードしたライブラリアセットに基づいて、動画を生成・編集・延長します。

ByteDance Seedance 2.5 Reference to Video は、ByteDance Seedance モデル（Seedance 2.5、2.0、2.0 Fast、2.0 Mini）を使用して、テキストプロンプトと、オプションの参照画像・動画・音声、または以前にアップロードしたライブラリアセットに基づいて、動画を生成・編集・延長します。参照をアップロードし、生成タスクを送信して完了を待ち、完成した動画ファイルを返します。

## 入力

### 共通入力

| パラメータ      | 説明                                                                                                                                                           | データ型           | 必須 | 範囲                                                                                   |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------- | -- | ------------------------------------------------------------------------------------ |
| `モデル`      | モデルセレクターです。Seedance 2.5 は最新モデルで、最大30秒の動画と mp4/mov 出力に対応します。Seedance 2.0 は最高品質と4Kに対応します。Fast は速度最適化用です。Mini は最速かつ低コストの生成用です。モデルを選択すると、以下に表示される入力ウィジェットが変わります。 | DYNAMIC\_COMBO | 必須 | "Seedance 2.5"<br />"Seedance 2.0"<br />"Seedance 2.0 Fast"<br />"Seedance 2.0 Mini" |
| `シード`      | シードは、ノードを再実行するかどうかを制御します。シードに関係なく結果は非決定的です。デフォルトは 0 です。                                                                                                      | INT            | 必須 | 0〜2147483647                                                                         |
| `ウォーターマーク` | 動画に透かしを追加するかどうかを指定します。デフォルトは false です。詳細設定です。                                                                                                                | BOOLEAN        | 必須 | true<br />false                                                                      |

### Seedance 2.5 入力

これらの入力は、`model` が "Seedance 2.5" に設定されている場合に表示されます。

| パラメータ            | 説明                                                                                                                                                                                                                                                                                                                                                                                                                                                              | データ型    | 必須 | 範囲                                                                              |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | -- | ------------------------------------------------------------------------------- |
| `prompt`         | 動画生成用のテキストプロンプトです。生成される台詞（会話）を制御するには、台詞を二重引用符で囲みます。デフォルトは空文字列です。                                                                                                                                                                                                                                                                                                                                                                                                | STRING  | 必須 | 複数行テキスト                                                                         |
| `resolution`     | 出力動画の解像度です。デフォルトは 720p です。                                                                                                                                                                                                                                                                                                                                                                                                                                      | COMBO   | 必須 | "480p"<br />"720p"<br />"1080p"                                                 |
| `ratio`          | 出力動画のアスペクト比です。デフォルトは 16:9 です。                                                                                                                                                                                                                                                                                                                                                                                                                                   | COMBO   | 必須 | "16:9"<br />"4:3"<br />"1:1"<br />"3:4"<br />"9:16"<br />"21:9"<br />"adaptive" |
| `duration`       | 出力動画の長さ（秒）です（4〜30）。デフォルトは 5 です。                                                                                                                                                                                                                                                                                                                                                                                                                                 | INT     | 必須 | 4〜30                                                                            |
| `generate_audio` | 出力動画の音声生成を有効にするかどうかを指定します。デフォルトは true です。                                                                                                                                                                                                                                                                                                                                                                                                                       | BOOLEAN | 必須 | true<br />false                                                                 |
| `task_type`      | 参照メディアの処理方法です。auto 以外のすべての値はタスク送信時に検証されるため、設定が一致しない場合は生成開始前に失敗します。<br />auto: モデルがプロンプトと入力からタスクを推測します。その解釈と競合する設定は生成開始後にのみ失敗します。<br />reference: 参照画像・動画・音声に基づいて新しい動画を生成します。<br />edit: 接続された参照動画を変更します（追加、削除、置き換え）。出力はソースクリップの長さとアスペクト比を維持し、duration と ratio ウィジェットは無視されます。<br />extend: 接続された参照動画を前方または後方に延長します。プロンプトには "extend forward"、"extend backward"、"continue" のいずれかを指定します。アスペクト比はソースクリップに従い、出力にはソースクリップではなく、設定した長さの新しく生成された部分のみが含まれます。デフォルトは auto です。 | COMBO   | 必須 | "auto"<br />"reference"<br />"edit"<br />"extend"                               |
| `output_format`  | 出力動画のコンテナ形式です。デフォルトは mp4 です。                                                                                                                                                                                                                                                                                                                                                                                                                                    | COMBO   | 必須 | "mp4"                                                                           |

### Seedance 2.0 入力

これらの入力は、`model` が "Seedance 2.0" に設定されている場合に表示されます。

| パラメータ            | 説明                                        | データ型    | 必須 | 範囲                                                                              |
| ---------------- | ----------------------------------------- | ------- | -- | ------------------------------------------------------------------------------- |
| `prompt`         | 動画生成用のテキストプロンプトです。デフォルトは空文字列です。           | STRING  | 必須 | 複数行テキスト                                                                         |
| `resolution`     | 出力動画の解像度です。                               | COMBO   | 必須 | "480p"<br />"720p"<br />"1080p"<br />"4k"                                       |
| `ratio`          | 出力動画のアスペクト比です。デフォルトは adaptive です。         | COMBO   | 必須 | "16:9"<br />"4:3"<br />"1:1"<br />"3:4"<br />"9:16"<br />"21:9"<br />"adaptive" |
| `duration`       | 出力動画の長さ（秒）です（4〜15）。デフォルトは 7 です。           | INT     | 必須 | 4〜15                                                                            |
| `generate_audio` | 出力動画の音声生成を有効にするかどうかを指定します。デフォルトは true です。 | BOOLEAN | 必須 | true<br />false                                                                 |

### Seedance 2.0 Fast と Seedance 2.0 Mini 入力

これらの入力は、`model` が "Seedance 2.0 Fast" または "Seedance 2.0 Mini" に設定されている場合に表示されます。両モデルは同じ入力セットを共有します。

| パラメータ            | 説明                                        | データ型    | 必須 | 範囲                                                                              |
| ---------------- | ----------------------------------------- | ------- | -- | ------------------------------------------------------------------------------- |
| `prompt`         | 動画生成用のテキストプロンプトです。デフォルトは空文字列です。           | STRING  | 必須 | 複数行テキスト                                                                         |
| `resolution`     | 出力動画の解像度です。                               | COMBO   | 必須 | "480p"<br />"720p"                                                              |
| `ratio`          | 出力動画のアスペクト比です。デフォルトは adaptive です。         | COMBO   | 必須 | "16:9"<br />"4:3"<br />"1:1"<br />"3:4"<br />"9:16"<br />"21:9"<br />"adaptive" |
| `duration`       | 出力動画の長さ（秒）です（4〜15）。デフォルトは 7 です。           | INT     | 必須 | 4〜15                                                                            |
| `generate_audio` | 出力動画の音声生成を有効にするかどうかを指定します。デフォルトは true です。 | BOOLEAN | 必須 | true<br />false                                                                 |

### 参照入力

これらの増設可能な参照スロットは、すべてのモデルで利用できます。スロットの最大数はモデルごとに異なります。Seedance 2.5 は画像を30個、動画を10個、音声を10個、アセットを30個まで対応し、Seedance 2.0、2.0 Fast、2.0 Mini は画像を9個、動画を3個、音声を3個、アセットを9個まで対応します。

| パラメータ              | 説明                                                                                                                                                                                                             | データ型    | 必須 | 範囲                                                         |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | -- | ---------------------------------------------------------- |
| `reference_images` | 増設可能スロットです。出力をガイドする参照画像を1..N個接続します。個数制限はモデルごとに異なります（各モデルのセクションを参照してください）。画像はアスペクト比（0.4〜2.5）が検証され、長辺が最大6000ピクセルに自動的に縮小されます。                                                                                     | IMAGE   | 任意 | 1..9 スロット（Seedance 2.0 シリーズ）<br />1..30 スロット（Seedance 2.5） |
| `reference_videos` | 増設可能スロットです。参照動画を1..N個接続します。個数制限はモデルごとに異なります（各モデルのセクションを参照してください）。各動画は1.8秒以上である必要があり、選択したモデルと解像度のピクセル制限内に収まる必要があります。                                                                                            | VIDEO   | 任意 | 1..3 スロット（Seedance 2.0 シリーズ）<br />1..10 スロット（Seedance 2.5） |
| `reference_audios` | 増設可能スロットです。参照音声トラックを1..N個接続します。個数制限はモデルごとに異なります（各モデルのセクションを参照してください）。各音声は1.8秒以上である必要があります。                                                                                                                     | AUDIO   | 任意 | 1..3 スロット（Seedance 2.0 シリーズ）<br />1..10 スロット（Seedance 2.5） |
| `reference_assets` | 増設可能スロットです。Seedance 仮想ライブラリにすでにアップロードされているメディアのアセットIDの文字列を1..N個接続します。各アセットは Active ステータスである必要があります。プロンプト内では `asset1` や `asset 1` のようなトークンでアセットを参照できます。ノードはこれらのトークンを、そのアセットの位置ラベル（例:「Image 2」「Video 1」）に置き換えます。 | STRING  | 任意 | 1..9 スロット（Seedance 2.0 シリーズ）<br />1..30 スロット（Seedance 2.5） |
| `auto_downscale`   | 選択した解像度におけるモデルのピクセル上限を超える参照動画を自動的にダウンスケールします。アスペクト比は維持され、制限内の動画は変更されません。デフォルトは true です。                                                                                                                        | BOOLEAN | 任意 | true<br />false                                            |
| `auto_upscale`     | 選択した解像度におけるモデルの最小ピクセル数を下回る参照動画を自動的にアップスケールします。アスペクト比は維持され、最小値を満たしている動画は変更されません。注: 低解像度のソースをアップスケールしても実際のディテールは追加されず、生成品質が低下する可能性があります。デフォルトは false です。詳細設定です。                                                  | BOOLEAN | 任意 | true<br />false                                            |

**注:** ノードを実行するには、参照画像・動画・アセットのうち少なくとも1つが必要です（Seedance 2.5 は音声のみの参照も受け付けます）。各参照動画と各参照音声は、それぞれ1.8秒以上である必要があり、すべての参照動画の合計時間（参照音声も同様に合計）は、選択したモデルの最大合計秒数を超えてはなりません。参照画像のアスペクト比はおおよそ2:5〜5:2（0.4〜2.5）の範囲内である必要があり、300x300 ピクセル以上で、長辺が最大6000ピクセルに自動的に縮小されます。`task_type` の "edit" と "extend" オプションは Seedance 2.5 でのみ利用でき、いずれも少なくとも1つの参照動画が必要です。"edit" を使用する場合、出力はソースクリップの長さとアスペクト比を維持し、`duration` と `ratio` ウィジェットは無視されます。"extend" を使用する場合、出力には設定した長さの新しく生成された部分のみが含まれます。参照アセットは Active ステータスである必要があります。そうでない場合、タスクは失敗します。

## 出力

| 出力名     | 説明                                                           | データ型  |
| ------- | ------------------------------------------------------------ | ----- |
| `video` | 生成された動画です。生成タスクが完了するとプロバイダーからダウンロードされます。音声生成が有効な場合は音声が含まれます。 | VIDEO |

> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください！ [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/ja.md)

***

**Source fingerprint (SHA-256):** `3a6bba12e719204ba5dba9d7d5f2b4c5285ed68974ee015b6e4a7892a1cf0933`