Skip to main content
POST

인증

string
필수
모든 요청에 Bearer Token 인증이 필요합니다API Key 발급:API Key 관리 페이지에서 API Key를 발급받으세요각 요청에 다음 헤더를 추가하세요:

요청 파라미터

string
필수
모델 이름: kling-v3-motion-control 또는 kling-v2-6-motion-control
string
동작, 카메라 움직임, 스타일을 보완하는 텍스트 프롬프트선택 사항이지만 구체적으로 작성할수록 안정적인 결과를 얻을 수 있습니다예: "캐릭터가 참조 동영상에 맞춰 춤을 춥니다, 부드러운 동작, 사실적인 스타일"
string
필수
참조 이미지 URL공개적으로 접근 가능한 링크여야 합니다
string
필수
참조 동영상 URL공개적으로 접근 가능한 직접 링크여야 합니다. mp4/mov 권장, 100MB 이하
서버가 video_url의 실제 시간을 측정합니다. 최소 3초이며, 최대값은 character_orientation에 따라 결정됩니다.
string
기본값:"yes"
참조 동영상의 원본 음성을 유지할지 여부선택 값:
  • yes: 원본 음성 유지 (기본값)
  • no: 원본 음성 유지 안 함
string
필수
캐릭터 방향 제어 방식선택 값:
  • image: 참조 이미지의 캐릭터 방향 사용 (참조 동영상 시간: 3~10s)
  • video: 참조 동영상의 캐릭터 방향 사용 (참조 동영상 시간: 3~30s)
string
필수
생성 모드선택 값:
  • std: 표준 모드 (속도와 품질의 균형)
  • pro: 고품질 모드 (처리 시간이 길어집니다)
object
워터마크 제어 객체 (선택 사항)

시간 규칙

과금 시간은 서버가 video_url에서 측정한 실제 시간을 기준으로 하며, 클라이언트 측 추정값이 아닙니다.

응답

integer
응답 상태 코드, 성공 시 200
array
응답 데이터 배열

사용 예시

예시 1: image 방향 (10초 이내)

예시 2: video 방향 (30초 이내)