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

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

하이라이트 릴 생성 이외의 API 사용은 여기에서 액세스를 요청해 주세요.

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

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)

비디오 이어 붙이기

AI가 트리밍하지 않고 클립을 이어 붙이려면 cut_method="no-cut"을 사용하세요. 이 모드에서는 output_length가 선택 사항입니다.

클립을 업로드한 다음, 각 클립을 있는 그대로 보존하려면 cut_method="no-cut"로 하이라이트 릴 작업을 생성한 뒤, 이어 붙인 출력을 렌더링하세요.

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. Stitch videos together
job = client.create_highlight_reel(
    input_keys=[u1.input_key, u2.input_key, u3.input_key],
    aspect_ratio="landscape",
    cut_method="no-cut"
)

# 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)