Skip to main content
POST
cURL
Usa este endpoint para generar una imagen de prueba virtual 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
  • Empieza con kolors-virtual-try-on-v1 o kolors-virtual-try-on-v1-5
  • Usa fotos limpias del producto de la prenda o imágenes de prendas con fondo blanco para la primera prueba

Flujo de la tarea

1

Enviar la tarea de try-on

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

Consultar la tarea

Consulta la ruta de consulta de imágenes de Kling correspondiente 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 del try-on necesita conservarse durante 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.

Encabezados

Content-Type
string
predeterminado:application/json

Must be application/json.

Cuerpo

application/json
human_image
string
requerido

Person image to dress. Image URL or raw Base64 string without a data: prefix. Supported formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.

cloth_image
string
requerido

Clothing image for the try-on. Image URL or raw Base64 string without a data: prefix. Supported formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1. Supports tops, bottoms, and one-piece dresses.

model_name
enum<string>
predeterminado:kolors-virtual-try-on-v1

Virtual try-on model version. Defaults to kolors-virtual-try-on-v1.

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

Webhook URL for task status notifications.

external_task_id
string

Optional user-defined task ID for your own tracking. Must be unique per account.

Respuesta

200 - application/json

Task request accepted or an error response returned by the API.

code
requerido

Response code. 0 means the task request was accepted.

message
string
requerido

Response message.

data
object
requerido
request_id
string

Request identifier returned when present.