Aloita VIDIO API:n käyttö

Käytä VIDIO API:ta ladataksesi raakakuvamateriaalia, luodaksesi kohokohtavideoita ja renderöidäksesi lopullisia videoita ohjelmallisesti.

API-käyttö on tällä hetkellä saatavilla Studio-suunnitelmalle ja korkeammille.

Yhteenveto

VIDIO API mahdollistaa raakavideon automaattisen muuntamisen kohokohtavideoiksi. Työnkulku on yksinkertainen: ladata → luoda → renderöidä.

Aseta API-avain

Luo API-avain kehittäjäsivulta ja tallenna se turvallisesti ympäristömuuttujana.

$ VIDIO_API_KEY=<your_vidio_api_key_here>

Asenna FFmpeg

Mediatiedostojen lataamista varten asenna FFmpeg, jotta automaattinen mediantunnistus on mahdollista.

$ brew install ffmpeg

Asenna Python SDK

VIDIO API tukee tällä hetkellä Pythonia. Asenna virallinen SDK ja dotenv aloittaaksesi.

$ pip install vidio-ai

$ pip install python-dotenv

Luo ensimmäinen kohokohtavideo

Jos API:ta käytetään muuhun kuin kohokohtakoosteen luomiseen, pyydä pääsyä täältä.

Lataa video, luo kohokohtavideotöitä, odota käsittelyä ja renderöi lopullinen tulos.

from vidio import VidioClient
import os
from dotenv import load_dotenv

load_dotenv()

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

# 1. Lataa syötteet
u1 = client.upload("clip1.mp4")
u2 = client.upload("clip2.mp4")
u3 = client.upload("cover.jpg")

# 2. Luo kohokohtakooste
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. Odota käsittelyä
job = client.wait_for_job(job.job_id)

# 4. Renderöi ulostulo
job = client.render(job.job_id)
job = client.wait_for_render(job.job_id)

print(job.output_url)

Liitä videot yhteen

Käytä cut_method="no-cut", kun haluat liittää klipit yhteen ilman tekoälyn leikkausta. Tässä tilassa output_length on valinnainen.

Lataa klippisi, luo kohokooste-työ käyttämällä cut_method="no-cut" säilyttääksesi jokaisen klipin sellaisenaan, ja renderöi sitten yhdistetty tulos.

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)