التجربة الافتراضية للملابس

POST

kling

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>"
        }
      ]
    }
  }
}

استخدم نقطة النهاية هذه لإنشاء صورة تجربة افتراضية للملابس من صورة شخص واحدة وصورة قطعة ملابس واحدة.

قبل استدعائها

وفّر human_image واحدًا وcloth_image واحدًا
ابدأ بـ kolors-virtual-try-on-v1 أو kolors-virtual-try-on-v1-5
استخدم صورًا واضحة لمنتجات الملابس أو صورًا لقطع الملابس بخلفية بيضاء في الاختبار الأول

تدفق المهمة

إرسال مهمة التجربة الافتراضية

أرسل صورة الشخص وصورة الملابس، ثم احفظ معرّف المهمة الذي يتم إرجاعه.

الاستعلام عن المهمة

تابع باستخدام الاستعلامات الفردية حتى تصل المهمة إلى حالة نهائية وتُرجِع الصورة الناتجة.

الاحتفاظ بالنتيجة

احفظ الصورة النهائية في مساحة التخزين الخاصة بك إذا كانت نتيجة التجربة الافتراضية تحتاج إلى الاحتفاظ بها لمدة أطول.

للاطلاع على المرجع الكامل للمعلمات، راجع وثائق Kling الرسمية.

التفويضات

Authorization

string

header

مطلوب

Bearer token authentication. Use your CometAPI key.

الجسم

application/json

human_image

string

افتراضي:example

مطلوب

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

افتراضي:example

مطلوب

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>

افتراضي:kolors-virtual-try-on-v1

Virtual try-on model version.

الخيارات المتاحة:

kolors-virtual-try-on-v1,

kolors-virtual-try-on-v1-5

الاستجابة

200 - application/json

Successful Response

code

integer

مطلوب

Error code; specifically define the error code

message

string

مطلوب

error message

request_id

string

مطلوب

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

data

object

مطلوب

Show child attributes

التعرّف على الصور

الاستعلامات الفردية

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>"
        }
      ]
    }
  }
}

Documentation Index

​قبل استدعائها

​تدفق المهمة

التفويضات

الجسم

الاستجابة

قبل استدعائها

تدفق المهمة