跳到内容

Media AI Agent 快速入门 ​

更新时间

传入视频文件与制作指令后,Vega Agent 会执行片段剪辑、字幕处理与渲染。下面的示例是将视频 A → 视频 B 拼接在一起的任务。

1. 输入视频与结果 ​

两段视频是从 Vega Pro 生成的视频中分别分离出来的 3 秒 素材。

视频 A / 糖果村庄 / 3 秒

视频 B / 人物特写 / 3 秒

制作指令

text
在视频 A 完整 3 秒之后连接视频 B 的完整 3 秒。
保留原声,不添加额外的音乐或旁白。
在 A 中加入字幕 '甜蜜的世界',在 B 中加入字幕 '今天的主角'。
成片为 6 秒,横版 1920×1080。

剪辑结果 / A 0–3 秒 → B 3–6 秒

视频 A 下载 / 视频 B 下载 / 成片下载

2. 将视频附加到请求 ​

视频地址放在 mixcut_assets 的 metadata.attachments 数组中。使用两个视频时添加两个条目,剪辑顺序在制作指令中说明。

json
{
  "type": "mixcut_assets",
  "metadata": {
    "attachments": [
      {"url": ""},
      {"url": ""}
    ]
  }
}
已有素材传递方式
可访问的视频 URL{"url":"视频地址"}
已注册到 VOD 的视频{"fileId":"VOD 文件 ID"} / 与 API 密钥属于同一应用的文件
PC 上的视频文件先上传到 COS 或 VOD,再传递 URL 或 fileId

一个条目中只能放入 url 或 fileId 中的一个。即使把 PC 文件路径填入 url,文件也不会被上传。

3. 运行示例 ​

使用目标 VOD 应用的 SubAppId 签发 API 密钥,并配置到 VOD_API_TOKEN 中。密钥获取方法

bash
export VOD_API_TOKEN='签发的 ApiToken'
curl -fsS  -o agent-join-example.sh
bash agent-join-example.sh

运行脚本会附加上述两个视频,并每次使用新的对话·执行 ID 发起请求。完整请求 JSON 中可以查看提示词与附加位置。

4. 查看结果 ​

运行过程中会依次输出回复与任务状态。打开最终消息与渲染工具结果中包含的视频 URL 即可查看结果。

后续操作文档
用自己的视频进行剪辑 / 字幕 / 语音配置Video → Vega Agent
从服务接收结果 / 恢复历史记录 / 取消API Reference
在视频库中检索与提问Media Understanding → Vega Agent

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