Kling 3.0 모션 컨트롤 API

단일 API 호출로 참조 비디오의 인물 모션을 캐릭터 이미지로 전송. 720p 출력은 초당 $0.1134부터, 1080p HD 화질 지원, 최대 30초 비디오 생성, 다양한 방향 모드 지원.

Model Type:

Motion Control Custom Element

Motion transfer API

참조 비디오로 캐릭터 이미지를 애니메이션화. 방향 제어, 원본 오디오 보존, 비동기 API 전달로 프로덕션 워크플로우 요구사항 충족.

$0.1134/초부터
720p / 1080p
입력: 이미지 + 비디오
최대 10s / 30s

Reference video motion, image character guidance, and async delivery in one production-ready route.

Prompt

Estimated Cost (5s)

8.1648 Credits

Sample Result

No sample available

Prompt

0 (suggested: 2,000)

Reference Video *

Motion source video (MP4/MOV, 340-3850px per side, 3-30s, max 100MB)

Click to upload or drag and drop

Supported formats: MP4, MOV
Maximum file size: 100MB; Maximum files: 1

Reference Image *

Character image to animate (JPG/PNG, max 10MB)

Click to upload or drag and drop

Supported formats: JPG, JPEG, PNG
Maximum file size: 10MB; Maximum files: 1

Quality

Character Orientation

Character facing direction in generated video

Keep Original Sound

Keep the original audio from the reference video

Click Generate to see preview

기록

최대 20개 항목

0 실행 중 · 0 완료됨

여기에 생성 기록이 표시됩니다

Billing Rules

•Price shown is per second
•Billed by output video duration, rounded to nearest integer
•Duration depends on reference video (max 10s for image orientation, 30s for video orientation)
•Total = price/second × actual duration

Pricing

Model	Mode	Quality	Price
Kling 3.0 Motion Control	Motion Control	720p	Popular $0.1134/ second(8.1648 Credits)
Kling 3.0 Motion Control	Motion Control	1080p	$0.1512/ second(10.88368 Credits)

Popular

Kling 3.0 Motion Control

Motion Control

Quality:720p

Price:

$0.1134/ second

(8.1648 Credits)

Kling 3.0 Motion Control

Motion Control

Quality:1080p

Price:

$0.1512/ second

