Comece com a VIDIO API

Use a VIDIO API para carregar filmagens brutas, gerar compilações e renderizar vídeos finais programaticamente.

O acesso à API está atualmente disponível para o plano Studio e superior.

Visão Geral

A VIDIO API permite que você transforme automaticamente vídeos brutos em compilações. O fluxo de trabalho é simples: carregar → gerar → renderizar.

Defina sua chave da API

Gere sua chave da API na página de desenvolvedores e armazene-a com segurança como uma variável de ambiente.

$ VIDIO_API_KEY=<sua_chave_api_vidio_aqui>

Instale o FFmpeg

Para carregamentos de mídia, instale o FFmpeg para ativar a deteção automática de mídia.

$ brew install ffmpeg

Instale o SDK Python

A VIDIO API atualmente suporta Python. Instale o SDK oficial e o dotenv para começar.

$ pip install vidio-ai

$ pip install python-dotenv

Crie sua primeira compilação

Para utilizações da API que não sejam a criação de destaques, por favor, solicite acesso aqui.

Carregue um vídeo, crie um trabalho de compilação, aguarde o processamento e renderize a saída 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 vídeos

Use cut_method="no-cut" quando quiser juntar clipes sem cortes efetuados pela IA. Neste modo, output_length é opcional.

Envie os seus clipes, crie um trabalho de montagem de destaques com cut_method="no-cut" para preservar cada clipe tal como está e depois gere a saída 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)