Kling 3.0 모션 컨트롤 API
참조 비디오로 캐릭터 이미지를 애니메이션화. 방향 제어, 원본 오디오 보존, 비동기 API 전달로 프로덕션 워크플로우 요구사항 충족.
- $0.1134/초부터
- 720p / 1080p
- 입력: 이미지 + 비디오
- 최대 10s / 30s

Reference video motion, image character guidance, and async delivery in one production-ready route.
Image Reference
Element creation returns an element_id
Use it in Kling video generation
Upload a video showing the subject clearly — must contain a visible human face (max 8s, 720-2160px)
Click to upload or drag and drop
Supported formats: MP4, MOV, WEBM
Maximum file size: 100MB; Maximum files: 1
Click Generate to see preview
기록
최대 20개 항목0 실행 중 · 0 완료됨
Billing Rules
- •Fixed price: 1 Credit per element creation
- •Full refund on failure
- •Estimated processing time: ~10 minutes
Pricing
| Model | Mode | Type | Price |
|---|---|---|---|
| Kling Custom Element | Element Creation | Element Creation | Popular $0.0139/ request(1 Credits) |
If it's down, we automatically use the next cheapest available—ensuring 99.9% uptime at the best possible price.
모션 컨트롤 API로 무엇을 구축할 수 있나요?
가상 아바타와 캐릭터 애니메이션: 참조 비디오에서 구동
정적 캐릭터 이미지를 참조 퍼포먼스 비디오로 애니메이션화, 수동 리깅이나 프레임별 편집 불필요. 이 워크플로우는 크리에이터 도구, 가상 아바타, 숏폼 콘텐츠, 캐릭터 중심 비디오 제작에 적합하며, 특히 자연스러운 인물 모션이 중요한 장면에 최적.

댄스, 제스처, 퍼포먼스 전송: 소셜 콘텐츠용
댄스 동작, 제스처, 신체 퍼포먼스를 하나의 비디오에서 다른 캐릭터로 전송, 소셜 미디어 제작, 마케팅 자산, 크리에이터 워크플로우에 사용. 팀은 단일 모션 소스를 여러 캐릭터 주도 출력으로 변환하여 캠페인 반복 속도를 가속화할 수 있습니다.

참조 기반 모션 워크플로우: 방향 제어 지원
생성된 캐릭터가 소스 이미지의 방향을 따를지 참조 비디오의 방향을 따를지 제어하고, 예산과 제작 요구사항에 따라 720p 또는 1080p 출력 선택. 이를 통해 개발자는 일반적인 이미지-비디오 생성보다 구조화된 모션 제어 파이프라인을 얻습니다.

