VIDIO API로 시작하기

VIDIO API를 사용하여 원본 영상 파일을 업로드하고, 하이라이트 릴을 생성하며, 최종 비디오를 프로그래밍 방식으로 렌더링하세요.

현재 스튜디오 플랜 및 그 이상에 대해 API 액세스가 가능합니다.

개요

VIDIO API를 사용하면 원본 비디오를 자동으로 하이라이트 릴로 변환할 수 있습니다. 작업 흐름은 간단합니다: 업로드 → 생성 → 렌더링.

API 키 설정

개발자 페이지에서 API 키를 생성하고 환경 변수로 안전하게 저장하세요.

$ VIDIO_API_KEY=<여기에_당신의_vidio_api_key_입력>

FFmpeg 설치

미디어 업로드를 위해 자동 미디어 감지를 활성화하려면 FFmpeg를 설치하세요.

$ brew install ffmpeg

Python SDK 설치

VIDIO API는 현재 Python을 지원합니다. 공식 SDK와 dotenv를 설치하여 시작하세요.

$ pip install vidio-ai

$ pip install python-dotenv

첫 번째 하이라이트 릴 만들기

비디오를 업로드하고, 하이라이트 릴 작업을 생성하고, 처리 대기 후 최종 출력을 렌더링하세요.

from vidio import VidioClient
import os
from dotenv import load_dotenv

load_dotenv()

client = VidioClient(api_key=os.getenv("VIDIO_API_KEY"))

# 1. Upload inputs
u1 = client.upload("clip1.mp4")
u2 = client.upload("clip2.mp4")
u3 = client.upload("cover.jpg")

# 2. Create highlight reel
job = client.create_highlight_reel(
    input_keys=[u1.input_key, u2.input_key, u3.input_key],
    video_category="ball-sports",
    output_length=30,
    aspect_ratio="portrait"
)

# 3. Wait for processing
job = client.wait_for_job(job.job_id)

# 4. Render output
job = client.render(job.job_id)
job = client.wait_for_render(job.job_id)

print(job.output_url)