Skip to main content
POST
cURL
Use este endpoint para gerar uma imagem de prova virtual a partir de uma imagem de uma pessoa e de uma imagem de uma peça de roupa.

Antes de chamá-lo

  • 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 de produtos de roupa ou imagens de peças 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, depois salve o id da tarefa retornado.
2

Consultar a tarefa

Consulte o caminho correspondente de consulta de imagem do Kling até que a tarefa alcance um estado terminal e retorne a imagem renderizada.
3

Persistir o resultado

Salve a imagem finalizada no seu próprio armazenamento se o resultado da prova virtual precisar de retenção por mais tempo.
Para a referência completa dos parâmetros, veja a documentação oficial do Kling.

Autorizações

Authorization
string
header
obrigatório

Bearer token authentication. Use your CometAPI key.

Cabeçalhos

Content-Type
string
padrão:application/json

Must be application/json.

Corpo

application/json
human_image
string
obrigatório

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
obrigatório

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

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

Opções disponíveis:
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.

Resposta

200 - application/json

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

code
obrigatório

Response code. 0 means the task request was accepted.

message
string
obrigatório

Response message.

data
object
obrigatório
request_id
string

Request identifier returned when present.