> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-recommend-assets-api.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Vidu2ReferenceVideoNode - ComfyUI 組み込みノードのドキュメント

> ComfyUI における Vidu2ReferenceVideoNode ノードの完全なドキュメントです。入力、出力、パラメーターおよび使用方法について学びましょう。

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

Vidu2 参照動画生成ノード（Vidu2 Reference-to-Video Generation node）は、テキストプロンプトと複数の参照画像から動画を生成します。最大7つの被写体（サブジェクト）を定義でき、それぞれに独自の参照画像セットを指定できます。プロンプト内では `@subject{subject_id}` を用いて各被写体を参照します。このノードでは、再生時間、アスペクト比、および動きの強さを設定可能な動画を生成できます。

## 入力

| パラメーター               | データ型     | 必須  | 範囲                                                            | 説明                                                                               |
| -------------------- | -------- | --- | ------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| `model`              | COMBO    | はい  | `"viduq2"`                                                    | 動画生成に使用する AI モデルです。                                                              |
| `subjects`           | AUTOGROW | はい  | N/A                                                           | 各被写体に対して最大3枚の参照画像を指定します（全被写体の合計で最大7枚）。プロンプト内では `@subject{subject_id}` を用いて参照します。 |
| `prompt`             | STRING   | はい  | N/A                                                           | 動画生成を制御するためのテキスト説明です。`audio` パラメーターが有効な場合、このプロンプトに基づいて生成された音声および背景音楽が動画に含まれます。   |
| `audio`              | BOOLEAN  | いいえ | N/A                                                           | 有効にすると、プロンプトに基づいて生成された音声および背景音楽が動画に含まれます（デフォルト値：`False`）。                        |
| `duration`           | INT      | いいえ | 1 ～ 10                                                        | 生成される動画の長さ（秒単位）です（デフォルト値：`5`）。                                                   |
| `seed`               | INT      | いいえ | 0 ～ 2147483647                                                | 再現可能な結果を得るために生成のランダム性を制御する数値です（デフォルト値：`1`）。                                      |
| `aspect_ratio`       | COMBO    | いいえ | `"16:9"`<br />`"9:16"`<br />`"4:3"`<br />`"3:4"`<br />`"1:1"` | 動画フレームの形状（アスペクト比）です。                                                             |
| `resolution`         | COMBO    | いいえ | `"720p"`<br />`"1080p"`                                       | 出力動画のピクセル解像度です。                                                                  |
| `movement_amplitude` | COMBO    | いいえ | `"auto"`<br />`"small"`<br />`"medium"`<br />`"large"`        | フレーム内のオブジェクトの動きの大きさ（振幅）を制御します。                                                   |

**制約条件：**

* `prompt` は 1 文字以上、2000 文字以下である必要があります。
* 複数の被写体を定義できますが、すべての被写体の参照画像の合計枚数は 7 枚を超えてはいけません。
* 各被写体には最大 3 枚の参照画像を指定できます。
* 各参照画像の横縦比（アスペクト比）は 1:4 から 4:1 の範囲内である必要があります。
* 各参照画像の幅および高さはともに最低 128 ピクセル以上である必要があります。

## 出力

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