Begin met de VIDIO API

Gebruik de VIDIO API om ruwe beelden te uploaden, hoogtepunten te genereren en uiteindelijke video's programmeermatig te renderen.

API-toegang is momenteel beschikbaar voor het Studio-plan en hoger.

Overzicht

De VIDIO API stelt je in staat om automatisch ruwe video om te zetten in hoogtepunten. De workflow is eenvoudig: uploaden → genereren → renderen.

Stel je API-sleutel in

Genereer je API-sleutel op de ontwikkelaarspagina en bewaar deze veilig als een omgevingsvariabele.

$ VIDIO_API_KEY=<je_vidio_api_key_hier>

Installeer FFmpeg

Voor media-upload, installeer FFmpeg om automatische media-detectie mogelijk te maken.

$ brew install ffmpeg

Installeer de Python SDK

De VIDIO API ondersteunt momenteel Python. Installeer de officiële SDK en dotenv om te beginnen.

$ pip install vidio-ai

$ pip install python-dotenv

Maak je eerste hoogtepuntenreel

Als u de API voor andere doeleinden wilt gebruiken dan het maken van highlight-reels, vraag dan toegang hier aan.

Upload een video, creëer een hoogtepuntenreel-taak, wacht op verwerking en render de uiteindelijke output.

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)

Video's samenvoegen

Gebruik cut_method="no-cut" wanneer je clips aan elkaar wilt plakken zonder dat AI deze bijsnijdt. In deze modus is output_length optioneel.

Upload je clips, maak een highlightreel-taak met cut_method="no-cut" om elke clip ongewijzigd te behouden, en render vervolgens de samengevoegde output.

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)