v1

latestOpenAPI 3.1.02026-07-267724480.0 KB

Generate a Kling image from multiple images

post/kling/v1/images/multi-image2image

Headers

Content-Typestring

Must be application/json.

Request body

model_name'kling-v2' | 'kling-v2-1'

Model to use for multi-image generation. Use kling-v2-1 for new requests; omitting the field uses the legacy route default.

promptstring

Text prompt describing the desired output. Maximum 2500 characters.

negative_promptstring

Elements to exclude from the image. Maximum 2500 characters.

scene_imagestring

Optional scene reference image. Image URL or raw Base64 string without a data: prefix. Supported formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.

style_imagestring

Optional style reference image. Image URL or raw Base64 string without a data: prefix. Supported formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.

ninteger

Number of images to generate. Range: 1-9.

aspect_ratio'16:9' | '9:16' | '1:1' | '4:3' | '3:4' | '3:2' | '2:3' | '21:9'

Aspect ratio of the generated image.

callback_urlstring

Webhook URL for task status notifications.

external_task_idstring

Optional user-defined task ID for your own tracking. Must be unique per account.

Response

Task request accepted or an error response returned by the API.

messagestring required

Response message.

request_idstring

Request identifier returned when present.