KlingAI 노드 가이드
KlingAI API를 사용하여 이미지에서 비디오를 생성하는 노드입니다.
주요 기능
리소스별 작업
리소스 | 작업 | 설명 |
|---|---|---|
Image to Video | Create Video | 이미지를 비디오로 변환 |
Image to Video | Get Task Result | 비디오 생성 작업의 결과 조회 |
설정 항목
Image to Video > Create Video
항목 | 타입 | 기본값 | 설명 |
|---|---|---|---|
Image Source | 선택 |
| 이미지 소스 (Binary Data / URL) |
Image URL | 문자열 | - | 변환할 이미지의 URL (Image Source가 URL일 때, 필수) |
Binary Property | 문자열 |
| 이미지 바이너리 속성 이름 (Image Source가 Binary Data일 때) |
Prompt | 문자열 | - | 비디오 생성을 안내하는 텍스트 설명 (선택) |
추가 옵션
항목 | 타입 | 기본값 | 설명 |
|---|---|---|---|
Duration | 선택 |
| 생성할 비디오 길이 (5초 / 10초) |
Aspect Ratio | 선택 |
| 출력 비디오 화면 비율 (16:9 / 9:16 / 1:1) |
Mode | 선택 |
| 품질 모드 (Standard / Professional) |
Negative Prompt | 문자열 | - | 비디오에서 피할 요소 설명 |
CFG Scale | 숫자 |
| 프롬프트 준수 강도 (1~20). 높을수록 프롬프트에 충실 |
Image to Video > Get Task Result
항목 | 타입 | 기본값 | 설명 |
|---|---|---|---|
Task ID | 문자열 | - | 확인할 작업의 ID (필수) |
인증 정보
이 노드는 KlingAI API 인증 정보가 필요합니다.
자세한 설정 방법은 KlingAI API 인증 설정 가이드를 참고하세요.
사용 예시
이미지에서 비디오 생성 (2단계)
비디오 생성은 비동기적으로 처리되므로, 작업 제출과 결과 조회를 분리하여 수행합니다.
1단계: 비디오 생성 요청
KlingAI 노드에서 "Create Video" 작업을 선택합니다.
Image Source를 URL로 설정하고 이미지 URL을 입력합니다.
Prompt에 비디오의 동작이나 분위기를 설명합니다 (예: "카메라가 천천히 줌인하면서 구름이 흘러가는 장면").
실행하면 Task ID가 반환됩니다.
2단계: 결과 조회
Wait 노드를 추가하여 충분한 시간(예: 60~120초)을 대기합니다.
KlingAI 노드에서 "Get Task Result" 작업을 선택합니다.
Task ID에 1단계에서 받은 Task ID를 입력합니다.
비디오 생성이 완료되면 결과 데이터가 반환됩니다.
바이너리 이미지로 비디오 생성
이전 노드에서 생성된 이미지 바이너리 데이터를 사용합니다.
Image Source를 "Binary Data"로 설정합니다.
Binary Property에 바이너리 속성 이름을 입력합니다 (예:
data).이미지가 자동으로 Base64로 인코딩되어 API에 전송됩니다.
고품질 비디오 생성
추가 옵션에서 Mode를 "Professional"로 설정합니다.
Duration을 10초로 설정합니다.
CFG Scale을 조절하여 프롬프트 충실도를 제어합니다.
Negative Prompt에 피할 요소를 지정합니다 (예: "blurry, low quality").
참고 사항
비디오 생성은 비동기 작업입니다. "Create Video"로 작업을 제출한 후, "Get Task Result"로 결과를 확인해야 합니다.
Standard 모드는 빠르게 생성되고, Professional 모드는 더 높은 품질을 제공합니다.
Binary Data 소스를 사용할 경우, 이미지가 Base64로 인코딩되어
data:image/png;base64,...형식으로 전송됩니다.CFG Scale 값이 너무 높으면 부자연스러운 결과가 생길 수 있습니다. 7~10 범위가 일반적으로 적절합니다.
이 노드는
usableAsTool: true로 설정되어 있어 AI 에이전트의 도구로도 사용할 수 있습니다.Aspect Ratio는 입력 이미지의 비율과 다를 수 있으며, 출력 비디오에 적용됩니다.