Prova Virtual

Use a API de Prova Virtual do Kling da CometAPI para criar vídeos realistas de troca de roupa a partir de uma imagem de pessoa e uma imagem de roupa, com controles de estilo e caimento.

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

Use este endpoint para gerar uma imagem de prova virtual a partir de uma imagem de pessoa e uma imagem de peça de roupa.

​

Antes de chamar

• Forneça uma human_image e uma cloth_image
• Comece com kolors-virtual-try-on-v1 ou kolors-virtual-try-on-v1-5
• Use fotos limpas do produto de roupa ou imagens da peça com fundo branco no primeiro teste

​

Fluxo da tarefa

1. Enviar a tarefa de prova virtual

   Envie a imagem da pessoa e a imagem da roupa e, em seguida, salve o id da tarefa retornado.

2. Consultar a tarefa

   Continue com Consultas Individuais até que a tarefa atinja um estado terminal e retorne a imagem renderizada.

3. Persistir o resultado

   Salve a imagem final no seu próprio armazenamento se o resultado da prova virtual precisar de retenção por mais tempo.

Para a referência completa de parâmetros, consulte a documentação oficial do Kling.

Autorizações

Authorization · string · header · obrigatório

Bearer token authentication. Use your CometAPI key.

Corpo

application/json

human_image · string · padrão: example · obrigatório

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 · padrão: example · obrigatório

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> · padrão: kolors-virtual-try-on-v1

Virtual try-on model version.

Opções disponíveis: kolors-virtual-try-on-v1, kolors-virtual-try-on-v1-5

Resposta

200 - application/json

Successful Response

code · integer · obrigatório

Error code; specifically define the error code

message · string · obrigatório

error message

request_id · string · obrigatório

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

data · object · obrigatório

Show child attributes