Skip to main content
POST
Motion control with Kling 3.0 Motion Control Standard

Authorizations

Authorization
string
header
required

API key as a bearer token: Authorization: Bearer bpx_live_xxx

Body

application/json
image
string
required

Character image to animate. A public image URL, a data URI, raw base64, or an uploaded-file URL from POST /v1/uploads. jpg/png/webp.

video
string
required

Motion reference video whose movement drives the character. A public video URL or an uploaded-file URL from POST /v1/uploads. mp4/webm, 3-30 seconds (max 10 seconds when character_orientation is "image"), up to 30 MB.

character_orientation
enum<string>
default:video

Take the character's orientation from the reference video or from the image. With "image", the reference video must be 10 seconds or less.

Available options:
video,
image
keep_original_sound
boolean
default:true

Keep the original audio from the reference video.

prompt
string
default:Replace the characters in the video with the characters from the image, while strictly maintaining the characters' movements.

How the character should be animated.

Response

Job accepted.

credits
integer

Total price of this job (seconds x the model's per-second rate).

id
string

Opaque job id (mtn_...) — use it to poll status.

message
string
model
string
seconds
integer

Billed duration — the reference video's length

status
enum<string>

Lifecycle state. succeeded/failed/timeout are terminal.

Available options:
pending,
starting,
processing,
completing,
succeeded,
failed,
timeout