Comece a usar a API VIDIO

Use a API VIDIO para fazer upload de imagens brutas, gerar vídeos destacados e renderizar vídeos finais programaticamente.

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

Visão Geral

A API VIDIO permite que você converta automaticamente vídeo bruto em vídeos destacados. O fluxo de trabalho é simples: fazer upload → 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 uploads de mídia, instale o FFmpeg para habilitar a detecção automática de mídia.

$ brew install ffmpeg

Instale o SDK Python

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

$ pip install vidio-ai

$ pip install python-dotenv

Crie seu primeiro vídeo destacado

Para usos da API que não sejam a criação de reels de destaque, por favor solicite acesso aqui.

Faça upload de um vídeo, crie um trabalho de vídeo destacado, 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. Fazer upload das entradas
u1 = client.upload("clip1.mp4")
u2 = client.upload("clip2.mp4")
u3 = client.upload("cover.jpg")

# 2. Criar montagem de melhores momentos
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. Aguardar processamento
job = client.wait_for_job(job.job_id)

# 4. Renderizar saída
job = client.render(job.job_id)
job = client.wait_for_render(job.job_id)

print(job.output_url)

Unir vídeos

Utilize cut_method="no-cut" quando quiser juntar clipes sem cortes automáticos da IA. Nesse modo, output_length é opcional.

Envie seus clipes, crie um trabalho de destaque (highlight reel) com cut_method="no-cut" para preservar cada clipe como está, e em seguida renderize 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)