Skip to main content
POST
cURL
이 엔드포인트를 사용하면 인물 이미지 1장과 의류 이미지 1장으로 가상 피팅 이미지를 생성할 수 있습니다.

호출 전에 확인할 사항

  • human_image 1개와 cloth_image 1개를 제공하세요
  • kolors-virtual-try-on-v1 또는 kolors-virtual-try-on-v1-5로 시작하세요
  • 첫 테스트에서는 깔끔한 의류 제품 사진이나 흰 배경의 의류 이미지를 사용하세요

작업 흐름

1

가상 피팅 작업 제출

인물 이미지와 의류 이미지를 전송한 다음, 반환된 작업 id를 저장하세요.
2

작업 폴링

작업이 종료 상태에 도달하고 렌더링된 이미지를 반환할 때까지 해당하는 Kling 이미지 조회 경로를 폴링하세요.
3

결과 저장

가상 피팅 결과를 더 오래 보관해야 하는 경우 완료된 이미지를 자체 스토리지에 저장하세요.
전체 파라미터 참조는 공식 Kling 문서를 확인하세요.

인증

Authorization
string
header
필수

Bearer token authentication. Use your CometAPI key.

헤더

Content-Type
string
기본값:application/json

Must be application/json.

본문

application/json
human_image
string
필수

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
필수

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>
기본값:kolors-virtual-try-on-v1

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

사용 가능한 옵션:
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.

응답

200 - application/json

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

code
필수

Response code. 0 means the task request was accepted.

message
string
필수

Response message.

data
object
필수
request_id
string

Request identifier returned when present.