v1

latestOpenAPI 3.1.02026-07-267724480.0 KB

Create a Kling virtual try-on

post/kling/v1/images/kolors-virtual-try-on

Headers

Content-Typestring

Must be application/json.

Request body

model_name'kolors-virtual-try-on-v1' | 'kolors-virtual-try-on-v1-5'

Virtual try-on model version. Defaults to kolors-virtual-try-on-v1.

human_imagestring required

Person image to dress. 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.

cloth_imagestring required

Clothing image for the try-on. 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. Supports tops, bottoms, and one-piece dresses.

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.