虚拟试穿 - APICore

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Content-Type

string

可选

示例值:

application/json

Authorization

string

可选

示例值:

Bearer sk-xxxx

Body 参数application/json

model_name

enum<string>

模型名称

可选

枚举值:

kolors-virtual-try-on-v1-5kolors-virtual-try-on-v1

默认值:

kolors-virtual-try-on-v1

human_image

string

上传的人物图片

必需

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

cloth_image

string

虚拟试穿的服饰图片

必需

● 支持上传服饰商品图或服饰白底图，支持上装upper、下装lower、与连体装dress
● 支持传入图片Base64编码或图片URL（确保可访问）
● 图片格式支持.jpg / .jpeg / .png
● 图片文件大小不能超过10MB，图片分辨率不小于300*300px
● 其中 kolors-virtual-try-on-v1-5 模型不仅支持单个服装输入，还支持“上装+下装”形式服装组合输入，即：
输入单个服饰图片（上装 or 下装 or 连体装）-> 生成试穿的单品图片
输入组合服饰图片（您可以将多个单品服饰白底图拼接到同一张图片）
模型检测为“上装+下装” -> 生成试穿的“上装+下装”图片
模型检测为“上装+上装” -> 生成失败
模型检测为“下装+下装” -> 生成失败
模型检测为“连体装+连体装” -> 生成失败
模型检测为“上装+连体装” -> 生成失败
模型检测为“下装+连体装” -> 生成失败
组合服饰图片示例

callback_url

string

通知地址

可选

本次任务结果回调通知地址，详见 CallBack协议

示例

{
    "model_name": "kolors-virtual-try-on-v1-5",
    "human_image": "https://gw.alicdn.com/imgextra/i1/1860536677/O1CN012wEzZ11zC7RDNm0Jr_!!1860536677.jpg",
    "cloth_image": "https://gw.alicdn.com/imgextra/i4/3370044138/O1CN01p0Zl411gRFvj0NnwQ_!!3370044138.jpg"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.apicore.ai/kling/v1/images/kolors-virtual-try-on' \
--header 'Authorization: Bearer sk-xxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model_name": "kolors-virtual-try-on-v1-5",
    "human_image": "https://gw.alicdn.com/imgextra/i1/1860536677/O1CN012wEzZ11zC7RDNm0Jr_!!1860536677.jpg",
    "cloth_image": "https://gw.alicdn.com/imgextra/i4/3370044138/O1CN01p0Zl411gRFvj0NnwQ_!!3370044138.jpg"
}'

返回响应

🟢200成功

application/json

Body

code

string

必需

message

string

必需

request_id

string

必需

data

object

必需

task_id

string

必需

task_status

string

必需

created_at

string

必需

updated_at

string

必需

示例

{
    "code": 0,
    "message": "SUCCEED",
    "request_id": "Cji7cGctxFMAAAAAAEU5sQ",
    "data": {
        "task_id": "Cji7cGctxFMAAAAAAEU5sQ",
        "task_status": "submitted",
        "created_at": 1731172864209,
        "updated_at": 1731172864209
    }
}