Kling-3.0 motion-control
POST
/api/v1/jobs/createTask
File Upload Requirements
Upload Reference Image
Use the File Upload API to upload your reference image showing the subject.Requirements: File Type: JPEG, PNG, or JPG format Max File Size: 10MB per file, size needs to be greater than 340px, aspect ratio 2:5 to 5:2. Content: Clear image showing the subject's head, shoulders, and torso
Upload Motion Video
Upload a video that defines the motion pattern you want to apply.Requirements: File Type: MP4, or QuickTime format Duration: Between 3-30 seconds per video Max File Size: 100MB per file, size needs to be greater than 340px, aspect ratio 2:5 to 5:2. Content: Video clearly showing the subject's head, shoulders, and torso
Get File URLs
After upload, you'll receive file URLs that you can use in the
input_urls and video_urls parameters.Query Task Status
callBackUrl parameter to receive automatic notifications when generation completes, rather than polling the status endpoint.Related Resources
Callbacks
Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.kie.ai/api/v1/jobs/createTask' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-3.0/motion-control",
"callBackUrl": "https://your-domain.com/api/callback",
"input": {
"prompt": "The cartoon character is dancing.",
"input_urls": [
"https://static.aiquickdraw.com/tools/example/1767694885407_pObJoMcy.png"
],
"video_urls": [
"https://static.aiquickdraw.com/tools/example/1767525918769_QyvTNib2.mp4"
],
"mode": "720p",
"character_orientation": "image",
"background_source": "input_video"
}
}'Response Response Example
200 - Example 1
{
"code": 200,
"msg": "success",
"data": {
"taskId": "task_kling-3.0_1734696787838"
}
}