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

# KlingOmniProTextToVideoNode - ComfyUI Built-in Node Documentation

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

# 개요

이 노드는 최신 Kling AI 모델을 사용하여 텍스트 설명으로부터 비디오를 생성합니다. 사용자의 프롬프트를 원격 API로 전송하고 생성된 비디오를 반환합니다. 이 노드를 통해 비디오의 길이, 화면 비율, 품질을 제어할 수 있으며, 멀티 샷 스토리보드도 생성할 수 있습니다.

## 입력

| 매개변수         | 설명                                                                           | 데이터 타입         | 필수 여부 | 범위                                                                                                                                                    |
| ------------ | ---------------------------------------------------------------------------- | -------------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `model_name` | 비디오 생성에 사용할 특정 Kling 모델입니다 (기본값: `"kling-v3-omni"`).                         | COMBO          | 예     | `"kling-v3-omni"`<br />`"kling-video-o1"`                                                                                                             |
| `프롬프트`       | 비디오 내용을 설명하는 텍스트 프롬프트입니다. 긍정적 설명과 부정적 설명을 모두 포함할 수 있습니다. 스토리보드가 활성화되면 무시됩니다. | STRING         | 예     | 0\~2500자                                                                                                                                              |
| `화면 비율`      | 생성할 비디오의 화면 비율 또는 형태입니다.                                                     | COMBO          | 예     | `"16:9"`<br />`"9:16"`<br />`"1:1"`                                                                                                                   |
| `지속 시간`      | 비디오의 길이(초)입니다 (기본값: 5).                                                      | INT            | 예     | 3\~15초                                                                                                                                                |
| `해상도`        | 비디오의 품질 또는 픽셀 해상도입니다 (기본값: `"1080p"`).                                       | COMBO          | 아니요   | `"4k"`<br />`"1080p"`<br />`"720p"`                                                                                                                   |
| `스토리보드`      | 개별 프롬프트와 지속 시간으로 구성된 일련의 비디오 세그먼트를 생성합니다. o1 모델에서는 무시됩니다.                    | DYNAMIC\_COMBO | 아니요   | `"disabled"`<br />`"1 storyboard"`<br />`"2 storyboards"`<br />`"3 storyboards"`<br />`"4 storyboards"`<br />`"5 storyboards"`<br />`"6 storyboards"` |
| `오디오 생성`     | 비디오에 오디오를 생성할지 여부입니다 (기본값: False).                                           | BOOLEAN        | 아니요   | True / False                                                                                                                                          |
| `시드`         | 시드는 노드 재실행 여부를 제어합니다. 시드와 관계없이 결과는 비결정적입니다 (기본값: 0).                         | INT            | 아니요   | 0\~2147483647                                                                                                                                         |

### 매개변수 제약 조건 및 제한 사항

* **모델별 제한 사항:**
  * `kling-video-o1` 모델은 **5초 또는 10초**의 지속 시간만 지원합니다.
  * `kling-video-o1` 모델은 오디오 생성을 **지원하지 않습니다**.
  * `kling-video-o1` 모델은 4k 해상도를 **지원하지 않습니다**.
  * `kling-video-o1` 모델은 스토리보드를 **지원하지 않습니다**.
* **스토리보드 제약 조건:**
  * 스토리보드가 활성화되면 `prompt` 필드는 무시됩니다.
  * 각 스토리보드에는 자체 프롬프트(1\~512자)와 지속 시간이 필요합니다.
  * 모든 스토리보드의 총 지속 시간은 전체 `duration` 매개변수와 정확히 일치해야 합니다.
* **프롬프트 요구 사항:**
  * 스토리보드가 **비활성화**된 경우 `prompt` 필드는 필수입니다 (최소 1자).
  * 스토리보드가 **활성화**된 경우 `prompt` 필드는 비워둘 수 있습니다 (0자).

## 출력

| 출력 이름    | 설명                                 | 데이터 타입 |
| -------- | ---------------------------------- | ------ |
| `output` | 제공된 텍스트 프롬프트와 설정을 기반으로 생성된 비디오입니다. | VIDEO  |

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

***

**Source fingerprint (SHA-256):** `2f867e0bd2e7b0ec901a9ad8d2adcfe712ed479c1613b80f86af3a20863e9f4c`
