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 |