---
title: "Virtual Try-On"
method: POST
path: "/kling/v1/images/kolors-virtual-try-on"
---

# Virtual Try-On

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

## Request body

- object
  - `callback_url` string — Webhook URL for task status notifications.
  - `model_name` 'kolors-virtual-try-on-v1' | 'kolors-virtual-try-on-v1-5' — Virtual try-on model version.
  - `human_image` string, required — Person image to dress. Accepts an image URL or raw Base64 string (no `data:` prefix). Formats: JPG, JPEG, PNG. Max 10 MB, minimum 300×300 px.
  - `cloth_image` string, required — Clothing image for the try-on. Accepts an image URL or raw Base64 string (no `data:` prefix). Formats: JPG, JPEG, PNG. Max 10 MB, minimum 300×300 px. Supports tops, bottoms, and one-piece dresses. The v1-5 model also accepts a combined top+bottom image stitched together.

## Response `200`

Successful Response

- object
  - `code` integer, required — Error code; specifically define the error code
  - `message` string, required — error message
  - `request_id` string, required — Request ID, system-generated, for tracking requests, troubleshooting issues
  - `data` object, required
    - `task_id` string, required — Task ID, system generated
    - `task_status` string, required — Task status, enumerated values: submitted, processing, succeed, failed.
    - `task_status_msg` string, required
    - `created_at` integer, required — Task creation time, Unix timestamp, in ms.
    - `updated_at` integer, required — Task update time, Unix timestamp, in ms.
    - `task_result` object, required
      - `images` object[], required
        - `url` string

---

[API](https://skmtc.net/deerapi/apis/text-to-audio-api.md) · [All operations](https://skmtc.net/deerapi/apis/text-to-audio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deerapi/text-to-audio-api/revisions/b6265ced74a1/schema)