口播带货（创建任务）

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

功能简介
口播带货（talking_agent）是面向电商商家、品牌方与内容运营团队的 AI 口播视频生成服务。用户提供人物形象、商品素材与口播文案后，系统自动完成文案润色、配音与口型对齐，一键产出可直接投放的口播视频。

本方案采用「生成侧自由生成 + 口型专家模型后处理」链路：视频画面侧不受短时长口型窗口限制，口型一致性由后处理模型兜底修复，适合 15 秒以上的营销口播、多语种口播和批量电商素材生产。

系统会根据 contents 中是否包含商品内容自动分流为两类模式：

达人口播：不传商品内容，全程人物出镜讲解，不生成商品画面，支持通过 settings.speech_rate 调节语速。
口播带货：传入商品内容，人物讲解镜、人货同框镜与货品特写镜自动编排，暂不支持语速调节。
接入与使用建议
人物形象建议
建议使用单人、正脸清晰、嘴部无遮挡的人物素材。
图片建议高分辨率、光线均匀、面部区域清晰，避免多人合影、侧脸、强遮挡、墨镜或强滤镜。
口播带货场景下系统需生成人物与商品同框的画面，建议人物双手自然放松，避免双手被遮挡或插袋。
商品素材建议
商品图建议主体居中、背景干净、光线均匀。
建议上传 1～5 张不同角度商品参考图，如正面、侧面、细节图等。
避免上传已有大量文字、水印或复杂合成痕迹的商品图，避免生成画面复刻无关信息。
口播内容建议
speech_script 为必填项，应为适合直接朗读的口语化表达。
传入商品内容时，建议至少提供 ref_image 与 goods_title，其余商品信息可按需补充。
如文案已经定稿不可改写，可将 settings.allow_polish 设为 false，系统将逐字使用传入的文案。
成片时长由系统根据口播稿自动决定，不支持通过请求指定；口播稿长度是影响成片时长与费用的主要因素。
适用场景
达人口播批量出片：一个形象加一段文案，分钟级产出多条口播视频。
电商带货素材生产：多 SKU 批量调用，直出可投放的带货口播视频。
多语种营销素材：同一商品信息生成不同语种口播，覆盖多地区投放。

请求参数

Header 参数

Body 参数application/json必填

示例

口播带货：传入商品内容达人口播：不传商品内容

{
    "contents": [
        {
            "type": "avatar_image",
            "url": "https://cdn.example.com/person.jpg"
        },
        {
            "type": "ref_image",
            "url": "https://cdn.example.com/jbl-front.jpg"
        },
        {
            "type": "ref_image",
            "url": "https://cdn.example.com/jbl-side.jpg"
        },
        {
            "type": "goods_title",
            "text": "JBL GO 4 便携蓝牙音箱"
        },
        {
            "type": "goods_price",
            "text": "399元"
        },
        {
            "type": "goods_target_audience",
            "text": "露营人群"
        },
        {
            "type": "goods_selling_point",
            "text": "IP67级防尘防水"
        },
        {
            "type": "speech_script",
            "text": "周末出门，我不太想带一堆复杂设备。一只 JBL GO 4 便携蓝牙音箱，挂在包上就能带走。"
        }
    ],
    "settings": {
        "resolution": "1080p",
        "aspect_ratio": "9:16",
        "allow_polish": true,
        "voice_id": "male_calm_informative",
        "action_prompt": "说到便携挂环时抬手展示挂环，语气轻松自然。",
        "bgm_enabled": true
    },
    "options": {
        "callback_url": "https://example.com/cb",
        "external_task_id": "my_task_123",
        "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": "3d0d19a8-2ff4-4be5-97bf-033f74995124",
    "data": {
        "task_id": "947221343928848649",
        "status": "submitted",
        "create_time": 1793937929353,
        "update_time": 1793937929412
    }
}