팀이 모션 컨트롤 API를 선택하는 이유
Kling 3.0 모션 컨트롤은 실제 퍼포먼스 소재를 캐릭터 애니메이션으로 변환하는 더 제어 가능한 방법을 제공하며, 예측 가능한 초당 가격 책정과 프로덕션 준비 API 워크플로우를 갖추고 있습니다.
일반 비디오 생성보다 제어 가능
모션 컨트롤은 모델이 처음부터 모션을 만들도록 하는 대신 참조 퍼포먼스 비디오를 모션 소스로 사용. 이를 통해 출력 동작 제어가 쉬워지며, 특히 캐릭터 중심 워크플로우에 적합합니다.
수동 리깅 없이 제작 가속화
팀은 정지 이미지와 모션 클립을 사용 가능한 애니메이션 출력으로 변환할 수 있으며, 전통적인 애니메이션 파이프라인을 구축할 필요가 없습니다. 이를 통해 프로토타입, 마케팅 자산, 크리에이터 도구의 설정 장벽이 낮아집니다.
반복 워크플로우에 적합한 예측 가능한 API 가격
초당 과금, 720p 및 1080p 모드, 명확한 기간 제한으로 비용 추정이 쉬워집니다. 이는 배치 작업, 사용자 생성 콘텐츠 워크플로우, 자동화 콘텐츠 파이프라인에 중요합니다.
모션 컨트롤 API 통합 방법
참조 입력에서 전달 애니메이션까지 3가지 실용적인 단계.
명확한 캐릭터 이미지와 모션 소스 비디오 준비
대상 캐릭터의 참조 이미지와 전송하려는 퍼포먼스가 포함된 참조 비디오를 업로드. 명확한 신체 가시성과 안정적인 소스 모션으로 출력 일관성이 향상됩니다.
모션 설정이 포함된 비동기 생성 요청 제출
이미지, 비디오, 화질 모드, 방향 매개변수를 API로 전송. 작업이 비동기로 실행되어 프로덕션 파이프라인, 큐 시스템, 자동화 워크플로우에 통합하기 쉽습니다.
작업 상태 폴링, 출력 검토 및 반복
결과가 준비될 때까지 작업 상태를 확인한 다음 생성된 클립을 검토하고 필요에 따라 입력을 개선. 이 반복 루프는 크리에이터 제품, 내부 도구, 반복 가능한 비디오 워크플로우에 적합합니다.
모션 컨트롤 API 핵심 기능
참조 기반 캐릭터 애니메이션
참조 비디오 모션 전송
소스 퍼포먼스 비디오를 사용하여 대상 캐릭터 이미지의 움직임을 구동하여, 프롬프트만 사용하는 생성보다 모션 출력을 반복 가능하고 제어하기 쉽게 만듭니다.
캐릭터 방향 제어
출력 캐릭터가 참조 이미지의 방향을 따를지 소스 비디오의 방향을 따를지 선택하여, 필요한 모션 전송 유형에 따라 조정할 수 있습니다.
주제 요소 일관성 지원
반복 생성 및 프로덕션 변형 전반에 걸쳐 더 안정적인 캐릭터 정체성이 필요한 경우 모션 컨트롤을 Kling 커스텀 요소 워크플로우와 결합합니다.
원본 사운드 보존
워크플로우가 최종 출력에서 모션과 소스 오디오 연속성을 필요로 하는 경우 참조 비디오에서 원본 사운드를 유지합니다.
명확한 출력 제한이 있는 초당 가격
초당 과금, 가시적인 기간 제약, 명확한 품질 계층으로 비용 추정이 쉬워집니다. 이를 통해 팀은 크리에이터 도구와 자동화 파이프라인 사용을 계획할 수 있습니다.
720p 및 1080p 전달 모드
프로덕션 목표, 납기 요구사항, 예산 민감도에 따라 저비용 또는 고품질 출력 경로를 선택합니다.
자주 묻는 질문
Everything you need to know about the product and billing.
API Reference
Select endpoint
Authentication
All APIs require Bearer Token authentication.
Authorization:
Bearer YOUR_API_KEY/v1/videos/generationsCreate Element
Kling Custom Element (kling-custom-element) creates reusable subjects (elements) from reference videos. Created elements can be referenced in Kling V3 Motion Control, Kling O3 series, and Kling V3 Image-to-Video video generation via element_list for consistent character appearance.
Asynchronous processing mode, use the returned task ID to query status.
Upon completion, result_data will contain the element_id for use in video generation.
Important Notes
- This model creates reusable elements (subjects), not videos. No prompt/duration/quality/aspect_ratio parameters needed.
- The reference image or video must contain a clearly visible human face.
- Fixed pricing: 1 Credit per element creation. Full refund on failure.
- Estimated processing time: approximately 10 minutes.
- After successful creation, use the returned element_id in Kling V3 Motion Control, Kling O3 series, and Kling V3 Image-to-Video video generation via element_list.
Request Parameters
modelstringRequiredDefault: kling-custom-elementModel name for custom element creation.
kling-custom-elementmodel_params.element_namestringRequiredName for the element (subject) being created.
Notes
- Max 20 characters
MyCharactermodel_params.element_descriptionstringRequiredDescription of the element, used to help the model understand the subject characteristics.
Notes
- Max 100 characters
A young male character with short hair, wearing a white T-shirtmodel_params.reference_typestringRequiredType of reference material used to create the element.
| Value | Description |
|---|---|
| video_refer | Use reference video to create element |
video_refermodel_params.element_video_listobjectOptionalReference video for element creation. Required when reference_type is video_refer.
Notes
- Conditionally required: must be provided when reference_type = video_refer
- video_url (string): URL of the reference video
- The reference video must contain a clearly visible human face
{"video_url": "https://example.com/reference.mp4"}callback_urlstringOptionalHTTPS callback address after task completion.
Notes
- Triggered on completion, failure, or cancellation
- HTTPS only, no internal IPs
- Max length: 2048 chars
- Timeout: 10s, Max 3 retries
https://your-domain.com/webhooks/element-task-completed