Vega Agent
Endpoint: https://smartmedia.vod-qcloud.com/agui认证: VOD ApiToken / Bearer
按所选顺序与条件剪辑视频素材,并执行字幕·语音处理与渲染。如果是首次调用,请先运行 两个视频连接示例。
基本信息
| 项目 | 取值 |
|---|---|
| 请求 | POST /agui/chat |
| 场景 | video-mixcut |
| 输入 | 制作指令 + 视频 URL / VOD fileId |
| 结果 | 剪辑后的视频 / 文本与工具执行事件 |
各版本支持规范
| 版本 | 模型 ID |
|---|---|
1.1 Max | wand-vega-agent-1.1-max |
1.0 Max | wand-vega-agent-1.0-max |
1.0 Pro | wand-vega-agent-1.0-pro |
1.5 Standard | wand-vega-agent-1.5-standard |
1.0 Standard | wand-vega-agent-1.0-standard |
1.0 Lite | wand-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 | 必填 | String | video-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。审批与恢复