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

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

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

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

このノードは Kling V3 モデルを用いて動画を生成します。主に2つのモードをサポートしており、1つはテキストから動画を生成する「テキスト→動画」モード（テキストによる説明から動画を作成）、もう1つは既存の画像をアニメーション化する「画像→動画」モードです。さらに、各セグメントに異なるプロンプトと再生時間を設定できるマルチセグメント動画（ストーリーボード）の作成や、オプションで付随する音声の生成といった高度な機能も提供しています。

## 入力

| パラメーター               | データ型    | 必須  | 範囲                                                                                                                                                    | 説明                                                                                                           |
| -------------------- | ------- | --- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| `multi_shot`         | COMBO   | はい  | `"disabled"`<br />`"1 storyboard"`<br />`"2 storyboards"`<br />`"3 storyboards"`<br />`"4 storyboards"`<br />`"5 storyboards"`<br />`"6 storyboards"` | 単一の動画を生成するか、個別のプロンプトと再生時間をもつ複数のセグメントを生成するかを制御します。「disabled」以外を選択すると、各ストーリーボードのプロンプトおよび再生時間のための追加入力項目が表示されます。 |
| `generate_audio`     | BOOLEAN | はい  | `True` / `False`                                                                                                                                      | 有効にすると、ノードは動画に付随する音声を生成します。デフォルト値は `True` です。                                                                |
| `model`              | COMBO   | はい  | `"kling-v3"`                                                                                                                                          | 使用するモデルおよびその関連設定です。このオプションを選択すると、`resolution` および `aspect_ratio` のサブパラメーターが表示されます。                           |
| `model.resolution`   | COMBO   | はい  | `"1080p"`<br />`"720p"`                                                                                                                               | 生成される動画の解像度です。`model` を `"kling-v3"` に設定した場合に利用可能です。                                                         |
| `model.aspect_ratio` | COMBO   | はい  | `"16:9"`<br />`"9:16"`<br />`"1:1"`                                                                                                                   | 生成される動画のアスペクト比です。`start_frame` に画像が指定された場合（画像→動画モード）には、この設定は無視されます。`model` を `"kling-v3"` に設定した場合に利用可能です。    |
| `seed`               | INT     | はい  | 0 ～ 2147483647                                                                                                                                        | 生成処理のシード値です。この値を変更するとノードが再実行されますが、結果は非決定的です。デフォルト値は `0` です。                                                  |
| `start_frame`        | IMAGE   | いいえ | -                                                                                                                                                     | オプションの開始画像です。接続すると、ノードは「テキスト→動画」モードから「画像→動画」モードに切り替わり、指定された画像をアニメーション化します。                                   |

**`multi_shot` モードにおける入力：**

* `multi_shot` を **"disabled"** に設定した場合、以下の入力が表示されます：
  * `prompt` (STRING): 動画の主なテキスト説明です。必須です。文字数は 1～2500 文字の範囲内である必要があります。
  * `negative_prompt` (STRING): 動画に含めたくない要素を記述したテキストです。任意です。
  * `duration` (INT): 動画の長さ（秒単位）です。3～15 秒の範囲である必要があります。デフォルト値は `5` です。
* `multi_shot` をストーリーボードオプション（例：`"3 storyboards"`）に設定した場合、各ストーリーボードセグメントに対応する入力（例：`storyboard_1_prompt`、`storyboard_1_duration`）が表示されます。各プロンプトの文字数は 1～512 文字である必要があります。**すべてのストーリーボードの再生時間の合計**は、3～15 秒の範囲である必要があります。

**制約条件：**

* `start_frame` が接続されていない場合、ノードは**テキスト→動画**モードで動作し、このモードでは `model.aspect_ratio` 設定が適用されます。
* `start_frame` が接続されている場合、ノードは**画像→動画**モードで動作します。このモードでは `model.aspect_ratio` 設定は無視されます。入力画像は、最低でも 300×300 ピクセルのサイズであり、アスペクト比が 1:2.5 ～ 2.5:1 の範囲内である必要があります。
* ストーリーボードモード（`multi_shot` が "disabled" でない場合）では、メインの `prompt` および `negative_prompt` 入力は非表示となり、使用されません。

## 出力

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