एपीआई संदर्भ

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)