Skip to content

모션 컨트롤

POST
/kling/v1/videos/motion-control

참고 이미지와 참고 비디오를 기반으로 모션 컨트롤 영상 작업을 생성합니다.

Authorizations

bearer
Type
HTTP (bearer)

Request Body

application/json
object

기본값: kling-v2-6, kling-v3

텍스트 프롬프트(긍정/부정 설명 포함 가능).
프롬프트로 장면 요소 추가, 카메라 무빙 제어 등을 할 수 있습니다. Kling “Motion Control” 가이드:
https://docs.qingque.cn/d/home/eZQAl5y8xNSkr0iYUS8-bpGvP?identityId=2Cn18n4EIHT#section=h.xtmfpd68o18
2500자를 초과할 수 없습니다.

참고 이미지(Base64 또는 접근 가능한 이미지 URL)로 인물/배경 등의 요소를 제약합니다.
지원 형식: .jpg / .jpeg / .png, 최대 10MB.
최소 300px, 가로세로 비율 1:2.5 ~ 2.5:1.

참고 비디오(접근 가능한 URL).
지원 형식: .mp4 / .mov, 최대 100MB.
가로/세로 한 변 길이는 340px~3850px 범위여야 합니다.
최소 3초, 최대 길이는 character_orientation에 따라 달라집니다.

참고 비디오의 원음을 유지할지 여부.
열거값: yes, no.

생성 영상에서 인물 방향(정면)의 참조 기준.
열거값: image, video.

  • image: 이미지 기준(참고 비디오 길이 10초 이하)
  • video: 비디오 기준(참고 비디오 길이 30초 이하)

영상 생성 모드.
열거값: std, pro.

  • std: 표준 모드(가성비)
  • pro: 프로 모드(고품질)
object[]

주체 참조 목록

object[]

워터마크가 포함된 결과도 함께 생성할지 여부

Responses

OK

application/json

Playground

Authorization
Body

Samples