Vega Agent โ
Endpoint: https://smartmedia.vod-qcloud.com/aguiAuthentication: VOD ApiToken / Bearer
It edits video assets in the selected order and conditions, and performs subtitle and voice processing plus rendering. If this is your first call, run the two-video concatenation example first.
Basic Information โ
| Item | Value |
|---|---|
| Request | POST /agui/chat |
| Scenario | video-mixcut |
| Input | Production instructions + video URL / VOD fileId |
| Result | Edited video / text and tool execution events |
Supported Specifications by Version โ
| Version | Model 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 |
Production Modes โ
| Mode | Original Audio | Script / Voice | Use Case |
|---|---|---|---|
Original Audio | Keep all / Remove BGM and keep vocals | Use the original audio | Interviews, reviews, live highlights |
Narration | Remove | User script / AI script + TTS | Product descriptions, explainers, introduction videos |
Request Parameters โ
| Parameter | Required | Type | Description |
|---|---|---|---|
messages.content | Required | Array | Production instructions and asset list |
content.type | Required | String | text for instructions, mixcut_assets for assets |
content.text | Conditionally required | String | Editing conditions such as order, length, and subtitles |
content.metadata.attachments | Conditionally required | Array | url or fileId for each asset |
forwardedProps.model | Optional | String | Model ID in the table above |
forwardedProps.scenario_name | Required | String | video-mixcut |
Authentication, run ID, and approval configuration follow API Reference.
Request Example โ
This is the request used in input videos A and B and the final video.
json
{
"threadId": "thread-001",
"runId": "run-001",
"messages": [
{
"role": "user",
"content": [
{
"type": "text",
"text": "Concatenate the attached videos A and B in order to produce a 6-second landscape video. Place the full 3 seconds of B after the full 3 seconds of A and connect them directly with no transition effect. Keep the original audio of each video and do not add separate music or narration. Add \"Sweet World\" to segment A and \"Today's Star\" to segment B as centered subtitles at the bottom of the screen. Set the subtitles to Noto Sans KR, white 96px, black outline 4px. Render at 1920x1080 and return the finished video URL."
},
{
"type": "mixcut_assets",
"metadata": {
"attachments": [
{
"url": ""
},
{
"url": ""
}
]
}
}
]
}
],
"forwardedProps": {
"model": "wand-vega-agent-1.0-pro",
"scenario_name": "video-mixcut",
"approval_mode": "never"
}
}Save it as request.json and then run it.
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.jsonAttaching a VOD File โ
Instead of a URL, use the VOD file ID registered in the same application.
json
{
"type": "mixcut_assets",
"metadata": {
"attachments": [
{"fileId": "387702300001234567"},
{"fileId": "387702300001234568"}
]
}
}Special Settings โ
Write the following conditions in natural language in text.
| Item | What to Specify |
|---|---|
| Purpose / Audience | Purpose of the video, target viewers, key message |
| Structure | Intro, body, outro, and scenes that must be included |
| Length | Auto / 15 seconds / 20 seconds / 25 seconds / 30 seconds / 60 seconds / Custom |
| Screen | Landscape / portrait, converting landscape assets to portrait |
| Subtitles | Not inserted / inserted, font size and outline |
| Background music | None / uploaded music / generated music |
| Original audio | Keep all / Remove BGM and keep vocals / Remove |
| Narration | User script / generated script, TTS voice |
Keeping the Original Audio โ
text
Select the segments from the interview footage that describe the product usage experience and edit them into a 30-second vertical video.
Preserve the speaking order and meaning, and remove unnecessary pause segments.
Keep the original audio and do not add background music.
Add Korean subtitles at the bottom of the screen.Narration-Focused โ
text
Produce a 30-second landscape video from the product introduction footage.
The structure is product introduction, two key features, then usage scenes.
Write a Korean script from the information confirmed in the footage and synthesize narration.
Remove the original audio and arrange the scenes to match the narration.
Add subtitles and do not add background music.To run after reviewing the edit plan, set approval_mode to level:high. Approval and Resume