> ## 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.

# ByteDance2ReferenceNode - ComfyUI Built-in Node Documentation

> このノードは、ByteDance の Seedance 2.5 または Seedance 2.0 AI モデルを使用して、動画を生成、編集、または延長します。

このノードは、ByteDance の Seedance 2.5 または Seedance 2.0 AI モデルを使用して、動画を生成、編集、または延長します。テキストプロンプトで動画を記述し、参照画像、動画、音声を添付して結果を誘導できます。マルチモーダル参照、動画編集、動画延長をサポートします。これは Seedance の参照から動画へのノードのレガシー（非推奨）バージョンです。

## 入力

`model` を選択すると、以下のどのパラメータが使用可能になるかが決まります。`video_editing` と `output_format` は、Seedance 2.5 を選択した場合にのみ表示されます。拡張可能な参照スロットと参照動画の自動リサイズオプションはすべてのモデルで共通であり、「参照入力」で説明します。

### 共通入力

| パラメータ      | 説明                                                                                                                                                                | データ型           | 必須 | 範囲                                                                                           |
| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | -- | -------------------------------------------------------------------------------------------- |
| `モデル`      | 動画生成に使用する AI モデルです。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<br />ステップ: 1                                                                    |
| `ウォーターマーク` | 動画にウォーターマークを追加するかどうか（デフォルト: False）。詳細設定です。                                                                                                                        | BOOLEAN        | はい | `True`<br />`False`                                                                          |

### Seedance 2.5 入力

| パラメータ            | 説明                                                                                                                                                                                   | データ型    | 必須 | 範囲                                                                                            |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------- | -- | --------------------------------------------------------------------------------------------- |
| `prompt`         | 動画生成用のテキストプロンプトです。生成されるセリフを誘導するには、話される行を二重引用符で囲みます。少なくとも 1 つの空白以外の文字を含める必要があります（デフォルト: 空）。                                                                                           | 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`       | 出力動画の長さ（秒単位）（デフォルト: 5）。                                                                                                                                                              | INT     | はい | 4～30<br />ステップ: 1                                                                             |
| `generate_audio` | 出力動画の音声生成を有効にします（デフォルト: True）。                                                                                                                                                       | BOOLEAN | はい | `True`<br />`False`                                                                           |
| `video_editing`  | プロンプトが接続された参照動画を編集する場合（たとえば、その中のオブジェクトを置き換える場合）に有効にします。その場合、出力はソースクリップ自体の長さとアスペクト比を維持し、`duration` と `ratio` ウィジェットは無視されます。新しい動画を生成する場合、または設定した長さまで動画を延長する場合は無効のままにします（デフォルト: False）。 | BOOLEAN | はい | `True`<br />`False`                                                                           |
| `output_format`  | 出力動画のコンテナ形式（デフォルト: `"mp4"`）。                                                                                                                                                         | COMBO   | はい | `"mp4"`                                                                                       |

### Seedance 2.0 入力

| パラメータ            | 説明                                                        | データ型    | 必須 | 範囲                                                                                            |
| ---------------- | --------------------------------------------------------- | ------- | -- | --------------------------------------------------------------------------------------------- |
| `prompt`         | 動画生成用のテキストプロンプトです。少なくとも 1 つの空白以外の文字を含める必要があります（デフォルト: 空）。 | 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`       | 出力動画の長さ（秒単位）（デフォルト: 7）。                                   | INT     | はい | 4～15<br />ステップ: 1                                                                             |
| `generate_audio` | 出力動画の音声生成を有効にします（デフォルト: True）。                            | BOOLEAN | はい | `True`<br />`False`                                                                           |

### Seedance 2.0 Fast および Seedance 2.0 Mini 入力

Seedance 2.0 Fast と Seedance 2.0 Mini で共通です。これら 2 つのモデルは、Seedance 2.0 と同じ入力セットを公開しますが、`resolution` が 480p と 720p に制限されます。

