Beginnen Sie mit der VIDIO API

Verwenden Sie die VIDIO API, um Rohmaterial hochzuladen, Highlight-Videos zu erstellen und finalisierte Videos programmatisch zu rendern.

Der API-Zugriff ist derzeit für den Studio-Plan und höher verfügbar.

Überblick

Die VIDIO API ermöglicht es Ihnen, Rohvideos automatisch in Highlight-Videos umzuwandeln. Der Workflow ist einfach: hochladen → generieren → rendern.

API-Schlüssel festlegen

Generieren Sie Ihren API-Schlüssel auf der Entwicklerseite und speichern Sie ihn sicher als Umgebungsvariable.

$ VIDIO_API_KEY=<Ihr_vidio_api_key_hier>

FFmpeg installieren

Für Media-Uploads installieren Sie FFmpeg, um die automatische Medienerkennung zu aktivieren.

$ brew install ffmpeg

Das Python SDK installieren

Die VIDIO API unterstützt derzeit Python. Installieren Sie das offizielle SDK und dotenv, um zu beginnen.

$ pip install vidio-ai

$ pip install python-dotenv

Erstellen Sie Ihr erstes Highlight-Video

Für API-Verwendungszwecke, die nicht der Erstellung von Highlight-Reels dienen, beantragen Sie bitte Zugriff hier.

Laden Sie ein Video hoch, erstellen Sie einen Job für ein Highlight-Video, warten Sie auf die Verarbeitung und rendern Sie die endgültige Ausgabe.

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)

Videos zusammenfügen

Verwende cut_method="no-cut" wenn du Clips ohne KI-Zuschnitt zusammensetzen möchtest. In diesem Modus ist output_length optional.

Lade deine Clips hoch, erstelle einen Highlight-Reel-Job mit cut_method="no-cut", um jeden Clip unverändert zu erhalten, und rendere dann die zusammengefügte Ausgabe.

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)