跳到内容

Vega Agent ​

更新时间

Endpoint: https://smartmedia.vod-qcloud.com/agui认证: VOD ApiToken / Bearer

按所选顺序与条件剪辑视频素材,并执行字幕·语音处理与渲染。如果是首次调用,请先运行 两个视频连接示例。

基本信息 ​

项目取值
请求POST /agui/chat
场景video-mixcut
输入制作指令 + 视频 URL / VOD fileId
结果剪辑后的视频 / 文本与工具执行事件

各版本支持规范 ​

版本模型 ID
1.1 Maxwand-vega-agent-1.1-max
1.0 Maxwand-vega-agent-1.0-max
1.0 Prowand-vega-agent-1.0-pro
1.5 Standardwand-vega-agent-1.5-standard
1.0 Standardwand-vega-agent-1.0-standard
1.0 Litewand-vega-agent-1.0-lite

制作模式 ​

模式原声脚本 / 语音适用场景
Original Audio全部保留 / 去除 BGM 后保留人声使用原声访谈、评测、直播精彩片段
Narration去除用户脚本 / AI 脚本 + TTS产品介绍、解说、宣传视频

请求参数 ​

参数必填类型说明
messages.content必填Array制作指令与素材列表
content.type必填String指令为 text,素材为 mixcut_assets
content.text条件必填String顺序、时长、字幕等剪辑条件
content.metadata.attachments条件必填Array各素材的 url 或 fileId
forwardedProps.model选填String上表中的模型 ID
forwardedProps.scenario_name必填Stringvideo-mixcut

认证、执行 ID 与审批配置遵循 API Reference。

请求示例 ​

这是 输入视频 A 与 B 及成片 中使用的请求。

json
{
  "threadId": "thread-001",
  "runId": "run-001",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "请把附带的视频 A 和 B 按顺序拼接,制作成 6 秒横版视频。在 A 的完整 3 秒之后放置 B 的完整 3 秒,不加转场效果直接连接。保留各视频的原声,不添加额外的音乐或旁白。在 A 片段加入 \"甜蜜的世界\"、B 片段加入 \"今天的主角\",作为画面底部居中的字幕。字幕设置为 Noto Sans KR、白色 96px、黑色描边 4px。渲染为 1920x1080 并返回成片 URL。"
        },
        {
          "type": "mixcut_assets",
          "metadata": {
            "attachments": [
              {
                "url": ""
              },
              {
                "url": ""
              }
            ]
          }
        }
      ]
    }
  ],
  "forwardedProps": {
    "model": "wand-vega-agent-1.0-pro",
    "scenario_name": "video-mixcut",
    "approval_mode": "never"
  }
}

保存为 request.json 后运行。

bash
curl -N -sS https://smartmedia.vod-qcloud.com/agui/chat \
  -H "Authorization: Bearer $VOD_API_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @request.json

附加 VOD 文件的情况 ​

不使用 URL,而是使用已注册到同一应用的 VOD 文件 ID。

json
{
  "type": "mixcut_assets",
  "metadata": {
    "attachments": [
      {"fileId": "387702300001234567"},
      {"fileId": "387702300001234568"}
    ]
  }
}

特殊配置 ​

将以下条件用自然语言写入 text。

项目指定内容
目的 / 受众视频的目的、观看对象、核心传达内容
结构开头、主体、结尾,以及必须包含的画面
时长自动 / 15 秒 / 20 秒 / 25 秒 / 30 秒 / 60 秒 / 自定义
画面横屏 / 竖屏,横屏素材转竖屏
字幕不插入 / 插入,字体大小与描边
背景音乐无 / 已上传的音乐 / 生成的音乐
原声全部保留 / 去除 BGM 后保留人声 / 去除
旁白用户脚本 / 生成的脚本,TTS 语音

保留原声 ​

text
从访谈素材中挑选介绍产品使用体验的片段,剪辑为 30 秒竖版视频。
保持发言顺序与语义,删去不必要的等待片段。
保留原声,不添加背景音乐。
在画面底部加入韩语字幕。

以旁白为主 ​

text
用产品介绍素材制作 30 秒横版视频。
结构依次为产品介绍、两项主要功能、使用场景。
根据素材中可确认的信息撰写韩语脚本并合成旁白。
去除原声,按旁白排列画面。
加入字幕,不添加背景音乐。

确认剪辑方案后再执行时,请将 approval_mode 指定为 level:high。审批与恢复

基于 VitePress 构建 · 部署于腾讯云 EdgeOne Pages