VIDIO API を使って始める

VIDIO API を使用して生の映像をアップロードし、ハイライトリールを生成し、最終的なビデオをプログラムでレンダリングします。

APIアクセスは現在、Studioプラン以上で利用可能です。

概要

VIDIO API を使用すると、生のビデオを自動的にハイライトリールに変換できます。ワークフローはシンプルです：アップロード → 生成 → レンダリング。

API キーを設定する

開発者ページで API キーを生成し、環境変数として安全に保存します。

$ VIDIO_API_KEY=<your_vidio_api_key_here>

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)