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

استخدم واجهة CometAPI Kling للتجربة الافتراضية للملابس لإنشاء فيديوهات واقعية لتغيير الأزياء من صورة شخص وصورة ملابس، مع عناصر تحكم في الأسلوب والملاءمة.

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

Virtual Try-On

cURL

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

200

{
  "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
• استخدم صورًا واضحة لمنتجات الملابس أو صورًا لقطع الملابس بخلفية بيضاء في الاختبار الأول

​

تدفق المهمة

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

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

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

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

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

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

للاطلاع على المرجع الكامل للمعلمات، راجع وثائق 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