Розпочніть роботу з VIDIO API

Використовуйте VIDIO API, щоб завантажити сирі відеоматеріали, згенерувати кращі моменти та програмно вивести фінальні відео.

Доступ до API наразі доступний для плану Studio та вище.

Огляд

VIDIO API дозволяє автоматично перетворювати сире відео на кращі моменти. Процес простий: завантажити → згенерувати → рендерити.

Встановіть свій API ключ

Згенеруйте свій API ключ на сторінці розробників і зберігайте його безпечно як змінну середовища.

$ VIDIO_API_KEY=<your_vidio_api_key_here>

Встановіть FFmpeg

Для завантаження медіа, встановіть FFmpeg, щоб увімкнути автоматичне виявлення медіа.

$ brew install ffmpeg

Встановіть Python SDK

VIDIO API наразі підтримує Python. Встановіть офіційний SDK і dotenv, щоб розпочати роботу.

$ pip install vidio-ai

$ pip install python-dotenv

Створіть свій перший ролик кращих моментів

Якщо ви хочете використовувати API не для створення хайлайт-роликів, будь ласка, запросіть доступ тут.

Завантажте відео, створіть завдання на кращі моменти, дочекайтесь обробки та відрендерите фінальний вихід.

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)

Об'єднати відео

Використовуйте cut_method="no-cut" коли хочете зшити кліпи без обрізання ШІ. У цьому режимі output_length є необов'язковим.

Завантажте свої кліпи, створіть завдання для збірки найкращих моментів з cut_method="no-cut", щоб зберегти кожен кліп без змін, а потім відрендерте зшитий результат.

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)