Začněte s VIDIO API

Použijte VIDIO API k nahrání surového videa, vygenerování upoutávkových videí a vykreslení konečných videí programově.

API přístup je v současné době k dispozici pro plán Studio a vyšší.

Přehled

VIDIO API vám umožňuje automaticky převádět surové video na upoutávková videa. Pracovní postup je jednoduchý: nahrajte → vygenerujte → vykreslete.

Nastavte svůj API klíč

Vygenerujte svůj API klíč na stránce vývojářů a uložte ho bezpečně jako proměnnou prostředí.

$ VIDIO_API_KEY=<vložte_sem_váš_vidio_api_klíč>

Nainstalujte FFmpeg

Pro nahrávání médií nainstalujte FFmpeg pro povolení automatické detekce médií.

$ brew install ffmpeg

Nainstalujte Python SDK

VIDIO API aktuálně podporuje Python. Nainstalujte oficiální SDK a dotenv, abyste mohli začít.

$ pip install vidio-ai

$ pip install python-dotenv

Vytvořte svou první upoutávku

Pro použití API jiného než pro vytváření sestřihů požádejte o přístup zde.

Nahrajte video, vytvořte úkol na upoutávku, čekejte na zpracování a vykreslete konečný výstup.

from vidio import VidioClient
import os
from dotenv import load_dotenv

load_dotenv()

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

# 1. Nahrát vstupy
u1 = client.upload("clip1.mp4")
u2 = client.upload("clip2.mp4")
u3 = client.upload("cover.jpg")

# 2. Vytvořit sestřih
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. Počkat na zpracování
job = client.wait_for_job(job.job_id)

# 4. Vykreslit výstup
job = client.render(job.job_id)
job = client.wait_for_render(job.job_id)

print(job.output_url)