Skip to main content
POST
cURL
Utilisez ce endpoint pour générer une image d’essayage virtuel à partir d’une image de personne et d’une image de vêtement.

Avant de l’appeler

  • Fournissez une human_image et une cloth_image
  • Commencez avec kolors-virtual-try-on-v1 ou kolors-virtual-try-on-v1-5
  • Utilisez des photos produit de vêtements nettes ou des images de vêtements sur fond blanc pour le premier test

Flux de tâche

1

Soumettre la tâche d’essayage

Envoyez l’image de la personne et l’image du vêtement, puis enregistrez l’id de tâche renvoyé.
2

Interroger la tâche

Interrogez le chemin de requête d’image Kling correspondant jusqu’à ce que la tâche atteigne un état terminal et renvoie l’image générée.
3

Conserver le résultat

Enregistrez l’image finale dans votre propre stockage si le résultat d’essayage doit être conservé plus longtemps.
Pour la référence complète des paramètres, consultez la documentation officielle de Kling.

Autorisations

Authorization
string
header
requis

Bearer token authentication. Use your CometAPI key.

En-têtes

Content-Type
string
défaut:application/json

Must be application/json.

Corps

application/json
human_image
string
requis

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
requis

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>
défaut:kolors-virtual-try-on-v1

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

Options disponibles:
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.

Réponse

200 - application/json

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

code
requis

Response code. 0 means the task request was accepted.

message
string
requis

Response message.

data
object
requis
request_id
string

Request identifier returned when present.