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

# GrokVideoReferenceNode - ComfyUI Built-in Node Documentation

> Grok Reference-to-Videoノードは、テキストプロンプトから動画を生成し、最大7枚の参照画像を使用して出力のスタイルと内容をガイドします。

Grok Reference-to-Videoノードは、テキストプロンプトから動画を生成し、最大7枚の参照画像を使用して出力のスタイルと内容をガイドします。`grok-imagine-video-1.5`モデルでは、プリセット音声リファレンスを最大3つ添付でき、`@ImageN`タグと`@AudioN`タグを使用してプロンプト内で画像と音声を直接参照することもできます。このノードはリクエストを外部APIに送信し、生成の完了を待って、結果の動画をダウンロードします。

## 入力

### 共通入力

| パラメータ   | 説明                                                    | データ型           | 必須 | 範囲                                                     |
| ------- | ----------------------------------------------------- | -------------- | -- | ------------------------------------------------------ |
| `モデル`   | 動画生成に使用するモデル。                                         | DYNAMIC\_COMBO | はい | `"grok-imagine-video-1.5"`<br />`"grok-imagine-video"` |
| `プロンプト` | 生成する動画のテキストによる説明。空でない文字列である必要があります。                   | STRING         | はい | N/A                                                    |
| `シード`   | ノードを再実行するかどうかを決定するシード。実際の結果はシードに関係なく非決定的です（デフォルト: 0）。 | INT            | はい | 0〜2147483647                                           |

### Grok Imagine Video 1.5 入力

`model`が`grok-imagine-video-1.5`に設定されている場合に使用できます。

| パラメータ          | 説明                                                                                            | データ型  | 必須  | 範囲                                                                                      |
| -------------- | --------------------------------------------------------------------------------------------- | ----- | --- | --------------------------------------------------------------------------------------- |
| `voice_1`      | オプションのプリセット音声リファレンス。プロンプトでは@Audio1として参照します。APIはカスタム音声ではなく、これらのプリセット音声のみをサポートします（デフォルト: none）。 | COMBO | いいえ | プリセット音声オプション（`"none"`を含む）                                                               |
| `voice_2`      | オプションの2番目の音声リファレンス。プロンプトでは@Audio2として参照します（デフォルト: none）。                                       | COMBO | いいえ | プリセット音声オプション（`"none"`を含む）                                                               |
| `voice_3`      | オプションの3番目の音声リファレンス。プロンプトでは@Audio3として参照します（デフォルト: none）。                                       | COMBO | いいえ | プリセット音声オプション（`"none"`を含む）                                                               |
| `resolution`   | 出力動画の解像度。                                                                                     | COMBO | はい  | `"480p"`<br />`"720p"`                                                                  |
| `aspect_ratio` | 出力動画のアスペクト比。                                                                                  | COMBO | はい  | `"16:9"`<br />`"4:3"`<br />`"3:2"`<br />`"1:1"`<br />`"2:3"`<br />`"3:4"`<br />`"9:16"` |
| `duration`     | 出力動画の長さ（秒）（デフォルト: 6）。                                                                         | INT   | はい  | 1〜15                                                                                    |

### Grok Imagine Video 入力

`model`が`grok-imagine-video`に設定されている場合に使用できます。

| パラメータ          | 説明                    | データ型  | 必須 | 範囲                                                                                      |
| -------------- | --------------------- | ----- | -- | --------------------------------------------------------------------------------------- |
| `resolution`   | 出力動画の解像度。             | COMBO | はい | `"480p"`<br />`"720p"`                                                                  |
| `aspect_ratio` | 出力動画のアスペクト比。          | COMBO | はい | `"16:9"`<br />`"4:3"`<br />`"3:2"`<br />`"1:1"`<br />`"2:3"`<br />`"3:4"`<br />`"9:16"` |
| `duration`     | 出力動画の長さ（秒）（デフォルト: 6）。 | INT   | はい | 2〜10                                                                                    |

### 参照入力

| パラメータ              | 説明                                                                                                                                           | データ型  | 必須 | 範囲   |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- | ----- | -- | ---- |
| `reference_images` | グロウアブルスロット：動画生成をガイドするために、1〜7枚の参照画像を接続します。`grok-imagine-video-1.5`では、プロンプト内で入力順に番号を付けて@Image1 ... @Image7として参照します。バッチ入力は画像1枚ごとに1回としてカウントされます。 | IMAGE | はい | 1〜7枚 |

**注記：** 表示されるサブパラメータは、選択した`model`によって異なります。`grok-imagine-video-1.5`では、`voice_1`、`voice_2`、`voice_3`の入力が追加されます。参照画像は少なくとも1枚必要で、合計は最大7枚です（バッチ入力は画像1枚ごとに1回としてカウントされます）。`grok-imagine-video-1.5`では、プロンプト内で接続した画像を`@Image1` ... `@Image7`として、音声スロットを`@Audio1`、`@Audio2`、`@Audio3`として参照できます。番号のない`@image`または`@audio`は最初のものを参照します。`@AudioN`は有効な音声の順序ではなく、`voice_N`ウィジェットを参照します。接続されていない画像や、`none`に設定された音声スロットを参照するとエラーが発生します。APIはカスタム音声ではなく、プリセット音声のみをサポートします。

## 出力

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

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

***

**Source fingerprint (SHA-256):** `e584c450563eaa7fcb7751d2325f9ef847fa34a4342df01f2bd9ce2e4ff8f2c3`