Skip to main content
POST
cURL
Verwenden Sie diesen Endpunkt, um aus einem Personenbild und einem Kleidungsbild ein virtuelles Try-on-Bild zu erzeugen.

Bevor Sie ihn aufrufen

  • Stellen Sie ein human_image und ein cloth_image bereit
  • Beginnen Sie mit kolors-virtual-try-on-v1 oder kolors-virtual-try-on-v1-5
  • Verwenden Sie für den ersten Test saubere Produktfotos von Kleidung oder Kleidungsbilder mit weißem Hintergrund

Aufgabenablauf

1

Try-on-Task senden

Senden Sie das Personenbild und das Kleidungsbild und speichern Sie dann die zurückgegebene Task-ID.
2

Task abfragen

Fragen Sie den passenden Kling-Bildabfragepfad ab, bis die Task einen Endzustand erreicht und das gerenderte Bild zurückgibt.
3

Ergebnis speichern

Speichern Sie das fertige Bild in Ihrem eigenen Speicher, wenn das Try-on-Ergebnis länger aufbewahrt werden muss.
Die vollständige Parameterreferenz finden Sie in der offiziellen Kling-Dokumentation.

Autorisierungen

Authorization
string
header
erforderlich

Bearer token authentication. Use your CometAPI key.

Header

Content-Type
string
Standard:application/json

Must be application/json.

Body

application/json
human_image
string
erforderlich

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
erforderlich

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

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

Verfügbare Optionen:
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.

Antwort

200 - application/json

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

code
erforderlich

Response code. 0 means the task request was accepted.

message
string
erforderlich

Response message.

data
object
erforderlich
request_id
string

Request identifier returned when present.