텍스트→동영상

POST

/kling/v1/videos/text2video

텍스트 프롬프트로 동영상 생성 작업을 만듭니다.

Authorizations

bearer

Type

HTTP (bearer)

Request Body

application/json

object

모델 이름. 열거값: kling-v1, kling-v1-6, kling-v2-master, kling-v2-1-master, kling-v2-5-turbo, kling-v3

긍정 텍스트 프롬프트(최대 2500자)

멀티 샷 동영상 생성 여부.
true이면 prompt는 무시됩니다.
false이면 shot_type, multi_prompt는 무시됩니다.

샷 분할 방식.
열거값: customize
multi_shot이 true일 때 필수입니다.

object[]

샷별 정보(프롬프트, 길이 등).
● index, prompt, duration으로 샷 번호·프롬프트·길이 정의:
○ 최대 6샷, 최소 1샷
○ 샷별 내용 최대 512자
○ 각 샷 길이 ≤ 작업 총 길이, ≥ 1
○ 모든 샷 길이 합 = 작업 총 길이

부정 텍스트 프롬프트(최대 2500자)

동영상 생성 자유도. 값이 클수록 프롬프트와의 연관이 강해집니다

동영상 생성 모드.
열거값: std, pro
std: 표준 모드 — 가성비 중심
pro: 프로 모드 — 고품질

동영상과 함께 음성 생성 여부.
열거값: on, off
V2.6 이후 모델만 지원.

화면 비율(가로:세로)

동영상 길이(초)

object

워터마크 포함 결과도 생성할지 여부.
● enabled로 정의(key:value), 예:
"watermark_info": {
"enabled": boolean // true 생성, false 생략
}

object

카메라 움직임 제어(미지정 시 텍스트/이미지 입력에서 추론)