About Kling 3.0 Pro: Motion Control
Transfer movements from a reference video to any character image. Cost-effective mode for motion transfer, perfect for portraits and simple animations.
Ready to build with Kling 3.0 Pro: Motion Control?
Try Kling 3.0 Pro: Motion Control in the Workbench to prompt it, compare outputs, and iterate on prompts without writing any code. When you're ready to ship, call the same model from our API and build your own apps on top of it.
curl -sSf -X POST https://hub.oxen.ai/api/ai/videos/generate \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $OXEN_API_KEY" \
-d '{
"model": "kling-video-v3-pro-motion-control",
"prompt": "A cat sitting on a chair",
"input_image": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/ox_zoom_out_1926_1076.png",
"input_video": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/videos/waterfall.mp4",
"character_orientation": "video",
"keep_original_sound": true
}'Request parameters
Every field Kling 3.0 Pro: Motion Control accepts in the request body. See the API reference for response formats.
POST
https://hub.oxen.ai/api/ai/videos/generate| Field | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | Yes | — | Text prompt for the scene or character. |
input_image | stringuri | Yes | — | Reference image URL. The characters, backgrounds, and other elements in the generated video are based on this reference image. Characters should have clear body proportions, avoid occlusion, and occupy more than 5% of the image area. |
input_video | stringuri | Yes | — | Reference video URL (mp4, mov). The character actions in the generated video will be consistent with this reference video. Should contain a realistic style character with entire body or upper body visible, including head, without obstruction. Minimum 3s. Max depends on character_orientation: 10s for 'image', 30s for 'video'. |
character_orientation | string | Yes | "video" | Controls whether the output character's orientation matches the reference image or video. 'video': orientation matches reference video - better for complex motions (max 30s). 'image': orientation matches reference image - better for following camera movements (max 10s).imagevideo |
elements | array<object>nullable | No | — | Optional element for facial consistency binding. Upload a facial element to enhance identity preservation in the generated video. Only 1 element is supported. Reference in prompt as @Element1. Element binding is only supported when character_orientation is 'video'. |
keep_original_sound | boolean | No | true | Whether to keep the original sound from the reference video. |