虚拟试穿（创建任务）

官方完整文档：https://www.klingai.com/document-api/api/ecommerce-replication/virtual-try-on#section-2

功能简介
虚拟试穿（virtual_try_on）是面向服饰电商场景的图像生成 API。开发者输入一张服饰参考图与一张模特参考图后，系统将参考服饰的款式、颜色和纹理，在目标人物图上生成试穿结果图。

该能力适用于商品详情页素材制作、上新测款、广告素材扩展和买家秀批量生成等场景。

虚拟试穿通过 POST /solutions/virtual_try_on 提交试穿任务，异步返回结果图片。任务提交后，可通过查询接口按任务 ID 轮询状态，也可在创建任务时传入 callback_url 接收异步回调，无需主动轮询。

API 支持三个独立的图像控制维度：

控制维度说明
人脸保持（keep_face）保留人物面部特征、五官、表情与发型
姿态保持（keep_pose）保留人物原始姿势、身体朝向与位置
背景保持（keep_background）保留人物图原始背景，或生成与服饰风格协调的新背景
三个维度默认全部开启，可按场景需求单独调整。

接入与使用建议
图片质量要求
服饰图（product_image）

服饰图支持真人上身图、人台商品图、平铺服装图、白底或简洁背景商品图。
不建议使用主体多件服饰不清晰、服装被道具大面积遮挡、带明显水印 / 促销文字 / 拼图边框、低清强反光过曝、严重褶皱或服装轮廓不完整的图片。
支持 jpg、jpeg、png、webp；图片最长边不超过 2048px，短边大于 300px，体积不超过 10MB。
人物图（person_image）

人物图建议为单人图，正面或四分之三侧身，人物主体清晰且试穿区域完整可见，避免多人画面、半身过窄裁切、夸张姿势以及手臂大面积遮挡服装区域。
启用 keep_pose: true 时，人物图中的姿势将被保留；建议使用身体自然舒展的站姿图，避免遮挡手部区域。
图片格式与尺寸建议同服饰图。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "contents": [
        {
            "type": "product_image",
            "url": "https://cdn.example.com/product.jpg"
        },
        {
            "type": "person_image",
            "url": "https://cdn.example.com/person.jpg"
        }
    ],
    "settings": {
        "keep_face": true,
        "keep_pose": true,
        "keep_background": true
    },
    "options": {
        "callback_url": "https://example.com/callback",
        "external_task_id": "virtual-tryon-001",
        "watermark": {
            "enabled": false
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "message": "string",
    "request_id": "string",
    "data": {
        "task_id": "string",
        "status": "string",
        "create_time": 1788595200000,
        "update_time": 1788595200000,
        "external_id": "string"
    }
}