Skip to main content
POST
/
v3
/
async
/
kling-v3.0-motion-control
Kling V3.0 Motion Control
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/kling-v3.0-motion-control \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "image": "<string>",
  "video": "<string>",
  "prompt": "<string>",
  "model_name": "<string>",
  "negative_prompt": "<string>",
  "keep_original_sound": true,
  "character_orientation": "<string>"
}
'
{
  "task_id": "<string>"
}
The Kling V3.0 Motion Control tool can extract motion trajectories from a reference video and apply them to a reference image to generate a video while preserving subject consistency. It supports Standard and Pro modes, with billing by the second.
This is an asynchronous API and only returns the task_id of the asynchronous task. You should use this task_id to request the Get Task Result API to retrieve the generated result.

​
Request Headers

​
Content-Type
string
required
Enum value: application/json
​
Authorization
string
required
Bearer authentication format: Bearer {{API key}}.

​
Request Body

​
image
string
required
Reference image URL or base64-encoded image; supports .jpg, .jpeg, .png. The image file size must not exceed 10MB; both width and height must be >= 300px; the aspect ratio must be between 1:2.5 and 2.5:1.
​
video
string
required
Reference motion video URL; supports .mp4, .mov. The video file size must not exceed 10MB; both width and height must be >= 300px; duration must be 3-30 seconds.
​
prompt
string
Positive prompt describing the scene, style, lighting, etc.; length must not exceed 2500 characters.Length limit: 0 - 2500
​
model_name
string
default:"kling-v3-0-std"
required
Model name. kling-v3-0-std: Standard mode, cost-effective; kling-v3-0-pro: Pro mode, better video quality.Available values: kling-v3-0-std, kling-v3-0-pro
​
negative_prompt
string
Negative prompt describing elements to avoid in the generated video; length must not exceed 2500 characters.Length limit: 0 - 2500
​
keep_original_sound
boolean
default:true
Whether to keep the original audio from the reference video.
​
character_orientation
string
required
Output frame mode:
  • image: Prioritizes the character pose and composition of the reference image, transferring the motion to the character in the image (outputs 5 seconds)
  • video: Prioritizes the character pose and composition of the reference video, applying the motion in the video to the character in the image (output duration matches the reference video, up to 30 seconds)
Available values: image, video

​
Response Information

​
task_id
string
required
Use task_id to request the Get Task Result API to retrieve the generated output.