> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-comfy-docs-comfyapi-search.mintlify.site/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`