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

# KlingVideoNode - ComfyUI Built-in Node Documentation

> 이 노드는 Kling V3 모델을 사용하여 비디오를 생성합니다. 텍스트 설명에서 비디오를 생성하는 텍스트-투-비디오 모드와 기존 이미지를 애니메이션화하는 이미지-투-비디오 모드를 지원합니다. 또한 각 부분에 개별 프롬프트가 있는 다중 세그먼트 비디오 생성(스토리보드)과 선택적으로 비디오에 수반되는 오디오를 생성하는 고급

이 노드는 Kling V3 모델을 사용하여 비디오를 생성합니다. 텍스트 설명에서 비디오를 생성하는 텍스트-투-비디오 모드와 기존 이미지를 애니메이션화하는 이미지-투-비디오 모드를 지원합니다. 또한 각 부분에 개별 프롬프트가 있는 다중 세그먼트 비디오 생성(스토리보드)과 선택적으로 비디오에 수반되는 오디오를 생성하는 고급 기능도 제공합니다.

## 입력

### 공통 입력

| 매개변수     | 설명                                                                                                         | 데이터 타입         | 필수 여부 | 범위                                                                                                                                                    |
| -------- | ---------------------------------------------------------------------------------------------------------- | -------------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `멀티 샷`   | 개별 프롬프트와 지속 시간을 가진 일련의 비디오 세그먼트를 생성합니다. 스토리보드 옵션으로 설정하면 각 스토리보드의 프롬프트와 지속 시간에 대한 추가 입력이 나타납니다.             | DYNAMIC\_COMBO | 예     | `"disabled"`<br />`"1 storyboard"`<br />`"2 storyboards"`<br />`"3 storyboards"`<br />`"4 storyboards"`<br />`"5 storyboards"`<br />`"6 storyboards"` |
| `모델`     | 모델 및 생성 설정입니다. 모델을 선택하면 해당 모델의 해상도와 화면 비율 하위 매개변수가 표시됩니다.                                                  | DYNAMIC\_COMBO | 예     | `"kling-v3"`<br />`"kling-3.0-turbo"`                                                                                                                 |
| `오디오 생성` | 활성화하면 노드가 비디오에 대한 오디오를 생성합니다. 참고: `"kling-3.0-turbo"`는 항상 기본 오디오를 생성하므로 이 모델에서는 이 토글이 무시됩니다. 기본값은 True입니다. | BOOLEAN        | 예     | True<br />False                                                                                                                                       |
| `시드`     | 시드는 노드의 재실행 여부를 제어합니다. 결과는 시드와 관계없이 비결정적입니다. 기본값은 0입니다.                                                    | INT            | 예     | 0\~2147483647                                                                                                                                         |
| `시작 프레임` | 선택적 시작 프레임 이미지입니다. 연결하면 이미지-투-비디오 모드로 전환됩니다.                                                               | IMAGE          | 아니요   | -                                                                                                                                                     |

### kling-v3 입력

| 매개변수  | 설명                                        | 데이터 타입 | 필수 여부 | 범위                                  |
| ----- | ----------------------------------------- | ------ | ----- | ----------------------------------- |
| `해상도` | 생성된 비디오의 해상도입니다. 기본값은 `"1080p"`입니다.       | COMBO  | 예     | `"4k"`<br />`"1080p"`<br />`"720p"` |
| `종횡비` | 생성된 비디오의 화면 비율입니다. 이미지-투-비디오 모드에서는 무시됩니다. | COMBO  | 예     | `"16:9"`<br />`"9:16"`<br />`"1:1"` |

### kling-3.0-turbo 입력

| 매개변수  | 설명                                        | 데이터 타입 | 필수 여부 | 범위                                  |
| ----- | ----------------------------------------- | ------ | ----- | ----------------------------------- |
| `해상도` | 생성된 비디오의 해상도입니다. 기본값은 `"720p"`입니다.        | COMBO  | 예     | `"1080p"`<br />`"720p"`             |
| `종횡비` | 생성된 비디오의 화면 비율입니다. 이미지-투-비디오 모드에서는 무시됩니다. | COMBO  | 예     | `"16:9"`<br />`"9:16"`<br />`"1:1"` |

### 멀티샷 입력

**`multi_shot`이 `"disabled"`로 설정된 경우:**

| 매개변수              | 설명                                            | 데이터 타입 | 필수 여부 | 범위       |
| ----------------- | --------------------------------------------- | ------ | ----- | -------- |
| `prompt`          | 비디오에 대한 주요 텍스트 설명입니다. 1\~2500자 사이여야 합니다.      | STRING | 예     | 1\~2500자 |
| `negative_prompt` | 비디오에 나타나지 않아야 할 내용을 설명하는 텍스트입니다. 비워 둘 수 있습니다. | STRING | 아니요   | -        |
| `duration`        | 비디오의 길이(초)입니다. 기본값은 5입니다.                     | INT    | 예     | 3\~15초   |

**`multi_shot`이 스토리보드 옵션(예: `"3 storyboards"`)으로 설정된 경우:**

각 스토리보드 세그먼트 N(1부터 선택한 스토리보드 개수까지)에 대해 다음 입력이 나타납니다:

| 매개변수                    | 설명                                    | 데이터 타입 | 필수 여부 | 범위      |
| ----------------------- | ------------------------------------- | ------ | ----- | ------- |
| `storyboard_N_prompt`   | 스토리보드 세그먼트 N에 대한 프롬프트입니다. 최대 512자입니다. | STRING | 예     | 1\~512자 |
| `storyboard_N_duration` | 스토리보드 세그먼트 N의 길이(초)입니다. 기본값은 4입니다.    | INT    | 예     | 1\~15초  |

**제약 조건 및 동작:**

* `start_frame`이 연결되지 않은 경우 텍스트-투-비디오 모드가 사용되고, `start_frame`이 연결된 경우 이미지-투-비디오 모드가 사용됩니다. 이미지-투-비디오 모드에서는 `model.aspect_ratio`이 무시되며 입력 이미지는 최소 300x300픽셀이어야 하고 화면 비율이 1:2.5에서 2.5:1 사이여야 합니다.
* 스토리보드 모드에서는 기본 `prompt`와 `negative_prompt`가 사용되지 않습니다. 모든 스토리보드 지속 시간의 합계는 3초에서 15초 사이여야 합니다.
* `negative_prompt`는 `kling-v3`에서만 사용됩니다. `kling-3.0-turbo`를 선택하면 무시됩니다.
* `kling-v3`의 경우 각 스토리보드는 API에 별도의 세그먼트로 전송됩니다. `kling-3.0-turbo`의 경우 스토리보드 프롬프트와 지속 시간이 단일 멀티샷 프롬프트로 결합됩니다.
* `kling-3.0-turbo`의 경우 이 모델이 항상 기본 오디오를 생성하므로 `generate_audio`는 무시됩니다.

## 출력

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

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

***

**Source fingerprint (SHA-256):** `2863d7a971a1978b6009e5321ed2112a9c04809281acd5f65d85ab72c4b49f08`