Omni-Video

POST

/kling/v1/videos/omni-video

Omni-Video 동영상 생성 작업을 만듭니다(텍스트→동영상, 이미지→동영상, 동영상 편집 등).

Authorizations

bearer

Type

HTTP (bearer)

Request Body

application/json

object

모델 이름. 열거값: kling-video-o1, kling-v3-omni

텍스트 프롬프트. 긍정·부정 설명을 포함할 수 있습니다.
용도에 맞게 템플릿화할 수 있습니다.
최대 2500자.
multi_shot이 false일 때 필수입니다.

object[]

참조 이미지 목록(피사체, 장면, 스타일 등) 또는 동영상의 첫/마지막 프레임으로 사용.
첫/마지막 프레임으로 사용할 때:
type으로 first_frame(첫 프레임), end_frame(마지막 프레임) 지정.
마지막 프레임만은 지원하지 않음. end_frame이 있으면 first_frame 필수.
첫/마지막 프레임 생성과 동영상 편집은 동시에 사용할 수 없습니다.

object[]

URL로 지정하는 참조 동영상.
특징 참조 동영상 또는 편집 대상 동영상(기본값: 편집 대상). 원음 유지 선택 가능.
refer_type: feature = 특징 참조, base = 편집 대상.
base일 때는 첫/마지막 프레임을 지정할 수 없습니다.
keep_original_sound: yes = 유지, no = 제거. feature에도 적용됩니다.

동영상 생성 모드.
열거값: std, pro.
std: 표준 모드. 비용 대비 효율.
pro: 고품질 모드. 화질 우선.

출력 화면 비율(가로:세로).
열거값: 16:9, 9:16, 1:1.
첫 프레임 참조 또는 동영상 편집을 사용하지 않을 때 필수.

동영상 길이(초).
열거값: 3, 4, 5, 6, 7, 8, 9, 10.
텍스트→동영상, 첫 프레임 이미지→동영상에서는 5와 10만 지원.
동영상 편집(refer_type이 base) 시 출력 길이는 입력과 동일하며 이 필드는 무시됨. 과금은 입력 초를 반올림.
kling-v3-omni는 3–15 지원. 편집 시 규칙 동일.

object[]

피사체

멀티 샷 동영상 생성 여부.
true일 때 prompt는 무시됨.
false일 때 shot_type과 multi_prompt는 무시됨.

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

object[]