submit_agent_task

📢 口播模板 API 调用指南

本接口支持通过 AI Agent 发起口播视频生成任务。采用异步处理架构，支持高并发批量调用。

🚀 快速开始

异步机制：提交任务后会立即返回 task_id，请通过回调或查询接口获取任务状态。

批量支持：支持同时发起多任务，提升生成效率。

参数映射：不同的 agent_id 对应特定的配置参数，请严格参考下表及示例代码进行传参。

💰 计费与点数说明

消耗估算：不同模板的收费标准不同，通常在 20 ~ 200 点/分钟 之间。

预留余额：由于 AI 执行过程中消耗的 Token 具有不确定性，强烈建议在账户中预留充足的点数。

欠费风险：任务中途若遭遇欠费，将导致草稿生成中断且无法完成，此类情况系统无法自动退款。

🛠️ 高级自定义

原生驱动：所有官方模板均基于 流光剪辑开放API平台 及文档中公开的 API 构建。

自由定制：你可以通过 VectCut 官网自行编辑或创建 Agent，打造专属的视频生产工作流。

各模版输入参数说明

1. 知识黄白·AI画中画

基于一条原始口播视频进行包装剪辑，添加字幕、配音、特效、画中画效果。

请求示例结构：

{
    "agent_id": "koubo_8f4e3d2a91c74b76a85d2c4e7f8a9b1c",// 模版id,必填
    "params": {
        "video_url": [
            "http://player.install-ai-guider.top/files/6921810bab8bfad6516eccd1/upload_f4c62a21a3244c029739ce21dc966d44.mp4?OSSAccessKeyId=LTAI5t8QxFyxBtk3ApZgrQfZ&Expires=1780416978&Signature=%2BKRj8vlSeK5vSzr7b4lg3yOdHpw%3D" // 原视频链接，必填
        ],
        "cover":[
            "https://player.install-ai-guider.top/example/mao.webp"
        ], // 封面图，可选
        "title": "标题", // 标题，可选
        "text_content":"正确文案" // 正确文案，可选
    }
}

2. 经典·细黄

基于一条口播和若干条空镜进行剪辑，通过AI识别口播的内容和空镜进行匹配，自动将空镜的相关片段添加到口播画中画效果

请求示例结构：

{
    "agent_id": "koubo_ddfe028229d24696bf080303c95f604c",// 口播ID, 必填
    "params": {
        "video_url": [
            "https://player.install-ai-guider.top/example/koubo_source.mp4"
        ], // 原视频链接，必填，只能填1个。
        "text_content":"正确文案",// 原视频正确文案，选填，小语种或者方言必填
        "kongjing_urls": [
            "https://player.install-ai-guider.top/example/koubo_kongjing_1.mp4"
        ], // 空镜素材链接，必填，最少1个，最多10个，最好单个时长不超过15秒
        "author": "作者", // 作者，选填
        "cover": [
            "https://player.install-ai-guider.top/example/mao.webp"
        ], // 封面，选填
        "name": "测试草稿" // 草稿名，选填
    }
}

3. ins风·繁体双语

基于一条原始口播视频进行剪辑，添加繁体双语字幕

请求示例结构：

{
    "agent_id": "koubo_cbbe5e6b468844e782c961fd9ee07b7d", // 口播ID，必填
    "params": {
        "video_url": [
            "https://player.install-ai-guider.top/example/koubo_source.mp4"
        ], // 原视频链接，必填，只能填1个。
        "text_content":"正确文案",// 原视频正确文案，选填，小语种或者方言必填
        "title": "流光剪辑标题", // 顶部标题，选填
        "cover": [
            "https://player.install-ai-guider.top/example/mao.webp"
        ], // 封面，选填
        "name": "测试草稿" // 草稿名，选填
    }
}

4. 国风经典

基于一条原始口播视频进行剪辑，添加简洁白色的经典字幕

请求示例结构：

{
    "agent_id": "koubo_d8b7f9e05c4a11efb9620242ac120003", // 口播ID, 必填
    "params": {
        "video_url": [
            "https://player.install-ai-guider.top/example/koubo_source.mp4"
        ], // 原视频链接，必填，只能填1个。
        "text_content":"正确文案",// 原视频正确文案，选填，小语种或者方言必填
        "title": "流光剪辑标题", // 顶部标题，选填
        "cover": [
            "https://player.install-ai-guider.top/example/mao.webp"
        ], // 封面，选填
        "name": "测试草稿" // 草稿名，选填
    }
}

5. 基础黄白

基于一条原始口播视频进行剪辑，添加黄色、白色交替展示的字幕效果

请求示例结构：

