Kling Virtual Try-On

Channel type: Kling Extended (66) Gateway path: POST https://maasunion.com/kling/v1/extended/images/kolors-virtual-try-on · GET .../kolors-virtual-try-on/{task_id} Official upstream: https://api-beijing.klingai.com (/v1/images/kolors-virtual-try-on)

Overview

The virtual try-on capability is based on a person image and a clothing image, generating an image of the person wearing the specified clothing.

Supported Models

model_name	Description
`kolors-virtual-try-on-v1-5`	Virtual try-on v1.5

Authentication

Header	Required	Description
`Authorization`	Yes	`Bearer {your_api_token}`
`Content-Type`	Required for POST	`application/json`

Create Task

POST https://maasunion.com/kling/v1/extended/images/kolors-virtual-try-on

Request Parameters

Parameter	Type	Required	Description
`model_name`	string	Yes	Model name: `kolors-virtual-try-on-v1-5`
`human_image`	string	Yes	Person image URL
`cloth_image`	string	Yes	Clothing image URL
`callback_url`	string	No	Callback URL
`external_task_id`	string	No	Custom task ID

Request Example

curl --request POST \
  --url "https://maasunion.com/kling/v1/extended/images/kolors-virtual-try-on" \
  --header "Authorization: Bearer {your_api_token}" \
  --header "Content-Type: application/json" \
  --data '{
    "model_name": "kolors-virtual-try-on-v1-5",
    "human_image": "https://example.com/person.jpg",
    "cloth_image": "https://example.com/cloth.jpg"
  }'

Create Response

{
  "code": 0,
  "message": "string",
  "request_id": "string",
  "data": {
    "task_id": "gateway_public_task_id",
    "task_status": "submitted",
    "created_at": 1722769557708,
    "updated_at": 1722769557708
  }
}

Query Task

GET https://maasunion.com/kling/v1/extended/images/kolors-virtual-try-on/{task_id}

curl --request GET \
  --url "https://maasunion.com/kling/v1/extended/images/kolors-virtual-try-on/{task_id}" \
  --header "Authorization: Bearer {your_api_token}"

The query response returns the try-on result image in task_result.images, with the same structure as the standard image.

Task Status

`task_status`	Meaning
`submitted`	Submitted
`processing`	Processing
`succeed`	Succeeded
`failed`	Failed

For more general information, see Kling Gateway Overview.