Prueba virtual de ropa

Usa la API de Prueba virtual de ropa de CometAPI Kling para crear videos realistas de cambio de atuendo a partir de una imagen de una persona y una imagen de una prenda, con controles de estilo y ajuste.

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

Usa este endpoint para generar una imagen de prueba virtual de ropa a partir de una imagen de una persona y una imagen de una prenda.

​

Antes de llamarlo

• Proporciona una human_image y una cloth_image
• Comienza con kolors-virtual-try-on-v1 o kolors-virtual-try-on-v1-5
• Usa fotos limpias del producto de la ropa o imágenes de prendas con fondo blanco para la primera prueba

​

Flujo de la tarea

1. Enviar la tarea de prueba virtual

   Envía la imagen de la persona y la imagen de la prenda, luego guarda el id de tarea devuelto.

2. Consultar la tarea

   Continúa con Consultas individuales hasta que la tarea alcance un estado terminal y devuelva la imagen renderizada.

3. Persistir el resultado

   Guarda la imagen final en tu propio almacenamiento si el resultado de la prueba virtual necesita conservarse por más tiempo.

Para la referencia completa de parámetros, consulta la documentación oficial de Kling.

Autorizaciones

Authorization · string · header · requerido

Bearer token authentication. Use your CometAPI key.

Cuerpo

application/json

human_image · string · predeterminado: example · requerido

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 · predeterminado: example · requerido

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> · predeterminado: kolors-virtual-try-on-v1

Virtual try-on model version.

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

Respuesta

200 - application/json

Successful Response

code · integer · requerido

Error code; specifically define the error code

message · string · requerido

error message

request_id · string · requerido

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

data · object · requerido

Show child attributes