API Referencer

VidioClient er hovedindgangspunktet for interaktion med VIDIO API fra Python. Brug det til at uploade filer, oprette highlight reel jobs, tjekke jobstatus, gengive output og vente på, at behandlingen er færdig.

API-adgang er i øjeblikket kun tilgængelig for Enterprise planer. Anmod om adgang her, hvis du ikke er en Enterprise bruger, men er interesseret i at bruge API'en.

Klientmodellen

VidioClient giver et simpelt interface til at arbejde med VIDIO API. Efter at have oprettet en klient med din API-nøgle, kan du uploade inputfiler, oprette highlight reel jobs, spørge jobstatus, gengive output og vente på, at jobberne er færdige.

Egenskaber

api_keystring

Din VIDIO API-nøgle, der bruges til at godkende anmodninger.

Metoder

KLASSEVidioClient(api_key)

Initialiser klient

Opretter en ny VidioClient-forekomst.

Parameters

api_keystring

Din VIDIO API-nøgle.

Returns

En konfigureret VidioClient-forekomst.

python

from vidio import VidioClient
import os

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

METODEclient.upload(file_path)

Upload fil

Uploader en lokal fil til VIDIO og returnerer et upload-resultat, der indeholder inputnøglen.

Parameters

file_pathstring

Den lokale sti til den fil, du vil uploade.

Returns

Et uploadresultat objekt, der indeholder `input_key`.

python

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

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

Opret highlight reel

Opretter et highlight reel job fra en eller flere uploadede inputfiler.

Parameters

input_keyslist[string]

En liste over uploadede filnøgler, der returneres af upload(). Rækkefølgen af inputnøgler bestemmer rækkefølgen af medier i outputvideoen.

video_categorystring

Videokategori som f.eks. bold-sport. Det kan være podcast, bold-sport, ikke-bold-sport, skønhedsprodukt-demo, bryllup, rejse, andre. For de bedste resultater, angiv den kategori, der bedst matcher dit indhold. Hvis dit indhold ikke passer ind i nogen kategori, brug andre.

output_lengthinteger

Ønsket outputlængde i sekunder. Outputlængden skal være mindre end eller lig med den samlede længde af alle inputvideoer tilsammen.

aspect_ratiostring

Output aspektforhold som f.eks. landskab, portræt eller kvadrat.

Returns

Et jobobjekt, der indeholder `job_id` og statusinformation.

python

job = client.create_highlight_reel(
    input_keys=[result.input_key],
    video_category="bold-sport",
    output_length=30,
    aspect_ratio="landskab",
)

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

METODEclient.get_job(job_id)

Hent job

Henter den nuværende status for et job.

Parameters

job_idstring

Job-ID'en, der returneres, når highlight reel job blev oprettet.

Returns

Et jobobjekt med den nyeste status.

python

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

METODEclient.wait_for_job(job_id)

Vent på job

Spørger API'et, indtil highlight reel job når en afsluttet tilstand.

Parameters

job_idstring

Job-ID'en at vente på.

Returns

Det endelige afsluttede jobobjekt.

python

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

METODEclient.render(job_id)

Gengiv output

Starter gengivelsen af en outputvideo for et afsluttet highlight reel job.

Parameters

job_idstring

Det afsluttede highlight reel job-ID.

Returns

Et gengivelsesresultat objekt med gengivelsesstatus.

python

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

print(render_result.status)

METODEclient.wait_for_render(job_id)

Vent på gengivelse

Spørger indtil gengivelsen er færdig og outputtet er klar.

Parameters

job_idstring

Job-ID'en knyttet til gengivelsen.

Returns

Det endelige gengivelsesresultat objekt.

python

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