> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# KlingVideoNode - ComfyUI Built-in Node Documentation

> Complete documentation for the KlingVideoNode node in ComfyUI. Learn its inputs, outputs, parameters and usage.

이 문서는 AI가 생성했습니다. 오류를 발견하거나 개선 제안이 있으시면 언제든지 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/KlingVideoNode/en.md)

이 노드는 Kling V3 모델을 사용하여 비디오를 생성합니다. 텍스트 설명으로 비디오를 만드는 텍스트-비디오 모드와 기존 이미지에 애니메이션을 적용하는 이미지-비디오 모드, 두 가지 주요 모드를 지원합니다. 또한 각 부분에 대해 서로 다른 프롬프트를 사용하여 여러 세그먼트로 구성된 비디오(스토리보드)를 만들고 선택적으로 오디오를 생성하는 고급 기능도 제공합니다.

## 입력

| 매개변수                 | 설명                                                                                                              | 데이터 타입  | 필수  | 범위                                                                                                                   |
| -------------------- | --------------------------------------------------------------------------------------------------------------- | ------- | --- | -------------------------------------------------------------------------------------------------------------------- |
| `멀티 샷`               | 단일 비디오를 생성할지, 아니면 개별 프롬프트와 지속 시간을 가진 일련의 세그먼트를 생성할지 제어합니다. "비활성화"가 아닌 경우 각 스토리보드의 프롬프트와 지속 시간에 대한 추가 입력이 나타납니다. | COMBO   | 예   | `"비활성화"`<br />`"1개 스토리보드"`<br />`"2개 스토리보드"`<br />`"3개 스토리보드"`<br />`"4개 스토리보드"`<br />`"5개 스토리보드"`<br />`"6개 스토리보드"` |
| `오디오 생성`             | 활성화하면 노드가 비디오에 대한 오디오를 생성합니다. 기본값은 `True`입니다.                                                                   | BOOLEAN | 예   | `True` / `False`                                                                                                     |
| `모델`                 | 모델 및 관련 설정입니다. 이 옵션을 선택하면 `resolution` 및 `aspect_ratio` 하위 매개변수가 표시됩니다.                                         | COMBO   | 예   | `"kling-v3"`                                                                                                         |
| `model.resolution`   | 생성된 비디오의 해상도입니다. 이 설정은 `모델`이 "kling-v3"로 설정된 경우 사용 가능합니다.                                                       | COMBO   | 예   | `"4k"`<br />`"1080p"`<br />`"720p"`                                                                                  |
| `model.aspect_ratio` | 생성된 비디오의 화면 비율입니다. `시작 프레임`(이미지-비디오 모드)에 이미지가 제공된 경우 이 설정은 무시됩니다. `모델`이 "kling-v3"로 설정된 경우 사용 가능합니다.            | COMBO   | 예   | `"16:9"`<br />`"9:16"`<br />`"1:1"`                                                                                  |
| `시드`                 | 생성을 위한 시드 값입니다. 이 값을 변경하면 노드가 다시 실행되지만 결과는 비결정적입니다. 기본값은 `0`입니다.                                                | INT     | 예   | 0 \~ 2147483647                                                                                                      |
| `시작 프레임`             | 선택적 시작 이미지입니다. 연결되면 노드가 텍스트-비디오 모드에서 이미지-비디오 모드로 전환되어 제공된 이미지에 애니메이션을 적용합니다.                                    | IMAGE   | 아니요 | -                                                                                                                    |

**`multi_shot` 모드의 입력:**

* `multi_shot`이 **"비활성화"** 로 설정된 경우 다음 입력이 나타납니다.
  * `prompt` (STRING): 비디오에 대한 주요 텍스트 설명입니다. 필수입니다. 1자에서 2500자 사이여야 합니다.
  * `negative_prompt` (STRING): 비디오에 나타나지 않아야 할 내용을 설명하는 텍스트입니다. 선택 사항입니다.
  * `duration` (INT): 비디오 길이(초)입니다. 3초에서 15초 사이여야 합니다. 기본값은 `5`입니다.
* `multi_shot`이 스토리보드 옵션(예: `"3개 스토리보드"`)으로 설정된 경우 각 스토리보드 세그먼트에 대한 입력(예: `storyboard_1_prompt`, `storyboard_1_duration`)이 나타납니다. 각 프롬프트는 1자에서 512자 사이여야 합니다. **모든 스토리보드 지속 시간의 총합**은 3초에서 15초 사이여야 합니다.

**제약 조건:**

* `start_frame`이 연결되지 않은 경우 노드는 **텍스트-비디오** 모드로 작동합니다. 이 모드에서는 `model.aspect_ratio` 설정을 사용합니다.
* `start_frame`이 연결된 경우 노드는 **이미지-비디오** 모드로 작동합니다. `model.aspect_ratio` 설정은 무시됩니다. 입력 이미지는 최소 300x300픽셀이어야 하며 화면 비율이 1:2.5에서 2.5:1 사이여야 합니다.
* 스토리보드 모드(`multi_shot`이 "비활성화"가 아님)에서는 기본 `prompt` 및 `negative_prompt` 입력이 숨겨지고 사용되지 않습니다.

## 출력

| 출력 이름   | 설명             | 데이터 타입 |
| ------- | -------------- | ------ |
| `video` | 생성된 비디오 파일입니다. | VIDEO  |

> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/KlingVideoNode/ko.md)

***

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