Skip to main content
POST
/
v1
/
ai
/
video
/
kling-v2-6-motion-control-pro
Kling 2.6 Pro - Motion control video
curl --request POST \
  --url https://api.freepik.com/v1/ai/video/kling-v2-6-motion-control-pro \
  --header 'Content-Type: application/json' \
  --header 'x-freepik-api-key: <api-key>' \
  --data '
{
  "image_url": "<string>",
  "video_url": "<string>",
  "webhook_url": "<string>",
  "prompt": "<string>",
  "character_orientation": "video",
  "cfg_scale": 0.5
}
'
"<unknown>"

Authorizations

​
x-freepik-api-key
string
header
required

Your Freepik API key. Required for authentication. Learn how to obtain an API key

Body

application/json
​
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
​
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.

​
prompt
string

Optional text prompt to guide the motion transfer. Cannot exceed 2500 characters.

Maximum string length: 2500
​
character_orientation
enum<string>
default:video

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.
Available options:
video,
image
​
cfg_scale
number<float>
default:0.5

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.

Required range: 0 <= x <= 1

Response

OK

OK - The task exists and the status is returned