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

# Wan2ReferenceVideoApi - ComfyUI Built-in Node Documentation

> このノードは、提供された参照素材に基づいて人物または物体が登場する動画を生成します。

このノードは、提供された参照素材に基づいて人物または物体が登場する動画を生成します。Wan 2.7 モデルを使用してテキストプロンプトから動画を生成し、単一キャラクターの演技と複数キャラクターのインタラクションをサポートします。生成を機能させるには、少なくとも1つの参照動画または参照画像を提供する必要があります。

## 入力

### 共通入力

| パラメータ       | 説明                                                 | データ型           | 必須 | 範囲              |
| ----------- | -------------------------------------------------- | -------------- | -- | --------------- |
| `model`     | 動画生成に使用する特定のモデルです。                                 | DYNAMIC\_COMBO | はい | "wan2.7-r2v"    |
| `seed`      | 生成に使用するシードで、出力のランダム性を制御するのに役立ちます（デフォルト: 0）。        | INT            | はい | 0 〜 2147483647  |
| `watermark` | 結果にAI生成のウォーターマークを追加するかどうか（デフォルト: False）。これは詳細設定です。 | BOOLEAN        | はい | True<br />False |

### wan2.7-r2v 入力

| パラメータ             | 説明                                                                                                  | データ型   | 必須  | 範囲                                                  |
| ----------------- | --------------------------------------------------------------------------------------------------- | ------ | --- | --------------------------------------------------- |
| `prompt`          | 動画を説明するプロンプトです。参照キャラクターを指すには 'character1' や 'character2' などの識別子を使用してください。少なくとも1つのキャラクターを含める必要があります。 | STRING | はい  | -                                                   |
| `negative_prompt` | 避けるべき内容を説明するネガティブプロンプトです（デフォルト: 空）。                                                                 | STRING | いいえ | -                                                   |
| `resolution`      | 出力動画の解像度です。                                                                                         | COMBO  | はい  | "720P"<br />"1080P"                                 |
| `ratio`           | 出力動画のアスペクト比です。                                                                                      | COMBO  | はい  | "16:9"<br />"9:16"<br />"1:1"<br />"4:3"<br />"3:4" |
| `duration`        | 生成される動画の長さ（秒単位）（デフォルト: 5）。                                                                          | INT    | はい  | 2 〜 10                                              |

### 参照入力

| パラメータ              | 説明                                                                                 | データ型  | 必須  | 範囲          |
| ------------------ | ---------------------------------------------------------------------------------- | ----- | --- | ----------- |
| `reference_videos` | 拡張可能なスロット: 最大3つの参照動画を接続できます（スロット `video1`～`video3`）。全体として少なくとも1つの参照動画または参照画像が必要です。 | VIDEO | いいえ | 0 〜 3 items |
| `reference_images` | 拡張可能なスロット: 最大5つの参照画像を接続できます（スロット `image1`～`image5`）。全体として少なくとも1つの参照動画または参照画像が必要です。 | IMAGE | いいえ | 0 〜 5 items |

**重要な制約:**

* `reference_videos` または `reference_images` 入力に、少なくとも1つの参照動画または参照画像を提供する必要があります。そうしない場合、ノードはエラーを発生させます。
* 参照動画と参照画像を合計した数は5を超えることはできません。
* `prompt` 入力には、少なくとも1つのキャラクターを含める必要があります。

## 出力

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

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

***

**Source fingerprint (SHA-256):** `52ac550522bf3fe8f57444ce8586fe83be470b893ff8c01292743553cfbd623d`