商品成片（创建任务）

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

功能简介
商品成片（goods_studio）是专为电商商家与平台运营团队打造的 AI 视频生成服务。用户仅需输入商品信息，系统即可一键生成高质量的商品广告视频，降低营销内容的制作成本与交付周期。

系统会自动解析商品图片与核心卖点，合成富有叙事逻辑与营销吸引力的动态画面。

生成产物为一段基于商品信息自动创作的 15～60 秒高质量商品展示视频。

接入与使用建议
商品图素材质量建议
商品图建议使用高分辨率素材（长边 ≥ 1000px），背景干净、主体居中、光线均匀。
上传多张图时，建议涵盖不同角度（正面、侧面、细节），有助于系统生成更丰富的展示视角。
适用场景
新品快速出片：仅需商品信息，分钟级产出可用展示视频。
投放素材一键直出：支持多 SKU 批量调用，一键直出投放素材。
低成本视频化：无需拍摄团队与场地，零片场成本完成冷启动。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "contents": [
        {
            "type": "ref_image",
            "url": "https://cdn.example.com/1.jpg"
        },
        {
            "type": "ref_image",
            "url": "https://cdn.example.com/2.jpg"
        },
        {
            "type": "goods_title",
            "text": "雨伞"
        },
        {
            "type": "goods_description",
            "text": "一把精美的雨伞"
        }
    ],
    "settings": {
        "resolution": "1080p",
        "aspect_ratio": "16:9",
        "duration": 15
    },
    "options": {
        "callback_url": "https://example.com/cb",
        "external_task_id": "",
        "watermark": {
            "enabled": false
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "message": "SUCCEED",
    "request_id": "58364cea-7eeb-4417-be58-bd8f2de16f9a",
    "data": {
        "task_id": "946944201705924101",
        "status": "submitted",
        "create_time": 1793876753146,
        "update_time": 1793876753201
    }
}