Vega Agent
On this page
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 및 완성본에 사용한 요청입니다.
LANGUAGE
{
"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": "https://wand.tencentpoc.com/api/media/agent-scene-a-20260928.mp4"
},
{
"url": "https://wand.tencentpoc.com/api/media/agent-scene-b-20260928.mp4"
}
]
}
}
]
}
],
"forwardedProps": {
"model": "wand-vega-agent-1.0-pro",
"scenario_name": "video-mixcut",
"approval_mode": "never"
}
}request.json으로 저장한 뒤 실행합니다.
LANGUAGE
curl -N -sS https://smartmedia.vod-qcloud.com/agui/chat \
-H "Authorization: Bearer $VOD_API_TOKEN" \
-H "Content-Type: application/json" \
--data-binary @request.jsonVOD 파일을 첨부하는 경우
URL 대신 같은 애플리케이션에 등록된 VOD 파일 ID를 사용합니다.
LANGUAGE
{
"type": "mixcut_assets",
"metadata": {
"attachments": [
{"fileId": "387702300001234567"},
{"fileId": "387702300001234568"}
]
}
}특수 설정
다음 조건을 text에 자연어로 작성합니다.
| 항목 | 지정 내용 |
|---|---|
| 목적 / 대상 | 영상의 목적, 시청 대상, 핵심 전달 내용 |
| 구성 | 도입부, 본문, 마무리, 반드시 포함할 장면 |
| 길이 | 자동 / 15초 / 20초 / 25초 / 30초 / 60초 / 사용자 지정 |
| 화면 | 가로형 / 세로형, 가로 소재의 세로형 변환 |
| 자막 | 미삽입 / 삽입, 글자 크기와 외곽선 |
| 배경음악 | 없음 / 업로드한 음악 / 생성 음악 |
| 원본 음성 | 전체 유지 / BGM 제거 후 보컬 유지 / 제거 |
| 나레이션 | 사용자 대본 / 생성 대본, TTS 음성 |
원본 음성 유지
LANGUAGE
인터뷰 소재에서 제품 사용 경험을 설명하는 구간을 골라 30초 세로형 영상으로 편집하세요.
발화 순서와 의미를 유지하고 불필요한 대기 구간을 제거하세요.
원본 음성을 유지하고 배경음악은 추가하지 마세요.
한국어 자막을 화면 하단에 넣으세요.나레이션 중심
LANGUAGE
제품 소개 소재로 30초 가로형 영상을 제작하세요.
구성은 제품 소개, 주요 기능 두 가지, 사용 장면 순서입니다.
소재에서 확인되는 정보로 한국어 대본을 작성하고 나레이션을 합성하세요.
원본 음성은 제거하고 나레이션에 맞춰 장면을 배치하세요.
자막을 넣고 배경음악은 추가하지 마세요.편집안을 확인한 뒤 실행하려면 approval_mode를 level:high로 지정합니다. 승인과 재개
