虚拟试穿 - UniAPI API Doc

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

model_name

string

必需

模型名称

枚举值：kolors-virtual-try-on-v1, kolors-virtual-try-on-v1-5

human_image

string

必需

上传的人物图片

支持传入图片Base64编码或图片URL（确保可访问）
图片格式支持.jpg / .jpeg / .png
图片文件大小不能超过10MB，图片宽高尺寸不小于300px

cloth_image

string

必需

虚拟试穿的服饰图片

支持上传服饰商品图或服饰白底图，支持上装upper、下装lower、与连体装dress

支持传入图片Base64编码或图片URL（确保可访问）

图片格式支持.jpg / .jpeg / .png

图片文件大小不能超过10MB，图片宽高尺寸不小于300px

其中 kolors-virtual-try-on-v1-5 模型不仅支持单个服装输入，还支持“上装+下装”形式服装组合输入，即：

输入单个服饰图片（上装 or 下装 or 连体装）-> 生成试穿的单品图片
输入组合服饰图片（您可以将多个单品服饰白底图拼接到同一张图片）
模型检测为“上装+下装” -> 生成试穿的“上装+下装”图片
模型检测为“上装+上装” -> 生成失败
模型检测为“下装+下装” -> 生成失败
模型检测为“连体装+连体装” -> 生成失败
模型检测为“上装+连体装” -> 生成失败
模型检测为“下装+连体装” -> 生成失败

callback_url

string

可选

本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知

具体通知的消息schema见“Callback协议”

示例

{
    "model_name": "string",
    "human_image": "string",
    "cloth_image": "string",
    "callback_url": "string"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.uniapi.io/kling/v1/images/kolors-virtual-try-on' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model_name": "string",
    "human_image": "string",
    "cloth_image": "string",
    "callback_url": "string"
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码；具体定义错误码

message

string

错误信息

必需

request_id

string

必需

请求ID，系统生成，用于跟踪请求、排查问题

data

object

必需

task_id

string

任务ID，系统生成

必需

task_status

string

必需

任务状态，枚举值：枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）

created_at

integer

必需

任务创建时间，Unix时间戳、单位ms

updated_at

integer

必需

任务更新时间，Unix时间戳、单位ms

示例

{
  "code": 0, //错误码；具体定义错误码
  "message": "string", //错误信息
  "request_id": "string", //请求ID，系统生成，用于跟踪请求、排查问题
  "data": {
    "task_id": "string", //任务ID，系统生成
    "task_status": "string", //任务状态，枚举值：枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
    "created_at": 1722769557708, //任务创建时间，Unix时间戳、单位ms
    "updated_at": 1722769557708 //任务更新时间，Unix时间戳、单位ms
  }
}