一键换装（创建任务）

官方完整文档：https://www.klingai.com/document-api/api/ecommerce-replication/apparel

功能简介
一键换装（clothing_dupe）是面向服装品类电商商家和平台运营团队的 AI 视频生成服务。用户只需提供一段服装商品的参考视频和商品图，系统即可自动生成展示用户商品的新视频，有效降低内容生产成本与交付周期。

系统会将参考视频中的服装替换为用户上传的服装，并尽量复刻参考视频中的展示节奏、镜头语言、动作姿态、场景氛围和商品呈现方式。

生成产物为一段基于参考视频的 5～180 秒商品展示视频。

接入与使用建议
商品图素材质量建议
商品图建议使用高分辨率素材（长边 ≥ 1000px），背景干净、主体居中、光线均匀。
上传多张图时，建议涵盖不同角度（正面、侧面、细节），有助于系统生成更丰富的展示视角。
避免上传已有大量文字水印或强烈滤镜的素材。
适用场景
新品上市快速出片：从素材到完整视频物料，分钟级交付。
大促活动批量备片：支持批量调用，快速产出多 SKU 视频内容。
内容营销素材生产：展示视频可直接用于信息流广告、短视频平台投放。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "contents": [
        {
            "type": "product_info",
            "text": "轻盈透气短袖衬衫，商务休闲百搭"
        },
        {
            "type": "source_video",
            "url": "https://your-cdn.com/ref_video.mp4"
        },
        {
            "type": "product_image",
            "url": "https://your-cdn.com/product_shirt.jpg"
        },
        {
            "type": "model_image",
            "url": "https://your-cdn.com/model.jpg"
        }
    ],
    "settings": {
        "resolution": "720p",
        "aspect_ratio": "16:9"
    },
    "options": {
        "callback_url": "https://example.com/callback",
        "external_task_id": "my_task_123",
        "watermark_info": {
            "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": {
        "id": "string",
        "status": "submitted",
        "create_time": 0,
        "update_time": 0,
        "external_id": "string"
    }
}

🟠400

🟠401