Skip to main content
POST
cURL
Usa questo endpoint per generare un’immagine di virtual try-on a partire da un’immagine di una persona e un’immagine di un capo di abbigliamento.

Prima di chiamarlo

  • Fornisci un human_image e un cloth_image
  • Inizia con kolors-virtual-try-on-v1 o kolors-virtual-try-on-v1-5
  • Per il primo test, usa foto pulite del prodotto o immagini del capo con sfondo bianco

Flusso dell’attività

1

Invia l'attività di try-on

Invia l’immagine della persona e l’immagine del capo di abbigliamento, quindi salva il task id restituito.
2

Interroga l'attività

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

Salva il risultato

Salva l’immagine completata nel tuo sistema di archiviazione se il risultato del try-on deve essere conservato più a lungo.
Per il riferimento completo dei parametri, consulta la documentazione ufficiale di Kling.

Autorizzazioni

Authorization
string
header
obbligatorio

Bearer token authentication. Use your CometAPI key.

Intestazioni

Content-Type
string
predefinito:application/json

Must be application/json.

Corpo

application/json
human_image
string
obbligatorio

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
obbligatorio

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

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

Opzioni disponibili:
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.

Risposta

200 - application/json

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

code
obbligatorio

Response code. 0 means the task request was accepted.

message
string
obbligatorio

Response message.

data
object
obbligatorio
request_id
string

Request identifier returned when present.