Skip to main content
POST
Animate an image
Use a completed image as the first frame and describe motion in prompt. The defaults are model: "kling-2.5" and a five-second duration. Kling 3 models support clips of 3–15 seconds, saved-asset subjects, audio, and multi-shot options. With multi_prompt, omit the top-level prompt and duration; shot durations must total at most 15 seconds. Optional start and end frames must meet the video input requirements. The result has type: "video" and cannot be passed to an image-only operation. A successful request returns HTTP 202 with a jobs array. Save each id, then get the job until it finishes. Read the completed media from result.url and its reusable ID from result.id. Use an Idempotency-Key when submitting work that may be retried.

Authorizations

Authorization
string
header
required

Create an API key in Studio → account menu → API Keys. Keep it on your server.

Headers

Idempotency-Key
string

Use a unique key for each intended creation. Retry the same method, path and JSON with the same key to replay its response for 24 hours after completion. Conflicting requests and unfinished or uncertain outcomes return 409. An uncertain receipt is never automatically rerun.

Required string length: 1 - 128
Pattern: ^[!-~]+$

Path Parameters

id
string<uuid>
required

Source resource ID.

Body

application/json
model
enum<string>
default:kling-2.5

Video model. Defaults to kling-2.5 when omitted. All successful submissions return jobs.

Available options:
kling-2.5
Example:

"kling-2.5"

duration
enum<integer>
default:5

Single-shot length in seconds: 5 for kling-2.5; 3–15 for Kling 3. Omit when using multi_prompt.

Available options:
5
Required range: 3 <= x <= 15
Example:

5

generate_audio
enum<boolean>
default:false

Generate audio with Kling 3. Must be false or omitted for kling-2.5.

Available options:
false
prompt
string

Scene and motion direction. Omit when using multi_prompt.

multi_prompt
object[]

Kling 3 shots. Omit prompt and duration when using this array. Each shot requires 3–15 seconds; their total must not exceed 15 seconds. End frames require a single shot.

Required array length: 1 - 5 elements
elements
object[]

Kling 3 subject references. Each asset must be an accessible model or outfit with an HTTP(S) display_image. Model assets are ordered before outfit assets in provider element numbering.

aspect_ratio
enum<string>

Video output ratio.

Available options:
16:9,
9:16,
1:1
avatar_text
string

Additional subject directions for Kling 3 only.

outfit_text
string

Additional subject directions for Kling 3 only.

last_frame_id
string<uuid>

Optional end frame. Its dimensions must match the start frame. Mutually exclusive with last_frame_url.

last_frame_url
string<uri>

Direct end-frame URL. The same media constraints apply.

Response

Accepted; poll each job.

jobs
object[]
required
Minimum array length: 1