{
    "agent_id": "koubo_b82feeb636f3476a9a752ebd745d9750", // 口播ID, 必填
    "params": {
        "video_url": [
            "https://player.install-ai-guider.top/example/koubo_source.mp4"
        ], // 原视频链接，必填，只能填1个。
        "text_content":"正确文案",// 原视频正确文案，选填，小语种或者方言必填
        "title": "流光剪辑标题", // 顶部标题，选填
        "cover": [
            "https://player.install-ai-guider.top/example/mao.webp"
        ], // 封面，选填
        "name": "测试草稿" // 草稿名，选填
    }
}

6. AI剪气口

基于一条原始口播视频进行剪辑，增强了AI对于气口、停顿、错误、重复的识别去除能力。

请求示例结构：

{
    "agent_id": "koubo_2dfb2efedde84791b218cfd798531bc8", // 口播ID, 必填
    "params": {
        "video_url": [
            "https://player.install-ai-guider.top/example/koubo_test3.mp4"
        ], // 原视频链接，必填，只能填1个。
        "title": "你必须非常努力\n才能毫不费力" // 顶部标题，选填
    }
}

7. 高级黄·双行

高级感黄色进行关键字强调，同时添加了大量的AI配图丰富画面效果。

请求示例结构：

{
    "agent_id": "koubo_d47e8a905f1b48798e76123456789abc", // 口播ID, 必填
    "params": {
        "video_url": [
            "https://player.install-ai-guider.top/example/koubo_source.mp4"
        ], // 原视频链接，必填，只能填1个。
        "text_content":"正确文案",// 原视频正确文案，选填，小语种或者方言必填
        "title": "流光剪辑标题", // 顶部标题，选填
        "cover": [
            "https://player.install-ai-guider.top/example/mao.webp"
        ], // 封面，选填
        "name": "测试草稿" // 草稿名，选填
    }
}

8. 高级红·双语

高级感红色进行关键字强调，搭配英文翻译更显国际范。

请求示例结构：

{
    "agent_id": "koubo_1f9c8d7e6a2b4c0d9e8f123456789abc", // 口播ID, 必填
    "params": {
        "video_url": [
            "https://player.install-ai-guider.top/example/koubo_source.mp4"
        ], // 原视频链接，必填，只能填1个。
        "text_content":"正确文案",// 原视频正确文案，选填，小语种或者方言必填
        "cover": [
            "https://player.install-ai-guider.top/example/mao.webp"
        ], // 封面，选填
        "name": "测试草稿" // 草稿名，选填
    }
}

9. 轻奢白·双语

轻奢低调的黄白色双语口播模版来啦！一键让视频更高级~适合[健康美业]，[教育培训]的口播场景

请求示例结构：

{
    "agent_id": "koubo_6a4f2c9e8b1d4f7aa3c5e9d02b6f8c13", // 口播ID, 必填
    "params": {
        "video_url": [
            "https://player.install-ai-guider.top/example/koubo_source.mp4"
        ], // 原视频链接，必填，只能填1个。
        "text_content":"正确文案",// 原视频正确文案，选填，小语种或者方言必填
        "cover": [
            "https://player.install-ai-guider.top/example/mao.webp"
        ], // 封面，选填
        "name": "测试草稿" // 草稿名，选填
    }
}

💡 建议：在正式大规模调用前，请先前往官网控制台查看模版实时效果并进行单次调优。

📢 口播模板 API 调用指南

🚀 快速开始

💰 计费与点数说明

🛠️ 高级自定义

各模版输入参数说明

1. 知识黄白·AI画中画

请求示例结构：

2. 经典·细黄

请求示例结构：

3. ins风·繁体双语

请求示例结构：

4. 国风经典

请求示例结构：

5. 基础黄白

请求示例结构：

6. AI剪气口

请求示例结构：

7. 高级黄·双行

请求示例结构：

8. 高级红·双语

请求示例结构：

9. 轻奢白·双语

请求示例结构：

请求参数

返回响应

submit_agent_task

📢 口播模板 API 调用指南#

🚀 快速开始#

💰 计费与点数说明#

🛠️ 高级自定义#

各模版输入参数说明#

1. 知识黄白·AI画中画#

请求示例结构：#

2. 经典·细黄#

请求示例结构：#

3. ins风·繁体双语#

请求示例结构：#

4. 国风经典#

请求示例结构：#

5. 基础黄白#

请求示例结构：#

6. AI剪气口#

请求示例结构：#

7. 高级黄·双行#

请求示例结构：#

8. 高级红·双语#

请求示例结构：#

9. 轻奢白·双语#

请求示例结构：#

请求参数

返回响应

📢 口播模板 API 调用指南

🚀 快速开始

💰 计费与点数说明

🛠️ 高级自定义

各模版输入参数说明

1. 知识黄白·AI画中画

请求示例结构：

2. 经典·细黄

请求示例结构：

3. ins风·繁体双语

请求示例结构：

4. 国风经典

请求示例结构：

5. 基础黄白

请求示例结构：

6. AI剪气口

请求示例结构：

7. 高级黄·双行

请求示例结构：

8. 高级红·双语

请求示例结构：

9. 轻奢白·双语

请求示例结构：