> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.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.5 Draft、2.0、2.0 Fast、2.0 Mini）を使用し、テキストプロンプトと任意の参照画像、参照動画、参照オーディオ、または事前にアップロードされたライブラリアセットに導かれて、動画

ByteDance Seedance 2.5 Reference to Video は、ByteDance Seedance モデル（Seedance 2.5、2.5 Draft、2.0、2.0 Fast、2.0 Mini）を使用し、テキストプロンプトと任意の参照画像、参照動画、参照オーディオ、または事前にアップロードされたライブラリアセットに導かれて、動画を生成、編集、または延長します。参照をアップロードし、生成タスクを送信して、完了を待ち、完成した動画ファイルを返します。`Seedance 2.5 Draft` を選択すると、代わりに高速な 480p プレビューがレンダリングされます。結果の `draft_task_id` を ByteDance Seedance 2.5 Draft to Final Video ノードに接続すると、1080p の最終版をレンダリングできます。

## 入力

### 共通入力

| パラメータ | 説明 | データ型 | 必須 | 範囲 |
| - | - | - | - | - |
| `モデル` | モデルセレクター。Seedance 2.5 は最新モデル用で、最大30秒の動画と mp4 出力に対応します。Seedance 2.5 Draft は高速な 480p プレビューを生成し、その `draft_task_id` 出力を ByteDance Seedance 2.5 Draft to Final Video ノードに接続すると 1080p の最終版をレンダリングできます。Seedance 2.0 は最高品質と 4k に対応します。Fast は速度を最適化します。Mini は最速かつ最低コストの生成を提供します。モデルを選択すると、以下に表示される入力ウィジェットが変わります。 | DYNAMIC\_COMBO | はい | "Seedance 2.5"<br />"Seedance 2.5 Draft"<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.5 Draft 入力

これらの入力は、`model` が "Seedance 2.5 Draft" に設定されている場合に表示されます。パラメータセットは上記の Seedance 2.5 と同じですが、`resolution` で提供される値は `"480p"` のみです（デフォルト `"480p"`）。

### 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 ステータスである必要があり、そうでない場合タスクは失敗します。すべての実行はタスク ID を `draft_task_id` として返しますが、ByteDance Seedance 2.5 Draft to Final Video ノードでレンダリングできるのは `Seedance 2.5 Draft` 実行の ID のみです。そのため、他のモデルでは出力を未接続のままにする必要があり、そうでない場合実行は失敗します。

## 出力

| 出力名 | 説明 | データ型 |
| - | - | - |
| `video` | 生成された動画。生成タスクが完了するとプロバイダーからダウンロードされます。音声生成が有効な場合は音声が含まれます。 | VIDEO |
| `draft_task_id` | 実行によって返されるタスク ID。ByteDance Seedance 2.5 Draft to Final Video ノードがレンダリングできるドラフトを生成するのは `Seedance 2.5 Draft` 実行のみです。他のモデルでは、出力を未接続のままにする必要があり、そうでない場合実行は失敗します。 | STRING |

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

***

**Source fingerprint (SHA-256):** `12fee29b280ff71e29f268f52131d1c15cf3066e0804356b735b61d97c80a6a9`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.