API Reference

VidioClient є основною точкою входу для взаємодії з VIDIO API з Python. Використовуйте його для завантаження файлів, створення завдань для монтажу, перевірки статусу завдань, рендерингу виходу та очікування завершення обробки.

Доступ до API наразі доступний лише для підприємницьких планів. Запросіть доступ тут, якщо ви не користувач підприємницького плану, але зацікавлені у використанні API.

Модель клієнта

Клас VidioClient надає простий інтерфейс для роботи з VIDIO API. Після створення клієнта з вашим API ключем, ви можете завантажити вхідні файли, створити завдання для монтажу, перевіряти статус завдань, рендерити вихідні дані та очікувати завершення завдань.

Властивості

api_keystring

Ваш VIDIO API ключ, що використовується для автентифікації запитів.

Методи

CLASSVidioClient(api_key)

Ініціалізувати клієнта

Створює новий екземпляр VidioClient.

Parameters

api_keystring

Ваш VIDIO API ключ.

Returns

Конфігурований екземпляр VidioClient.

python

from vidio import VidioClient
import os

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

METHODclient.upload(file_path)

Завантажити файл

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

Parameters

file_pathstring

Локальний шлях до файлу, який ви хочете завантажити.

Returns

Об'єкт результату завантаження, що містить `input_key`.

python

result = client.upload("/path/to/video.mp4")
print(result.input_key)

METHODclient.create_highlight_reel(input_keys, video_category, output_length, aspect_ratio)

Створити завдання для монтажу

Створює завдання для монтажу з одного або кількох завантажених вхідних файлів.

Parameters

input_keyslist[string]

Список ключів завантажених файлів, повернених методом upload(). Порядок ключів вхідних даних визначає порядок медіа у вихідному відео.

video_categorystring

Категорія відео, така як ball-sports. Це може бути podcast, ball-sports, non-ball-sports, beauty-product-demo, wedding, travel, others. Для найкращих результатів вкажіть категорію, яка найбільше відповідає вашому контенту. Якщо ваш контент не підходить жодній категорії, використовуйте others.

output_lengthinteger

Бажана довжина виходу в секундах. Довжина виходу повинна бути меншою або рівною загальній довжині всіх вхідних відео.

aspect_ratiostring

Відношення сторін виходу, таке як landscape, portrait або square.

Returns

Об'єкт завдання, що містить `job_id` та інформацію про статус.

python

job = client.create_highlight_reel(
    input_keys=[result.input_key],
    video_category="ball-sports",
    output_length=30,
    aspect_ratio="landscape",
)

print(job.job_id)
print(job.status)

METHODclient.get_job(job_id)

Отримати завдання

Отримує поточний статус завдання.

Parameters

job_idstring

ID завдання, повернене під час створення завдання для монтажу.

Returns

Об'єкт завдання з останнім статусом.

python

job_status = client.get_job(job.job_id)
print(job_status.status)

METHODclient.wait_for_job(job_id)

Чекати на завдання

Опитує API, поки завдання для монтажу не досягне завершеного стану.

Parameters

job_idstring

ID завдання, на яке потрібно чекати.

Returns

Остаточний завершений об'єкт завдання.

python

final_job = client.wait_for_job(job.job_id)
print(final_job.status)

METHODclient.render(job_id)

Рендерити вихід

Починає рендеринг відео виходу для завершеного завдання для монтажу.

Parameters

job_idstring

ID завершеного завдання для монтажу.

Returns

Об'єкт результату рендерингу зі статусом рендерингу.

python

render_result = client.render(
    job_id=job.job_id
)

print(render_result.status)

METHODclient.wait_for_render(job_id)

Чекати на рендер

Опитує, поки рендер не завершиться і вихід не буде готовий.

Parameters

job_idstring

ID завдання, що пов'язане з рендером.

Returns

Остаточний об'єкт результату рендеру.

python

final_render = client.wait_for_render(job.job_id)
print(final_render.output_url)