(10.88368 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 문서 보기

모션 컨트롤 API 핵심 기능

참조 기반 캐릭터 애니메이션

모션

참조 비디오 모션 전송

소스 퍼포먼스 비디오를 사용하여 대상 캐릭터 이미지의 움직임을 구동하여, 프롬프트만 사용하는 생성보다 모션 출력을 반복 가능하고 제어하기 쉽게 만듭니다.

방향

캐릭터 방향 제어

출력 캐릭터가 참조 이미지의 방향을 따를지 소스 비디오의 방향을 따를지 선택하여, 필요한 모션 전송 유형에 따라 조정할 수 있습니다.

일관성

주제 요소 일관성 지원

반복 생성 및 프로덕션 변형 전반에 걸쳐 더 안정적인 캐릭터 정체성이 필요한 경우 모션 컨트롤을 Kling 커스텀 요소 워크플로우와 결합합니다.

오디오

원본 사운드 보존

워크플로우가 최종 출력에서 모션과 소스 오디오 연속성을 필요로 하는 경우 참조 비디오에서 원본 사운드를 유지합니다.

가격

명확한 출력 제한이 있는 초당 가격

초당 과금, 가시적인 기간 제약, 명확한 품질 계층으로 비용 추정이 쉬워집니다. 이를 통해 팀은 크리에이터 도구와 자동화 파이프라인 사용을 계획할 수 있습니다.

품질

720p 및 1080p 전달 모드

프로덕션 목표, 납기 요구사항, 예산 민감도에 따라 저비용 또는 고품질 출력 경로를 선택합니다.

자주 묻는 질문

Everything you need to know about the product and billing.

모션 컨트롤 API는 참조 비디오에서 인물 모션을 참조 이미지의 캐릭터로 전송합니다. Kling의 3.0 모델을 사용하여 자연스러운 애니메이션을 합성합니다. 참조 이미지와 참조 비디오 모두 필수 입력입니다.

참조 이미지(애니메이션화할 캐릭터)와 참조 비디오(모션 소스)가 필요합니다. 캐릭터는 상반신 또는 전신이 명확하게 보여야 합니다. 비디오는 컷이나 카메라 움직임 없이 명확한 인물 모션을 포함해야 합니다.

최대 기간은 character_orientation에 따라 다릅니다: 'image'(캐릭터가 이미지처럼 향함)로 설정하면 최대 10초, 'video'(캐릭터가 비디오처럼 향함)로 설정하면 최대 30초. 최소는 3초. 실제 기간은 참조 비디오에서 추출 가능한 모션에 따라 달라집니다.

모션 컨트롤은 초당 과금을 사용하며 기본 요율은 초당 8.1648 크레딧(720p)입니다. 1080p 품질은 기본 요율의 1.333배입니다. 실제 생성 기간으로 과금되며 가장 가까운 초로 반올림됩니다. 그룹별 가격은 EvoLink 대시보드에서 확인하세요.

이 매개변수는 생성된 캐릭터의 방향을 제어합니다. 'image'로 설정하면 캐릭터가 참조 이미지와 같은 방향을 향합니다(최대 10초 비디오). 'video'로 설정하면 캐릭터가 참조 비디오와 같은 방향을 향합니다(최대 30초 비디오).

예, element_list를 사용하여 Kling 커스텀 요소를 통해 생성된 주제 요소를 참조할 수 있습니다. 요소를 사용할 때 캐릭터 방향은 현재 비디오 방향으로만 제한됩니다. 최대 1개의 요소가 지원됩니다.

제한 사항, 가격, 사용 가능한 모드는 공급자와 지역에 따라 결정됩니다. EvoLink 대시보드와 API 응답을 진실의 소스로 사용하세요. 최신 제약 조건과 매개변수는 API 문서를 확인하세요.

API Reference

Select endpoint

Authentication

All APIs require Bearer Token authentication.

Header

Authorization: 
Bearer YOUR_API_KEY

Get API Key

POST

/v1/videos/generations

Create Motion Control Video

Kling 3.0 Motion Control (kling-v3-motion-control) transfers human motion from a reference video onto a character in a reference image.

Asynchronous processing mode, use the returned task ID to query status.

Generated video links are valid for 24 hours, please save them promptly.

Important Notes

Both reference image and reference video are required.
Max duration: 10s (image orientation) or 30s (video orientation).
Billed by actual generated duration, rounded to nearest second.
Pricing: 720p = 1.0x base, 1080p = 1.333x base.

Request Parameters

modelstringRequiredDefault: kling-v3-motion-control

Motion control model name.

Examplekling-v3-motion-control

image_urlsstring | string[]Required

Reference image URL(s). The character in this image will be animated with the motion from the reference video.

Notes

Formats: JPG, JPEG, PNG
Max size: 10MB
Dimensions: 300px-65536px per side
Aspect ratio: 1:2.5 to 2.5:1
Character should show clear upper body or full body
Avoid extreme orientations (e.g., upside down, lying flat)

Examplehttps://example.com/character.png

video_urlsstring | string[]Required

Reference video URL(s). The motion in this video will be transferred to the character in the reference image.

Notes

Formats: MP4, MOV
Max size: 100MB
Dimensions: 340px-3850px per side
Duration: 3s minimum
Max 10s (image orientation) or 30s (video orientation)
Recommend single-person video with clear, steady motion
Avoid camera cuts, fast motion, or scene transitions

Examplehttps://example.com/dance.mp4

promptstringOptional

Optional text prompt to add elements or camera effects to the generated video.

Notes

Max 2500 characters
Can describe clothing, scene additions, or camera movements

ExampleA girl wearing a gray loose T-shirt and denim shorts

qualitystringRequired

Video output quality. Affects billing multiplier.

Value	Description
720p	Standard quality (1.0x base price)
1080p	High quality (1.333x base price)

Example720p

model_params.character_orientationstringRequired

Controls the facing direction of the generated character.

Value	Description
image	Character faces same as reference image (max 10s)
video	Character faces same as reference video (max 30s)

Notes

When using element_list, only 'video' orientation is supported

Exampleimage

model_params.keep_soundbooleanOptionalDefault: true

Whether to keep the original audio from the reference video.

Notes

true = keep original sound, false = mute

Exampletrue

model_params.element_listarrayOptional

Subject element references for consistent character appearance.

Notes

Format: [{element_id: string}]
Max 1 element
Only video-created elements supported (reference_type=video_refer)
When used, character_orientation must be 'video'

Example[{"element_id": "12345"}]

model_params.watermark_infoobjectOptional

Watermark configuration for the generated video.

Notes

Format: {enabled: boolean}

Example{"enabled": false}

callback_urlstringOptional

HTTPS 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

Examplehttps://your-domain.com/webhooks/video-task-completed

Request Example

{
  "model": "kling-v3-motion-control",
  "prompt": "A girl wearing a gray loose T-shirt and denim shorts",
  "image_urls": ["https://example.com/character.png"],
  "video_urls": ["https://example.com/dance.mp4"],
  "quality": "720p",
  "model_params": {
    "character_orientation": "image",
    "keep_sound": true
  }
}

1080p with Element Example

{
  "model": "kling-v3-motion-control",
  "image_urls": ["https://example.com/character.png"],
  "video_urls": ["https://example.com/dance.mp4"],
  "quality": "1080p",
  "model_params": {
    "character_orientation": "video",
    "keep_sound": false,
    "element_list": [
      {"element_id": "12345"}
    ]
  }
}

Response Example

{
  "created": 1757169743,
  "id": "task-unified-1757169743-v3mc",
  "model": "kling-v3-motion-control",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 180
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 40.824,
    "user_group": "default"
  }
}