开始使用 VIDIO API

使用 VIDIO API 上传原始视频，生成精彩集锦，并以编程方式渲染最终视频。

当前可用于Studio计划及以上的API访问。

概述

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)