Sign in

v1

latestOpenAPI 3.0.32026-07-241112213.6 KB

Submit Task

Submit an async Motion Control task and receive taskId. Poll the query endpoint for final result.

Constraints:

  • Input resources are fileIds
  • Character image supports jpg/jpeg/png
  • Motion reference video supports mp4/mov
  • Both image and video are validated by FFmpeg media parsing
post/v1/common_task/motion_control/task/submit

Headers

Topview-Uidstring required

User ID

Authorizationstring required

API key, format: Bearer {apiKey}

Request body

model'Kling Motion Control Pro V3' | 'Kling Motion Control Std V3' | 'Kling Motion Control Pro' | 'Kling Motion Control Std' required

Display model name (required)

characterImageFileIdstring required

Character image fileId (required)

motionReferenceVideoFileIdstring required

Motion reference video fileId (required)

promptstring

Positive prompt (optional)

resolution720 | 1080 required

Resolution (required), must match model capability

characterOrientation'video' | 'image'

Character orientation (optional): video / image, default video

keepOriginalSoundboolean

Keep original sound from reference video (optional, default true)

boardIdstring

Board ID (optional)

noticeUrlstring

Task completion callback URL (optional)

Example request

{
  "model": "Kling Motion Control Std V3",
  "characterImageFileId": "file_image_123",
  "motionReferenceVideoFileId": "file_video_456",
  "resolution": 720,
  "characterOrientation": "video",
  "keepOriginalSound": true,
  "noticeUrl": "https://example.com/topview/callback"
}

Response

Accepted

codestring
messagestring

Example response

{
  "code": "200",
  "message": "Success",
  "result": {
    "status": "success"
  }
}