Skip to main content

​
Identifier

Use the model identifier kling-motion-control in the model field when calling /asset/start.

​
Capabilities

PropertyValue
Reference inputs2
Input typesimage + video
Audioyes
Max prompt length2500 chars
Tagsmotion-control

​
Inputs

This model takes named media inputs. Pass each one as a top-level field in the request body (not inside references). Each field accepts exactly one of url, asset_id, or avatar_id.
FieldTypeRequiredDescription
start_imageimageyesSubject image. The model transfers the motion from the reference video onto this image.
motion_videovideoyesReference video whose motion pattern is applied to the start image.
  • url — a direct, publicly accessible file URL
  • asset_id — the ID of an existing asset in your Hoox space (e.g. a previous generation)
  • avatar_id — the ID of an avatar defined in your Hoox space

​
Custom settings

These keys go inside the model_settings object of the request body.
KeyTypeDefaultAffects cost
keepOriginalSoundbooleantrueno

​
Pricing

Default parameters: ~9 credits / generation. For exact pricing with your own parameters, call /asset/pricing with the model and any parameters that affect cost.

​
Example request

{
  "type": "video",
  "model": "kling-motion-control",
  "prompt": "Describe what you want to generate",
  "start_image": {
    "url": "https://example.com/reference.jpg"
  },
  "motion_video": {
    "url": "https://example.com/reference.mp4"
  }
}
See /asset/start for the full request/response reference, error codes, and code samples in cURL / Python / JavaScript.