Skip to main content

​
Identifier

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

​
Capabilities

PropertyValue
Reference inputs0–2
Input typesimage + image
Aspect ratios16:9, 9:16, 1:1 (default 9:16)
Durations (seconds)5, 10 (default 5)
Audioyes
Max prompt length2500 chars

​
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_imageimagenoFirst frame of the video. Omit for pure text-to-video.
end_imageimagenoLast frame of the video. Requires start_image — generates a transition from the start frame to this one. Audio generation is disabled automatically when an end frame is used.
  • 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
generateAudiobooleantrueyes

​
Pricing

Default parameters (5s): ~7.5 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-pro",
  "prompt": "Describe what you want to generate",
  "start_image": {
    "url": "https://example.com/reference.jpg"
  },
  "end_image": {
    "url": "https://example.com/reference.jpg"
  },
  "aspect_ratio": "9:16",
  "duration": 5
}
See /asset/start for the full request/response reference, error codes, and code samples in cURL / Python / JavaScript.