Commencez avec l'API VIDIO

Utilisez l'API VIDIO pour télécharger des séquences brutes, générer des bandes-annonces et rendre des vidéos finales par programmation.

L'accès API est actuellement disponible pour le plan Studio et plus.

Aperçu

L'API VIDIO vous permet de convertir automatiquement des vidéos brutes en bandes-annonces. Le flux de travail est simple : télécharger → générer → rendre.

Définissez votre clé API

Générez votre clé API dans la page des développeurs et conservez-la en sécurité en tant que variable d'environnement.

$ VIDIO_API_KEY=<votre_clé_api_vidio_ici>

Installez FFmpeg

Pour les téléchargements multimédias, installez FFmpeg pour activer la détection automatique des médias.

$ brew install ffmpeg

Installez le SDK Python

L'API VIDIO prend actuellement en charge Python. Installez le SDK officiel et dotenv pour commencer.

$ pip install vidio-ai

$ pip install python-dotenv

Créez votre première bande-annonce

Pour les usages de l'API autres que la création de montages de moments forts, veuillez demander l'accès ici.

Téléchargez une vidéo, créez un travail de bande-annonce, attendez le traitement et rendez la sortie finale.

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)

Assembler des vidéos

Utilisez cut_method="no-cut" lorsque vous voulez assembler des extraits sans coupe par l'IA. Dans ce mode, output_length est facultatif.

Téléversez vos extraits, créez une tâche de montage de moments forts avec cut_method="no-cut" pour préserver chaque extrait tel quel, puis générez la sortie assemblée.

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)