Referință API

VidioClient este principalul punct de intrare pentru interacțiunea cu API-ul VIDIO din Python. Folosiți-l pentru a încărca fișiere, a crea locuri de muncă pentru clipuri, a verifica starea muncii, a reda ieșiri și a aștepta finalizarea procesării.

Accesul API este disponibil în prezent doar pentru planuri Enterprise. Solicitați acces aici dacă nu sunteți un utilizator Enterprise dar sunteți interesat să folosiți API-ul.

Modelul clientului

VidioClient oferă o interfață simplă pentru a lucra cu API-ul VIDIO. După ce ați creat un client cu cheia dvs. API, puteți încărca fișiere de intrare, crea locuri de muncă pentru clipuri, verifica starea muncii, reda ieșiri și aștepta finalizarea muncilor.

Proprietăți

api_keystring

Cheia dvs. API VIDIO utilizată pentru autentificarea cererilor.

Metode

CLASĂVidioClient(api_key)

Initializează clientul

Creează o nouă instanță VidioClient.

Parameters

api_keystring

Cheia dvs. API VIDIO.

Returns

O instanță VidioClient configurată.

python

from vidio import VidioClient
import os

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

METODĂclient.upload(file_path)

Încarcă fișier

Încarcă un fișier local pe VIDIO și returnează un rezultat de încărcare conținând cheia de intrare.

Parameters

file_pathstring

Calea locală către fișierul pe care doriți să-l încărcați.

Returns

Un obiect rezultat de încărcare conținând `input_key`.

python

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

METODĂclient.create_highlight_reel(input_keys, video_category, output_length, aspect_ratio)

Creează clip

Creează un loc de muncă pentru clip din unul sau mai multe fișiere de intrare încărcate.

Parameters

input_keyslist[string]

O listă de chei ale fișierelor încărcate returnate de upload(). Ordinea cheilor de intrare determină ordinea media în videoclipul de ieșire.

video_categorystring

Categoria videoclipului, cum ar fi sporturi cu minge. Poate fi podcast, sporturi cu minge, sporturi fără minge, demonstrație de produs de frumusețe, nunți, călătorii, altele. Pentru cele mai bune rezultate, specificați categoria care se potrivește cel mai bine cu conținutul dvs. Dacă conținutul dvs. nu se încadrează în nicio categorie, utilizați altele.

output_lengthinteger

Lungimea dorită a ieșirii în secunde. Lungimea ieșirii ar trebui să fie mai mică sau egală cu lungimea totală a tuturor videoclipurilor de intrare combinate.

aspect_ratiostring

Raportul de aspect al ieșirii, cum ar fi peisaj, portret sau pătrat.

Returns

Un obiect de loc de muncă care conține `job_id` și informații despre starea acestuia.

python

job = client.create_highlight_reel(
    input_keys=[result.input_key],
    video_category="sporturi cu minge",
    output_length=30,
    aspect_ratio="peisaj",
)

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

METODĂclient.get_job(job_id)

Obține muncă

Recuperează starea curentă a unei lucrări.

Parameters

job_idstring

ID-ul locului de muncă returnat când a fost creat locul de muncă pentru clip.

Returns

Un obiect de loc de muncă cu cea mai recentă stare.

python

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

METODĂclient.wait_for_job(job_id)

Așteaptă muncă

Polls API-ul până când locul de muncă pentru clip ajunge într-o stare finalizată.

Parameters

job_idstring

ID-ul locului de muncă pentru care așteptați.

Returns

Obiectul final de loc de muncă finalizat.

python

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

METODĂclient.render(job_id)

Redați ieșirea

Începe redarea unui videoclip de ieșire pentru un loc de muncă finalizat pentru clip.

Parameters

job_idstring

ID-ul locului de muncă finalizat pentru clip.

Returns

Un obiect rezultat de redare cu starea redării.

python

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

print(render_result.status)

METODĂclient.wait_for_render(job_id)

Așteptați redarea

Execută polling până când redarea se finalizează și ieșirea este gata.

Parameters

job_idstring

ID-ul locului de muncă asociat cu redarea.

Returns

Obiectul final de rezultat de redare.

python

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