Transfer motion from a reference video onto a character in a reference image. This model supports two modes: Advanced Customization (default) and Scene Consistency.
Model
kuaishou/kling-2.6-motion-control
Modes
Scene Control OFF (Advanced Customization) — Default
When scene_control is false (or omitted), you have full control over the output with prompts, character orientation, and seed values. Use this mode when you want to customize the generated scene with text descriptions.
Scene Control ON (Scene Consistency)
When scene_control is true, the model preserves the background from either the input video or input image. Use this mode when you need consistent backgrounds and scene elements.
Parameters
Common Parameters
| Parameter | Type | Required | Description |
|---|
video_url | string | Yes | Reference video URL (3-30 seconds) |
image_url | string | Yes | Reference image URL (head, shoulders, torso must be visible) |
resolution | string | No | 720p or 1080p |
scene_control | boolean | No | Enable scene consistency mode. Default: false |
Scene Control OFF Parameters
| Parameter | Type | Required | Description |
|---|
prompt | string | Yes | Text description of the scene |
character_orientation | string | Yes | video or image (see below) |
seed | integer | No | Seed for reproducibility |
When scene_control is false, you cannot use background_source.
Scene Control ON Parameters
| Parameter | Type | Required | Description |
|---|
background_source | string | Yes | input_video or input_image — determines which input provides the background |
When scene_control is true, you cannot use prompt, character_orientation, or seed.
Character Orientation
Only applicable when scene_control is false.
| Value | Description | Max Output |
|---|
video | Matches reference video orientation. Best for complex motions. | 30 seconds |
image | Matches reference image orientation. Best for camera movements. | 10 seconds |
Choosing a Mode
| Use Case | Recommended Mode |
|---|
| Custom scene descriptions with prompts | Scene Control OFF |
| Precise control over character orientation | Scene Control OFF |
| Reproducible outputs with seed | Scene Control OFF |
| Preserve background from input video | Scene Control ON with background_source: "input_video" |
| Preserve background from input image | Scene Control ON with background_source: "input_image" |
Image Requirements
The reference image must show the subject’s head, shoulders, and torso clearly visible.
Example Requests
Scene Control OFF (Advanced Customization)
curl -X POST https://api.unifically.com/v1/tasks \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "kuaishou/kling-2.6-motion-control",
"input": {
"prompt": "Person dancing gracefully",
"video_url": "https://example.com/dance-motion.mp4",
"image_url": "https://example.com/person.jpg",
"character_orientation": "video",
"resolution": "1080p",
"seed": 445501
}
}'
Scene Control ON (Scene Consistency)
curl -X POST https://api.unifically.com/v1/tasks \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "kuaishou/kling-2.6-motion-control",
"input": {
"scene_control": true,
"video_url": "https://example.com/dance-motion.mp4",
"image_url": "https://example.com/person.jpg",
"background_source": "input_video",
"resolution": "720p"
}
}'
Response
{
"code": 200,
"success": true,
"data": {
"task_id": "abc123def456",
"status": "pending"
}
}
Pricing
| Resolution | Price |
|---|
| 720p | $0.01/s |
| 1080p | $0.0225/s |
