virtual try-on - API Doc-CometAPI

Request

Header Params

Authorization

string

required

Example:

Bearer {{api-key}}

Body Params application/json

model_name

enum<string>

optional

Default value: kolors-virtual-try-on-v1

Allowed values:

kolors-virtual-try-on-v1kolors-virtual-try-on-v1-5

Default:

kling-v1

human_image

string

required

Uploaded character images. Support Base64 encoding or URL, format support .jpg/.jpeg/.png, size not more than 10MB, resolution not smaller than 300*300px

cloth_image

string

required

Virtual try-on pictures
● Support uploading clothing product images or clothing white background images, support for tops upper, bottoms lower, and one-piece dresses.
● Support passing in image Base64 encoding or image URL (to ensure accessibility).
● Image format support .jpg / .jpeg / .png
● The image file size should not exceed 10MB, and the image resolution should not be less than 300*300px.
● The kolors-virtual-try-on-v1-5 model supports not only the input of individual garments, but also the input of a combination of garments in the form of “top+bottom”, namely:
○ Input single garment image (top or bottom or one-piece) -> Generate single garment image to try on.
○ Input a combination of apparel images (you can stitch multiple single-item apparel white background images into the same image).
■ Model detects “Top + Bottom” -> Generate “Top + Bottom” image for fitting
■ Model detection is “Top + Top” -> Generation failed
Model detected as “Bottoms + Bottoms” -> Generate failed
■ Model detected as “One-piece + One-piece” -> Generate failed
Model detected as “Top + One-piece” -> Generate failed
■ Model detects “Bottom + One-piece” -> Generate failed

callback_url

string

optional

Address for callback notification of the results of this task, optional

Example

{
  "model_name": "kolors-virtual-try-on-v1-5",
  "human_image": "https://assets.christiandior.com/is/image/diorprod/LOOK_F_25_1_LOOK_095_E04?$lookDefault_GH-GHC$&crop=568,0,1864,2000&bfc=on&qlt=85",
  "cloth_image": "https://assets.christiandior.com/is/image/diorprod/511R59A1166X3389_E01?$default_GHC$&crop=501,147,998,1572&bfc=on&qlt=85"
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.cometapi.com/kling/v1/images/kolors-virtual-try-on' \
--header 'Authorization: Bearer {{api-key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model_name": "kolors-virtual-try-on-v1-5",
    "human_image": "https://assets.christiandior.com/is/image/diorprod/LOOK_F_25_1_LOOK_095_E04?$lookDefault_GH-GHC$&crop=568,0,1864,2000&bfc=on&qlt=85",
    "cloth_image": "https://assets.christiandior.com/is/image/diorprod/511R59A1166X3389_E01?$default_GHC$&crop=501,147,998,1572&bfc=on&qlt=85"
}'

Responses

🟢200Successful Response

application/json

Body

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

Example

{
	"code": 0,
  "message": "string",
  "request_id": "string", 
  "data":{
  	"task_id": "string", 
    "task_status": "string", 
    "task_status_msg": "string", 
    "created_at": 1722769557708, 
    "updated_at": 1722769557708, 
    "task_result":{
    	"images":[
        {
        	"index": int, 
          "url": "string"
        }
      ]
    }
  }
}