Motion Control
Drive the figure in a "character reference image" with a "motion reference video", producing a video whose motion matches the reference; kling-video-motion-control-v3.0 can also target a custom character via an element (Element). This endpoint has no duration parameter — the output length follows the motion reference video.
Endpoints
- Submit:
POST /kling/v1/videos/text2video(shared with text-to-video; the gateway routes to the upstream motion-control endpoint by model) - Query:
GET /kling/v1/videos/text2video/{task_id}, see Query & Download
Models: kling-video-motion-control-v3.0, kling-video-motion-control-v2.6.
Request Body
metadata.contents items:
The motion video's duration cap depends on character_orientation: image — up to 10 seconds; video — up to 30 seconds. With fast or complex motion the output may be shorter than the uploaded video (the model extracts valid motion only; at least 3 contiguous seconds are needed); billing follows the output length.
Request Example
Character image: keep the figure's proportions close to the person in the motion video (avoid driving a half-body figure with full-body motion); the figure needs a clear upper body / full body and head, unobstructed, avoiding extreme poses; real or stylized characters are supported. Motion video: prefer a single-person action (with multiple people the largest figure is used), real-human motion, one continuous shot with the character always in frame — cuts and camera moves cause truncation. Asset URLs must be publicly downloadable direct links.
Response Body
A successful submission returns the Kling-format task object (same as the Submit Task response); use data.task_id for polling. The query lifecycle, task_result.videos structure, and billing mirror (final_unit_deduction) are identical to text / image-to-video — see Query & Download.
Response Example
Verified behavior (v3.0, 720p + audio:"original", output in ~3 minutes): the output resolution follows the 720p tier (1264×720, framing follows the source assets), the duration follows the motion video (5.08s → 5.03s), and final_unit_deduction was 450000. The output is an upstream signed link that expires in about 45 minutes — download promptly. When the reference video itself is silent, audio:"original" output is silent too. Model names and prices follow the model marketplace; billing settles on actual usage when the task completes (failed tasks are refunded).
