WAND wiki
최근 문서

검색 결과가 없습니다. 모델명이나 다른 키워드로 검색해 보세요.

Media AI AgentLast Updated 2026-09-30

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.json

VOD 파일을 첨부하는 경우

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로 지정합니다. 승인과 재개