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 de manière programmatique.

L'accès à l'API est actuellement disponible pour le plan Studio et au-dessus.

Aperçu

L'API VIDIO vous permet de transformer 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 stockez-la en toute sécurité en tant que variable d'environnement.

$ VIDIO_API_KEY=<votre_clé_api_vidio_ici>

Installez FFmpeg

Pour les téléchargements de mé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 utilisations 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 emploi de bande-annonce, attendez le traitement et rendez le résultat final.

from vidio import VidioClient
import os
from dotenv import load_dotenv

load_dotenv()

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

# 1. Télécharger les entrées
u1 = client.upload("clip1.mp4")
u2 = client.upload("clip2.mp4")
u3 = client.upload("cover.jpg")

# 2. Créer une compilation des meilleurs moments
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. Attendre le traitement
job = client.wait_for_job(job.job_id)

# 4. Générer la sortie
job = client.render(job.job_id)
job = client.wait_for_render(job.job_id)

print(job.output_url)

Assembler des clips

Utilisez cut_method="no-cut" lorsque vous souhaitez assembler les clips sans découpe par l'IA. Dans ce mode, output_length est facultatif.

Téléversez vos clips, créez un job de highlight reel avec cut_method="no-cut" pour préserver chaque clip 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)