API Referentie

De VidioClient is het belangrijkste toegangspunt voor interactie met de VIDIO API vanuit Python. Gebruik het om bestanden te uploaden, banen voor het maken van hoogtepunten te creëren, de status van banen te controleren, uitvoer te renderen en te wachten tot de verwerking is voltooid.

API-toegang is momenteel alleen beschikbaar voor Enterprise-plannen. Vraag toegang aan hier als je geen Enterprise-gebruiker bent, maar geïnteresseerd bent in het gebruik van de API.

Het clientmodel

De VidioClient biedt een eenvoudige interface voor het werken met de VIDIO API. Nadat je een client hebt aangemaakt met je API-sleutel, kun je invoerbestanden uploaden, banen voor het maken van hoogtepunten creëren, de status van banen opvragen, uitvoer renderen en wachten tot banen zijn voltooid.

Eigenschappen

api_keystring

Jouw VIDIO API-sleutel die wordt gebruikt om verzoeken te authenticeren.

Methoden

KLASVidioClient(api_key)

Client initialiseren

Maakt een nieuwe VidioClient-instantie aan.

Parameters

api_keystring

Jouw VIDIO API-sleutel.

Returns

Een geconfigureerde VidioClient-instantie.

python

from vidio import VidioClient
import os

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

METHODEclient.upload(file_path)

Bestand uploaden

Uploadt een lokaal bestand naar VIDIO en retourneert een uploadresultaat met de invoersleutel.

Parameters

file_pathstring

Het lokale pad naar het bestand dat je wilt uploaden.

Returns

Een uploadresultaatobject met `input_key`.

python

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

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

Creëer hoogtepunten muur

Maakt een hoogtepuntenbaan aan van een of meer geüploade invoerbestanden.

Parameters

input_keyslist[string]

Een lijst van geüploade bestandsleutels die zijn geretourneerd door upload(). De volgorde van invoersleutels bepaalt de volgorde van media in de uitvoervideo.

video_categorystring

Videocategorie zoals ball-sports. Het kan podcast, ball-sports, non-ball-sports, beauty-product-demo, wedding, travel, others zijn. Voor de beste resultaten, specificeer de categorie die het dichtst aansluit bij jouw inhoud. Als jouw inhoud niet in een categorie past, gebruik dan others.

output_lengthinteger

Gewenste uitvoerlengte in seconden. De uitvoerlengte moet kleiner dan of gelijk aan de totale lengte van alle geüploade video's zijn.

aspect_ratiostring

Uitvoeraspectverhouding zoals landscape, portrait of square.

Returns

Een baanobject met `job_id` en statusinformatie.

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)

METHODEclient.get_job(job_id)

Krijg baan

Haal de huidige status van een baan op.

Parameters

job_idstring

De job-ID die is geretourneerd wanneer de hoogtepuntenbaan werd aangemaakt.

Returns

Een baanobject met de nieuwste status.

python

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

METHODEclient.wait_for_job(job_id)

Wacht op baan

Vraagt de API totdat de hoogtepuntenbaan een voltooide staat bereikt.

Parameters

job_idstring

De job-ID om op te wachten.

Returns

Het definitieve voltooide baanobject.

python

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

METHODEclient.render(job_id)

Render uitvoer

Start met het renderen van een uitvoervideo voor een voltooide hoogtepuntenbaan.

Parameters

job_idstring

De voltooide hoogtepuntenbaan-ID.

Returns

Een renderresultaatobject met renderstatus.

python

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

print(render_result.status)

METHODEclient.wait_for_render(job_id)

Wacht op render

Vraagt totdat de render is voltooid en de uitvoer gereed is.

Parameters

job_idstring

De job-ID die wordt geassocieerd met de render.

Returns

Het definitieve renderresultaatobject.

python

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