Inizia a utilizzare l'API VIDIO

Usa l'API VIDIO per caricare filmati grezzi, generare clip di evidenza e renderizzare video finali in modo programmatico.

L'accesso API è attualmente disponibile per il piano Studio e superiori.

Panoramica

L'API VIDIO ti consente di trasformare automaticamente video grezzi in clip di evidenza. Il flusso di lavoro è semplice: carica → genera → renderizza.

Imposta la tua chiave API

Genera la tua chiave API nella pagina degli sviluppatori e conservala in modo sicuro come variabile di ambiente.

$ VIDIO_API_KEY=<tua_chiave_api_vidio_qui>

Installa FFmpeg

Per i caricamenti multimediali, installa FFmpeg per abilitare il rilevamento automatico dei media.

$ brew install ffmpeg

Installa il SDK Python

L'API VIDIO supporta attualmente Python. Installa il SDK ufficiale e dotenv per iniziare.

$ pip install vidio-ai

$ pip install python-dotenv

Crea la tua prima clip di evidenza

Per utilizzi dell'API diversi dalla creazione di montaggi dei momenti salienti, si prega di richiedere l'accesso qui.

Carica un video, crea un lavoro di clip di evidenza, attendi l'elaborazione e renderizza l'output finale.

from vidio import VidioClient
import os
from dotenv import load_dotenv

load_dotenv()

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

# 1. Carica file di input
u1 = client.upload("clip1.mp4")
u2 = client.upload("clip2.mp4")
u3 = client.upload("cover.jpg")

# 2. Crea reel dei momenti salienti
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. Attendi l'elaborazione
job = client.wait_for_job(job.job_id)

# 4. Genera output
job = client.render(job.job_id)
job = client.wait_for_render(job.job_id)

print(job.output_url)

Unire i video

Usa cut_method="no-cut" quando vuoi unire le clip senza ritagli effettuati dall'IA. In questa modalità, output_length è facoltativo.

Carica le tue clip, crea un job per una highlight reel con cut_method="no-cut" per preservare ogni clip così com'è, quindi esegui il rendering dell'output unito.

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)