Comienza con la VIDIO API

Usa la VIDIO API para subir metraje en bruto, generar reels de destacados y renderizar videos finales programáticamente.

El acceso a la API está actualmente disponible para el plan Studio y superior.

Descripción general

La VIDIO API te permite convertir automáticamente video en bruto en reels de destacados. El flujo de trabajo es simple: subir → generar → renderizar.

Configura tu clave de API

Genera tu clave de API en la página de desarrolladores y guárdala de forma segura como una variable de entorno.

$ VIDIO_API_KEY=<tu_clave_de_api_vidio_aqui>

Instala FFmpeg

Para cargas de media, instala FFmpeg para habilitar la detección automática de media.

$ brew install ffmpeg

Instala el SDK de Python

La VIDIO API actualmente soporta Python. Instala el SDK oficial y dotenv para comenzar.

$ pip install vidio-ai

$ pip install python-dotenv

Crea tu primer reel de destacados

Para usos de la API distintos a la creación de videos destacados, por favor solicite acceso aquí.

Sube un video, crea un trabajo de reel de destacados, espera el procesamiento y renderiza la salida final.

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)

Unir videos

Usa cut_method="no-cut" cuando quieras unir clips sin recorte por IA. En este modo, output_length es opcional.

Sube tus clips, crea un trabajo de reel de destacados con cut_method="no-cut" para preservar cada clip tal cual, y luego renderiza la salida unida.

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)