> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-chore-sync-comfy-api-v2-spec.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 または 2.0 AI モデルを使用して、ビデオの生成、編集、または延長を行います。

このノードは、ByteDance の Seedance 2.5 または 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つのモデルは、`resolution` が 480p と 720p に制限されることを除き、Seedance 2.0 と同じ入力セットを公開します。

| パラメータ            | 説明                                               | データ型    | 必須 | 範囲                                                                                            |
| ---------------- | ------------------------------------------------ | ------- | -- | --------------------------------------------------------------------------------------------- |
| `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 では、`reference_images` 最大30、`reference_videos` 最大10、`reference_audios` 最大10、`reference_assets` 最大30 が許可されます。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`