> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/upload-a-vision-event-video.md).

# विज़न इवेंट वीडियो अपलोड करें

अपने कार्यक्षेत्र में एक वीडियो क्लिप अपलोड करें और उसे एक Vision Event से संलग्न करें, ताकि समीक्षक इसे डैशबोर्ड में चला सकें।

## परिचय

एक वीडियो क्लिप दिखाती है कि उस क्षण के आसपास क्या हुआ जब [विज़न इवेंट](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events.md) रिकॉर्ड किया गया था—ऐसी बात जो एक स्थिर छवि में छूट सकती है। आप हर इवेंट में अधिकतम चार क्लिप जोड़ सकते हैं। क्लिप डैशबोर्ड के इवेंट विवरण दृश्य में चलती हैं (देखें [इवेंट का विवरण देखें](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/query-events.md#view-event-details)).

वीडियो MP4 या MOV फ़ाइलें होनी चाहिए और उनका आकार 3 GB तक हो सकता है। इन्हें आपके Workspace पर अपलोड किया जाता है, किसी Project पर नहीं। ब्राउज़र में चलने वाली MP4 फ़ाइलें जैसी हैं वैसी ही संग्रहीत की जाती हैं। अन्य वीडियो को H.264 MP4 में बदला जाता है; बहुत लंबा वीडियो कन्वर्ज़न में विफल हो सकता है।

[एज डिवाइस बैकअप](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/send-events.md#edge-device-backup) डिवाइस पर रिकॉर्ड की गई क्लिप आपके लिए अपलोड करता है। REST API के ज़रिए इवेंट भेजते समय इस पेज के चरणों का उपयोग करें।

## HTTP API

वीडियो जोड़ने के तीन चरण हैं:

1. अपलोड तैयार करें। आपको एक `videoId`एक `signedUrl`और `requiredHeaders`.
2. वीडियो फ़ाइल भेजने के लिए `PUT` अनुरोध का उपयोग करें, `signedUrl`पर, और `requiredHeaders`में दिए गए सभी हेडर के साथ। URL 60 मिनट बाद समाप्त हो जाता है।
3. [इवेंट बनाएँ](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/create-a-vision-event.md#http-api) में `videoId` को `videos[].sourceId`.

इवेंट बनाने से पहले Roboflow द्वारा वीडियो संसाधित किए जाने की प्रतीक्षा करने की ज़रूरत नहीं है। प्रोसेसिंग पूरी होते ही क्लिप डैशबोर्ड में चलने लगती है। प्रोसेसिंग विफल होने पर इवेंट बना रहता है और डैशबोर्ड वीडियो को विफल दिखाता है। अगर फ़ाइल कभी भेजी ही नहीं जाती, तो वीडियो `pending` रहता है और डैशबोर्ड उसे प्रोसेसिंग में दिखाता रहता है।

आवश्यक स्कोप: `vision-events:write` या `device:update` अपलोड तैयार करने के लिए, और `vision-events:read` या `device:read` स्थिति पढ़ने या प्लेबैक URL पाने के लिए।

### अपलोड तैयार करें

{% openapi src="/files/84d8c4861456d267a4e6a39f6a1609041832d8bb" path="/vision-events/videos/prepare-upload" method="post" %}
[openapi.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-0988c6c6c600d725f72d1ecfe0cbeba9b717363f%2Fopenapi.yaml?alt=media)
{% endopenapi %}

इसके बाद फ़ाइल यहाँ भेजें: `signedUrl`। `requiredHeaders` से हर हेडर कॉपी करके अनुरोध में जोड़ें:

```bash
curl -X PUT "SIGNED_URL" \
  -H "x-goog-content-length-range: 1,3221225472" \
  -H "x-goog-if-generation-match: 0" \
  --upload-file line-3-clip.mp4
```

इसके बाद `PUT`के बाद कुछ और करने की ज़रूरत नहीं है। फ़ाइल पहुँचते ही Roboflow वीडियो प्रोसेस करना शुरू कर देता है।

### वीडियो को किसी इवेंट से जोड़ें

इवेंट के `videoId` को `videos` ऐरे में तब रखें, जब आप [Vision Event बनाते हैं](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/create-a-vision-event.md#http-api) या [इवेंट का बैच में निर्माण करते हैं](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/batch-create-vision-events.md).

केवल इस एंडपॉइंट से तैयार किए गए वीडियो ही जोड़े जा सकते हैं। किसी `videoId` को, जो डेटासेट वीडियो अपलोड से या किसी दूसरे वर्कस्पेस से आया हो, इवेंट में रखा जाता है, लेकिन चेतावनी मिलती है और वह चलता नहीं है।

### अपलोड की स्थिति जाँचें

`status` यह `pending` होती है—अपलोड तैयार करने के समय से लेकर Roboflow द्वारा फ़ाइल की प्रोसेसिंग पूरी किए जाने तक—और फिर `uploaded` या `failed`हो जाती है। जिस वीडियो की फ़ाइल कभी पहुँचती ही नहीं, उसकी स्थिति बनी रहती है `pending`.

{% openapi src="/files/84d8c4861456d267a4e6a39f6a1609041832d8bb" path="/vision-events/videos/{videoId}" method="get" %}
[openapi.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-0988c6c6c600d725f72d1ecfe0cbeba9b717363f%2Fopenapi.yaml?alt=media)
{% endopenapi %}

### प्लेबैक URL प्राप्त करें

[क्वेरी के नतीजों में](https://docs.roboflow.com/deployment/hi/monitoring-and-analytics/vision-events/query-events.md#http-api) हर वीडियो का केवल `sourceId` और `label` दिखता है। किसी वीडियो को चलाने या डाउनलोड करने वाला URL पाने के लिए इस एंडपॉइंट को कॉल करें। URL 60 मिनट तक काम करता है और `null` तब तक रहता है, जब तक `status` uploaded `नहीं हो जाता`। URL रखने वाला कोई भी व्यक्ति क्लिप चला सकता है, इसलिए इसे कैश या साझा न करें।

{% openapi src="/files/84d8c4861456d267a4e6a39f6a1609041832d8bb" path="/vision-events/videos/{videoId}/url" method="get" %}
[openapi.yaml](https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-0988c6c6c600d725f72d1ecfe0cbeba9b717363f%2Fopenapi.yaml?alt=media)
{% endopenapi %}
