Passer au contenu principal
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>"
        }
      ]
    }
  }
}
Utilisez ce endpoint pour générer une image d’essayage virtuel à partir d’une image de personne et d’une image de vêtement.

​
Avant de l’appeler

  • Fournissez une human_image et une cloth_image
  • Commencez avec kolors-virtual-try-on-v1 ou kolors-virtual-try-on-v1-5
  • Utilisez des photos produit de vêtements nettes ou des images de vêtements sur fond blanc pour le premier test

​
Flux de tâche

1

Soumettre la tâche d’essayage

Envoyez l’image de la personne et l’image du vêtement, puis enregistrez l’identifiant de tâche renvoyé.
2

Interroger la tâche

Continuez avec Requêtes individuelles jusqu’à ce que la tâche atteigne un état terminal et renvoie l’image générée.
3

Persister le résultat

Enregistrez l’image finale dans votre propre stockage si le résultat d’essayage doit être conservé plus longtemps.
Pour la référence complète des paramètres, consultez la documentation officielle de Kling.

Autorisations

​
Authorization
string
header
requis

Bearer token authentication. Use your CometAPI key.

Corps

application/json
​
human_image
string
défaut:example
requis

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
défaut:example
requis

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>
défaut:kolors-virtual-try-on-v1

Virtual try-on model version.

Options disponibles:
kolors-virtual-try-on-v1,
kolors-virtual-try-on-v1-5

Réponse

200 - application/json

Successful Response

​
code
integer
requis

Error code; specifically define the error code

​
message
string
requis

error message

​
request_id
string
requis

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

​
data
object
requis