---
title: "Kling 2.6 Pro - Motion control video"
method: POST
path: "/v1/ai/video/kling-v2-6-motion-control-pro"
tags: ["video", "kling-v2-6-motion-control-pro", "background_tasks"]
---

# Kling 2.6 Pro - Motion control video

`POST /v1/ai/video/kling-v2-6-motion-control-pro`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/ai/video/kling-v2-6-motion-control-pro`
- Auth: API key in header `x-magnific-api-key`

Transfer motion from a reference video to a character image using Kling 2.6 Pro. The model preserves the character's appearance while applying motion patterns from the reference video.

## Request body

- MotionControlRequest
  - `webhook_url` string, uri: Webhook URL to notify you when the task completes. When provided, the server will send a POST request to this URL with the task result.
  - `image_url` string, uri, required: URL of the character/reference image. The motion from the reference video will be transferred to this character. **Requirements:** - Must be a publicly accessible URL - Minimum resolution: 300x300 pixels - Maximum file size: 10MB - Supported formats: JPG, JPEG, PNG, WEBP
  - `video_url` string, uri, required: URL of the reference video containing the motion to transfer. **Requirements:** - Must be a publicly accessible URL - Duration: 3-30 seconds - Supported formats: MP4, MOV, WEBM, M4V
  - `prompt` string: Optional text prompt to guide the motion transfer. Cannot exceed 2500 characters.
  - `character_orientation` 'video' | 'image': How the model interprets spatial information and constrains output duration. - **video**: Orientation matches reference video. Better for complex motions. Maximum output duration: 30 seconds. - **image**: Orientation matches reference image. Better for following camera movements. Maximum output duration: 10 seconds.
  - `cfg_scale` number, float: The CFG (Classifier Free Guidance) scale controls how closely the model follows the prompt. Higher values mean stronger adherence to the prompt but less flexibility.

## Response `200`

OK

- unknown

## Other responses

- `400`: Bad Request - The server could not understand the request due to invalid syntax.
- `401`: Unauthorized - The client must authenticate itself to get the requested response.
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.

---

[API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)
