---
title: "Create a Kling virtual try-on"
method: POST
path: "/kling/v1/images/kolors-virtual-try-on"
---

# Create a Kling virtual try-on

`POST /kling/v1/images/kolors-virtual-try-on`

## Headers

- `Content-Type` string

## Request body

- object
  - `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_image` string, 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_image` string, 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_url` string — Webhook URL for task status notifications.
  - `external_task_id` string — Optional user-defined task ID for your own tracking. Must be unique per account.

## Response `200`

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

- object
  - `code` union, required — Response code. `0` means the task request was accepted.
    - integer
    - string
  - `message` string, required — Response message.
  - `request_id` string — Request identifier returned when present.
  - `data` object, required
    - `task_id` string, required — System-generated task ID.
    - `task_status` 'submitted' | 'processing' | 'succeed' | 'failed', required — Task status.
    - `task_status_msg` string, nullable — Task status detail when present.
    - `task_info` object
      - `external_task_id` string, nullable — Caller-provided external task ID when supplied.
    - `task_result` object, nullable — Task result payload after the task completes.
    - `created_at` integer, required — Task creation time as a Unix timestamp in milliseconds.
    - `updated_at` integer, required — Task update time as a Unix timestamp in milliseconds.

---

[API](https://skmtc.net/cometapi/apis/create-api-key.md) · [All operations](https://skmtc.net/cometapi/apis/create-api-key/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cometapi/create-api-key/versions/0863102dbf34/schema)