| パラメータ            | 説明                                                        | データ型    | 必須 | 範囲                                                                                            |
| ---------------- | --------------------------------------------------------- | ------- | -- | --------------------------------------------------------------------------------------------- |
| `prompt`         | 動画生成用のテキストプロンプトです。少なくとも 1 つの空白以外の文字を含める必要があります（デフォルト: 空）。 | 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`       | 出力動画の長さ（秒単位）（デフォルト: 7）。                                   | INT     | はい | 4～15<br />ステップ: 1                                                                             |
| `generate_audio` | 出力動画の音声生成を有効にします（デフォルト: True）。                            | BOOLEAN | はい | `True`<br />`False`                                                                           |

### 参照入力

すべてのモデルで使用できます。最大スロット数は選択したモデルによって異なります。Seedance 2.5 は Seedance 2.0 モデルよりも多くの参照をサポートします。

| パラメータ              | 説明                                                                                                                                                                                                                    | データ型    | 必須  | 範囲                                              |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | --- | ----------------------------------------------- |
| `reference_images` | 拡張可能なスロット: 動画生成を誘導する 1 つ以上の参照画像（`image_1`、`image_2`、...）を接続します。画像は最大辺 6000 ピクセルに自動ダウンスケールされ、少なくとも 300x300 ピクセルで、アスペクト比が 0.4 ～ 2.5 の範囲である必要があります。                                                                      | IMAGE   | いいえ | 最大 30（Seedance 2.5）<br />最大 9（Seedance 2.0 モデル） |
| `reference_videos` | 拡張可能なスロット: 動画生成を誘導する 1 つ以上の参照動画（`video_1`、`video_2`、...）を接続します。動画編集と延長に使用されます。                                                                                                                                        | VIDEO   | いいえ | 最大 10（Seedance 2.5）<br />最大 3（Seedance 2.0 モデル） |
| `reference_audios` | 拡張可能なスロット: 動画生成を誘導する 1 つ以上の参照音声クリップ（`audio_1`、`audio_2`、...）を接続します。                                                                                                                                                   | AUDIO   | いいえ | 最大 10（Seedance 2.5）<br />最大 3（Seedance 2.0 モデル） |
| `auto_downscale`   | 選択した解像度でモデルのピクセル許容量を超える参照動画を自動的にダウンスケールします。アスペクト比は維持され、すでに制限内にある動画は変更されません（デフォルト: True）。                                                                                                                              | BOOLEAN | いいえ | `True`<br />`False`                             |
| `auto_upscale`     | 詳細設定です。選択した解像度でモデルの最小ピクセル数を下回る参照動画を自動的にアップスケールします。アスペクト比は維持され、すでに最小値を満たしている動画は変更されません。注: 低解像度のソースをアップスケールしても実際のディテールは追加されず、生成品質が低下する可能性があります（デフォルト: False）。                                                           | BOOLEAN | いいえ | `True`<br />`False`                             |
| `reference_assets` | 拡張可能なスロット: 参照として使用する、以前に作成された Seedance バーチャルライブラリアセット（画像、動画、または音声）の ID（`asset_1`、`asset_2`、...）です。各アセットは存在し、Active ステータスである必要があります。プロンプト内では、アセットを `asset1`、`asset 1` などとして参照できます。ノードはこれらのトークンを「Image 2」などのラベルに置き換えます。 | STRING  | いいえ | 最大 30（Seedance 2.5）<br />最大 9（Seedance 2.0 モデル） |

**重要な制約:**

* 少なくとも 1 つの参照が必要です。Seedance 2.0、2.0 Fast、および 2.0 Mini では、少なくとも 1 つの画像または動画参照を提供する必要があります（`reference_images`、`reference_videos`、または `reference_assets` 内の画像もしくは動画エントリ経由）。Seedance 2.5 はさらに、音声のみの参照も受け付けます（`reference_audios` または音声の `reference_assets` エントリ経由）。
* 参照数はモデルに依存し、直接入力とアセット参照を合算して検証されます。Seedance 2.5 では最大 30 個の `reference_images`、10 個の `reference_videos`、10 個の `reference_audios`、30 個の `reference_assets` が許可されます。Seedance 2.0 モデルでは最大 9 個の画像、3 個の動画、3 個の音声クリップ、9 個のアセットが許可されます。
* 各参照動画は少なくとも 1.8 秒の長さが必要で、各参照音声クリップも少なくとも 1.8 秒の長さが必要です。すべての参照動画とすべての参照音声の合計時間は、選択したモデルの制限内（Seedance 2.0 モデルでは 15.1 秒）に収める必要があります。
* 参照動画は、選択した解像度におけるモデルのピクセル数制限も満たす必要があります。`auto_downscale` が有効（デフォルト）の場合、大きすぎる動画は自動的にリサイズされます。`auto_upscale` が有効な場合、小さすぎる動画は拡大されます。いずれかの自動調整が無効になっている場合、対応する制限外の動画はエラーになります。
* Seedance 2.5 で `video_editing` を有効にすると、`duration` と `ratio` 入力は無視されます。出力は参照動画自体の長さとアスペクト比に一致します。プロバイダーがプロンプトを参照動画の編集として解釈した場合、`video_editing` が有効でないか、プロンプトが新しい動画を記述するように言い換えられていない限り、生成は失敗します。
* プロバイダーが動画用に生成された音声トラックを拒否した場合（たとえば、著作権一致の可能性がある場合）、タスクは失敗します。`generate_audio` を無効にすると、無音の動画が生成されます。

## 出力

| 出力名     | 説明           | データ型  |
| ------- | ------------ | ----- |
| `video` | 生成された動画ファイル。 | VIDEO |

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

***

**Source fingerprint (SHA-256):** `4a1b62f65ff3515cdb749c9b3916e631e53523fe144e8cdf71ca020825196ae6`