submit_agent_task

📢 混剪模板 API 调用指南

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

🚀 快速开始

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

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

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

💰 计费与点数说明

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

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

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

🛠️ 高级自定义

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

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

各输入参数说明

kongjing_urls : 上传的空镜素材
mix_mode: 模式有旁白还是无旁白。默认:narration_mix（有旁白），broll_only (无旁白)。
mix_mode=narration_mix ，下面三个参数三选一
text_contents：文案列表，支持最多五个文案
audio_urls: 口播音频
video_urls: 口播视频
subtitle_templates: 要生成字幕模板列表，字幕模板参考
target_duration:生成视频时长 (仅在mix_mode=broll_only 有效)

基于多个空镜素材视频图片和文案内容进行AI进行自动剪辑，添加字幕、配音等

请求示例结构：

{
    "agent_id": "hunjian_7c2e9f4a1b8d4c6f9a0e3d5b2f718c94",// 模版id,必填
    "params": {
        "mix_mode":"narration_mix",
        "kongjing_urls": [
            "http://player.install-ai-guider.top/files/6921810bab8bfad6516eccd1/upload_f4c62a21a3244c029739ce21dc966d44.mp4?OSSAccessKeyId=LTAI5t8QxFyxBtk3ApZgrQfZ&Expires=1780416978&Signature=%2BKRj8vlSeK5vSzr7b4lg3yOdHpw%3D",
            "http://player.install-ai-guider.top/files/6921810bab8bfad6516eccd1/upload_f4c62a21a3244c029739ce21dc966d44.mp4?OSSAccessKeyId=LTAI5t8QxFyxBtk3ApZgrQfZ&Expires=1780416978&Signature=%2BKRj8vlSeK5vSzr7b4lg3yOdHpw%3D"
        ],
        "text_contents":[{"text":"人间烟火，不过是三餐四季，一食一味。远离精致的摆盘与昂贵的食材，家中灶台升腾的烟火，才是最抚人心的滋味。","provider":"fish","voice_id":"gv_99aa3d0b1ebc476bb6f463f97197b95b"}],
        "subtitle_templates":["asr_1f9c8d7e6a2b4c0d9e8f123456789abc","asr_a3d4f6b8c1e24f7b9a0d5e6c8f2b1a97"]
    }
}

2. 口播音频

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

请求示例结构：

{
    "agent_id": "hunjian_7c2e9f4a1b8d4c6f9a0e3d5b2f718c94",// 模版id,必填
    "params": {
        "mix_mode":"narration_mix",
        "kongjing_urls": [
            "http://player.install-ai-guider.top/files/6921810bab8bfad6516eccd1/upload_f4c62a21a3244c029739ce21dc966d44.mp4?OSSAccessKeyId=LTAI5t8QxFyxBtk3ApZgrQfZ&Expires=1780416978&Signature=%2BKRj8vlSeK5vSzr7b4lg3yOdHpw%3D",
            "http://player.install-ai-guider.top/files/6921810bab8bfad6516eccd1/upload_f4c62a21a3244c029739ce21dc966d44.mp4?OSSAccessKeyId=LTAI5t8QxFyxBtk3ApZgrQfZ&Expires=1780416978&Signature=%2BKRj8vlSeK5vSzr7b4lg3yOdHpw%3D"
        ],
        "audio_urls":["http://player.install-ai-guider.top/files/69b3b9368c13f302ca261ea8/upload_040f2d4336814a6882ffd5993a8bc6db.mp3?OSSAccessKeyId=LTAI5t8QxFyxBtk3ApZgrQfZ&Expires=1782963164&Signature=s2k4uo2BQ0Dc%2FtOsubOeZAiZUEo%3D"],
        "subtitle_templates":["asr_1f9c8d7e6a2b4c0d9e8f123456789abc","asr_a3d4f6b8c1e24f7b9a0d5e6c8f2b1a97"]
    }
}

3. video_urls

基于一条原始口播视频进行剪辑

请求示例结构：

{
    "agent_id": "hunjian_7c2e9f4a1b8d4c6f9a0e3d5b2f718c94",// 模版id,必填
    "params": {
        "mix_mode":"narration_mix",
        "kongjing_urls": [
            "http://player.install-ai-guider.top/files/6921810bab8bfad6516eccd1/upload_f4c62a21a3244c029739ce21dc966d44.mp4?OSSAccessKeyId=LTAI5t8QxFyxBtk3ApZgrQfZ&Expires=1780416978&Signature=%2BKRj8vlSeK5vSzr7b4lg3yOdHpw%3D",
            "http://player.install-ai-guider.top/files/6921810bab8bfad6516eccd1/upload_f4c62a21a3244c029739ce21dc966d44.mp4?OSSAccessKeyId=LTAI5t8QxFyxBtk3ApZgrQfZ&Expires=1780416978&Signature=%2BKRj8vlSeK5vSzr7b4lg3yOdHpw%3D"
        ],
        "video_urls":["http://player.install-ai-guider.top/files/69b3b9368c13f302ca261ea8/upload_040f2d4336814a6882ffd5993a8bc6db.mp3?OSSAccessKeyId=LTAI5t8QxFyxBtk3ApZgrQfZ&Expires=1782963164&Signature=s2k4uo2BQ0Dc%2FtOsubOeZAiZUEo%3D"],
        "subtitle_templates":["asr_1f9c8d7e6a2b4c0d9e8f123456789abc","asr_a3d4f6b8c1e24f7b9a0d5e6c8f2b1a97"]
    }
}

