Motion Control

POST

/kling/v1/videos/motion-control

Create a motion-control video task based on a reference image and a reference video.

Authorizations

bearer

Type

HTTP (bearer)

Request Body

application/json

object

Default: kling-v2-6, kling-v3

Text prompt (can include positive and negative descriptions).
You can use prompts to add elements to the scene, control camera moves, etc. See the Kling Motion Control guide:
https://docs.qingque.cn/d/home/eZQAl5y8xNSkr0iYUS8-bpGvP?identityId=2Cn18n4EIHT#section=h.xtmfpd68o18
Must not exceed 2500 characters.

Reference image (Base64 or accessible image URL) to constrain the character/background elements.
Supported: .jpg / .jpeg / .png; size up to 10MB.
Min width/height: 300px; aspect ratio: 1:2.5 ~ 2.5:1.

Reference video (accessible URL).
Supported: .mp4 / .mov; size up to 100MB.
Both side lengths must be within 340px~3850px.
Duration must be at least 3 seconds; max duration depends on character_orientation.

Whether to keep the original audio from the reference video.
Enum: yes, no.

Which source to follow for the character's facing direction in the generated video.
Enum: image, video.

• image: follow the image (reference video duration must not exceed 10s)
• video: follow the video (reference video duration must not exceed 30s)

Video generation mode.
Enum: std, pro.

• std: Standard mode (cost-effective)
• pro: Pro mode (higher quality)

object[]

Subject reference list

object[]

Whether to also generate a watermarked result