Skip to main content
POST
cURL
Usa questo endpoint per generare un’immagine di prova virtuale da un’immagine di una persona e un’immagine di un capo di abbigliamento.

Prima di effettuare la chiamata

  • Fornisci un valore per human_image e uno per cloth_image
  • Inizia con kolors-virtual-try-on-v1 o kolors-virtual-try-on-v1-5
  • Per il primo test, usa scatti puliti dei prodotti di abbigliamento o immagini di capi su sfondo bianco

Flusso dell’attività

1

Invia l'attività di prova virtuale

Invia l’immagine della persona e quella dell’abbigliamento, quindi salva l’ID dell’attività restituito.
2

Esegui il polling dell'attività

Esegui il polling del percorso di query dell’immagine Kling corrispondente finché l’attività non raggiunge uno stato terminale e restituisce l’immagine renderizzata.
3

Conserva il risultato

Salva l’immagine finale nel tuo spazio di archiviazione se il risultato della prova virtuale deve essere conservato più a lungo.
Per il riferimento completo dei parametri, consulta la documentazione ufficiale di Kling.

Authorizations

Authorization
string
header
required

Bearer token authentication. Use your CometAPI key.

Headers

Content-Type
string
default:application/json

Must be application/json.

Body

application/json
human_image
string
required

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
required

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

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

Available options:
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.

Response

200 - application/json

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

code
required

Response code. 0 means the task request was accepted.

message
string
required

Response message.

data
object
required
request_id
string

Request identifier returned when present.

Last modified on September 9, 2026