4. 不配音

基于空镜素材自动剪辑添加bgm剪辑视频

请求示例结构：

{
    "agent_id": "hunjian_7c2e9f4a1b8d4c6f9a0e3d5b2f718c94",// 模版id,必填
    "params": {
        "mix_mode":"broll_only",
        "kongjing_urls": [
            "http://player.install-ai-guider.top/files/6921810bab8bfad6516eccd1/upload_f4c62a21a3244c029739ce21dc966d44.mp4?OSSAccessKeyId=LTAI5t8QxFyxBtk3ApZgrQfZ&Expires=1780416978&Signature=%2BKRj8vlSeK5vSzr7b4lg3yOdHpw%3D",
            "http://player.install-ai-guider.top/files/6921810bab8bfad6516eccd1/upload_f4c62a21a3244c029739ce21dc966d44.mp4?OSSAccessKeyId=LTAI5t8QxFyxBtk3ApZgrQfZ&Expires=1780416978&Signature=%2BKRj8vlSeK5vSzr7b4lg3yOdHpw%3D"
        ],
        "target_duration":30
    }
}

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

curl --location 'https://open.vectcut.com/cut_jianying/agent/submit_agent_task' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "agent_id": "hunjian_7c2e9f4a1b8d4c6f9a0e3d5b2f718c94", // 模版id,必填 "params": { "mix_mode": "narration_mix", "kongjing_urls": [ "http://player.install-ai-guider.top/files/69b3b9368c13f302ca261ea8/upload_86c94149f41d45bb8d8001424628449f.mp4?OSSAccessKeyId=LTAI5t8QxFyxBtk3ApZgrQfZ&Expires=1783747805&Signature=RturF3qMHe6nkOhv3JTUumyMVq4%3D", "http://player.install-ai-guider.top/files/69b3b9368c13f302ca261ea8/upload_4e70d0f95309463ebb0722845630d452.png?OSSAccessKeyId=LTAI5t8QxFyxBtk3ApZgrQfZ&Expires=1784045571&Signature=tS7vo%2FEMm0H%2BMIGh1jsVnfbg0To%3D", "http://player.install-ai-guider.top/files/69b3b9368c13f302ca261ea8/upload_17b1455cda3a480a9f39d0fa2287bb22.mp4?OSSAccessKeyId=LTAI5t8QxFyxBtk3ApZgrQfZ&Expires=1783654829&Signature=OeV8ittI8%2FASZyEiosmIiUwKPbQ%3D" ], "text_contents": [ { "text": "一碗熬煮许久的浓汤，历经烟火淬炼，褪去浮躁，留下纯粹鲜香。忙碌的日子里，美食是最好的慰藉。无论在外奔波多疲惫，归家一碗热食，滚烫的温度穿透肠胃，治愈所有委屈与匆忙。烟火藏温柔，食味暖人心。寻常的一饭一蔬，承载着生活的暖意与期许，岁岁三餐，烟火绵长，这便是普通人最安稳、最幸福的人间圆满", "provider": "fish", "voice_id": "gv_99aa3d0b1ebc476bb6f463f97197b95b" } ], "subtitle_templates": [ "asr_1f9c8d7e6a2b4c0d9e8f123456789abc" ] } }'

📢 混剪模板 API 调用指南

🚀 快速开始

💰 计费与点数说明

🛠️ 高级自定义

各输入参数说明

请求示例结构：

2. 口播音频

请求示例结构：

3. video_urls

请求示例结构：

4. 不配音

请求示例结构：

请求参数

返回响应

submit_agent_task

📢 混剪模板 API 调用指南#

🚀 快速开始#

💰 计费与点数说明#

🛠️ 高级自定义#

各输入参数说明#

请求示例结构：#

2. 口播音频#

请求示例结构：#

3. video_urls#

请求示例结构：#

4. 不配音#

请求示例结构：#

请求参数

返回响应

📢 混剪模板 API 调用指南

🚀 快速开始

💰 计费与点数说明

🛠️ 高级自定义

各输入参数说明

请求示例结构：

2. 口播音频

请求示例结构：

3. video_urls

请求示例结构：

4. 不配音

请求示例结构：