Kling
虚拟试穿
DeerAPI 虚拟试穿接入说明：说明 Kolors try-on 的 capability ID、model_name、服饰输入约束和查询方式。
POST
/
kling
/
v1
/
images
/
kolors-virtual-try-on
cURL
Copy
curl --request POST \
+ --url https://api.deerapi.com/kling/v1/images/kolors-virtual-try-on \
+ --header 'Authorization: Bearer <DEERAPI_KEY>' \
+ --header 'Content-Type: application/json' \
+ --data '{
"model_name": "kolors-virtual-try-on-v1-5",
"human_image": "https://example.com/model-photo.png",
"cloth_image": "https://example.com/garment-photo.png",
"callback_url": "https://example.com/kling/callback"
}'Copy
{
"code": 123,
"message": "<string>",
"request_id": "<string>",
"data": {
"task_id": "<string>",
"task_status": "<string>",
"created_at": 123,
"updated_at": 123
}
}/kling/v1/images/kolors-virtual-try-on 适合把服饰图穿到人物图上，快速验证款式、版型和搭配。它不是通用重绘接口，更适合标准人物图加标准服饰图的工作流。
DeerAPI capability 是
kling_virtual_try_on，但请求体里的 model_name 仍然是官方 Kolors 模型值。按当前 schema，kolors-virtual-try-on-v1-5 支持更完整的服饰组合场景。快速上手
- 首个请求先保留
human_image和cloth_image。 - 需要固定版本时，再显式传
model_name。 - 人物图和服饰图都建议主体清晰、无遮挡、边界明确。
- 使用 Base64 时，只传原始编码，不要带
data:image/...;base64,前缀。 - 想省掉轮询时，在创建阶段直接带
callback_url。
常见误解和限制
- 把整套场景重绘、商品棚拍或海报生成需求交给试穿接口。
- 人物图姿态过度遮挡，或服饰图背景信息太杂。
- 把 capability ID 当成
model_name传入。
相关页面
图像生成
需要创意海报或场景图时，通常还是先从图像生成起稿。
图像识别
需要先做人物、服饰或主体分割时可以先走这页。
查询任务
试穿任务提交后，仍按通用 Kling 图像任务方式轮询。
Callback 协议
需要把试穿结果直接回推到业务服务时使用。
Authorizations
Bearer token authentication. Use your DeerAPI key.
Body
application/json
请求体沿用官方 Kolors 字段语义；其中 model_name 仍然是官方模型名，不是 DeerAPI live capability ID。
上传的人物图片。支持Base64编码或URL，格式支持.jpg/.jpeg/.png，大小不超过10MB，分辨率不小于300*300px
虚拟试穿的服饰图片。支持Base64编码或URL，格式支持.jpg/.jpeg/.png，大小不超过10MB，分辨率不小于300*300px。支持上装、下装、连体装，以及v1-5版本支持上下装组合
任务结果回调通知地址
自定义任务 ID，用于业务侧关联与排查。
Available options:
kolors-virtual-try-on-v1, kolors-virtual-try-on-v1-5 ⌘I
cURL
Copy
curl --request POST \
+ --url https://api.deerapi.com/kling/v1/images/kolors-virtual-try-on \
+ --header 'Authorization: Bearer <DEERAPI_KEY>' \
+ --header 'Content-Type: application/json' \
+ --data '{
"model_name": "kolors-virtual-try-on-v1-5",
"human_image": "https://example.com/model-photo.png",
"cloth_image": "https://example.com/garment-photo.png",
"callback_url": "https://example.com/kling/callback"
}'Copy
{
"code": 123,
"message": "<string>",
"request_id": "<string>",
"data": {
"task_id": "<string>",
"task_status": "<string>",
"created_at": 123,
"updated_at": 123
}
}