Media AI Agent Quick Start

영상 파일과 편집 지시를 전달하면 Vega Agent가 구간 편집, 자막 처리와 렌더링을 수행합니다. 아래 예제는 영상 A → 영상 B를 이어 붙이는 작업입니다.

1. 입력 영상과 결과

두 영상은 Vega Pro 생성 영상에서 각각 분리한 3초 소재입니다.

영상 A / 사탕 마을 / 3초

영상 B / 인물 클로즈업 / 3초

제작 지시

영상 A 전체 3초 다음에 영상 B 전체 3초를 연결하세요.
원본 음성을 유지하고 별도의 음악이나 나레이션은 추가하지 마세요.
A에는 '달콤한 세상', B에는 '오늘의 주인공' 자막을 넣으세요.
완성 영상은 6초, 가로형 1920×1080입니다.

편집 결과 / A 0–3초 → B 3–6초

영상 A 다운로드 / 영상 B 다운로드 / 완성 영상 다운로드

2. 영상을 요청에 첨부하기

영상 주소는 mixcut_assets의 metadata.attachments 배열에 넣습니다. 두 개를 사용할 때는 항목 두 개를 추가하고, 편집 순서는 제작 지시에 명시합니다.

{
  "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에 설정합니다. 키 발급 방법

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