Ana içeriğe atla
POST
/
kling
/
v1
/
images
/
kolors-virtual-try-on
Virtual Try-On
curl --request POST \
  --url https://api.cometapi.com/kling/v1/images/kolors-virtual-try-on \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "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"
}
'
{
  "code": 123,
  "message": "<string>",
  "request_id": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "task_status_msg": "<string>",
    "created_at": 123,
    "updated_at": 123,
    "task_result": {
      "images": [
        {
          "url": "<string>"
        }
      ]
    }
  }
}
Bu endpoint’i, bir kişi görseli ve bir giysi görselinden sanal try-on görseli oluşturmak için kullanın.

Çağırmadan önce

  • Bir human_image ve bir cloth_image sağlayın
  • kolors-virtual-try-on-v1 veya kolors-virtual-try-on-v1-5 ile başlayın
  • İlk test için temiz kıyafet ürün çekimleri veya beyaz arka planlı giysi görselleri kullanın

Görev akışı

1

Try-on görevini gönderin

Kişi görselini ve kıyafet görselini gönderin, ardından döndürülen görev kimliğini kaydedin.
2

Görevi sorgulayın

Görev son duruma ulaşana ve işlenmiş görseli döndürene kadar Bireysel Sorgular ile devam edin.
3

Sonucu kalıcı olarak saklayın

Try-on sonucunun daha uzun süre saklanması gerekiyorsa tamamlanan görseli kendi depolamanıza kaydedin.
Tam parametre referansı için resmî Kling dokümantasyonuna bakın.

Yetkilendirmeler

Authorization
string
header
gerekli

Bearer token authentication. Use your CometAPI key.

Gövde

application/json
human_image
string
varsayılan:example
gerekli

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
varsayılan:example
gerekli

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.

callback_url
string

Webhook URL for task status notifications.

model_name
enum<string>
varsayılan:kolors-virtual-try-on-v1

Virtual try-on model version.

Mevcut seçenekler:
kolors-virtual-try-on-v1,
kolors-virtual-try-on-v1-5

Yanıt

200 - application/json

Successful Response

code
integer
gerekli

Error code; specifically define the error code

message
string
gerekli

error message

request_id
string
gerekli

Request ID, system-generated, for tracking requests, troubleshooting issues

data
object
gerekli