> 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/send-events.md).

# इवेंट्स भेजें

अपने डिप्लॉय किए गए models से Vision Events भेजने के तीन तरीके।

## ईवेंट भेजें

आप Vision Events को Workflow block, REST API, या edge device backup का उपयोग करके भेज सकते हैं.

* [वर्कफ़्लो ब्लॉक](#workflow-block) - वर्कफ़्लो उपयोगकर्ताओं को संभवतः आधिकारिक Roboflow block का उपयोग करना सबसे आसान लगेगा
* [REST API](#rest-api) - जो उपयोगकर्ता मॉडल्स को वर्कफ़्लोज़ के बाहर डिप्लॉय करना चुनते हैं, वे हमारे REST API का उपयोग कर सकते हैं
* [एज डिवाइस बैकअप](#edge-device-backup) - Roboflow Edge डिवाइस डिप्लॉय करने वाले उपयोगकर्ताओं को डिवाइस पर स्थानीय event store से स्वचालित बैकअप कॉन्फ़िगर करना सबसे सुविधाजनक लगेगा

### वर्कफ़्लो ब्लॉक

अधिकांश उपयोगकर्ताओं के लिए अनुशंसित तरीका। जोड़ें **विजन इवेंट** ब्लॉक को किसी भी Roboflow Workflow में जोड़ें ताकि inference results से बिना किसी कोड की आवश्यकता के स्वचालित रूप से events बनाए जा सकें.

{% hint style="info" %}
The [Roboflow Agent](https://docs.roboflow.com/agents/roboflow-agent) आपके लिए यह सेट अप कर सकता है। जब आप Agent से ऐसा Workflow बनाने के लिए कहते हैं जो एक मॉडल चलाता है, तो वह स्वचालित रूप से एक Vision Events block जोड़ देता है और उसे सही [उपयोग मामला](/deployment/hi/monitoring-and-analytics/vision-events/use-cases.md).
{% endhint %}

#### सेटअप

{% stepper %}
{% step %}
**वर्कफ़्लो एडिटर खोलें**

पर नेविगेट करें **वर्कफ़्लोज़** अपनी workspace में और उस workflow को खोलें जिसमें आप events जोड़ना चाहते हैं.
{% endstep %}

{% step %}
**Vision Event Block जोड़ें**

block catalog में "Vision Event" खोजें और इसे अपने workflow में जोड़ें.
{% endstep %}

{% step %}
**इनपुट्स कनेक्ट करें**

इमेज input और model prediction outputs को Vision Event block से कनेक्ट करें.
{% endstep %}

{% step %}
**Use Case कॉन्फ़िगर करें**

Use Case का नाम सेट करें (`useCaseId`). आप upstream blocks से custom metadata भी मैप कर सकते हैं। एक बार Use Case चुन लेने के बाद, नीचे dropdown में "Open in Vision Events" पर क्लिक करें ताकि नए tab में उस Use Case के events page पर जा सकें.
{% endstep %}

{% step %}
**वर्कफ़्लो डिप्लॉय करें**

अपने workflow को डिप्लॉय या अपडेट करें। जब भी workflow चलता है, events स्वचालित रूप से बनाए जाते हैं.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Workflow block इमेज upload और event creation को एक ही चरण में संभालता है। यह केवल images संलग्न करता है। video clips संलग्न करने के लिए, [REST API](#attach-a-video) या [एज डिवाइस बैकअप](#edge-device-backup).
{% endhint %}

### REST API

जो custom integrations या pipelines Workflows का उपयोग नहीं करती हैं, उनके लिए आप REST API के माध्यम से सीधे events भेज सकते हैं। पूर्ण request और response schemas के लिए, देखें [Vision Events API Reference](/deployment/hi/monitoring-and-analytics/vision-events.md#http-api).

#### प्रमाणीकरण

सभी write endpoints के लिए एक API key आवश्यक है जिसमें `visionEvents.write` या `device.update` scope हो। API key को Bearer token के रूप में पास करें:

```
Authorization: Bearer YOUR_API_KEY
```

#### एंड-टू-एंड उदाहरण: इमेज अपलोड करें + इवेंट बनाएं

{% hint style="warning" %}
इवेंट भेजने से पहले आपको एक Use Case बनाना होगा। किसी ऐसे `useCaseId` का संदर्भ देने वाले events जो मौजूद नहीं हैं, उन्हें अस्वीकार कर दिया जाएगा.
{% endhint %}

API के माध्यम से events भेजते समय, पहले आप इमेज अपलोड करते हैं, फिर अपलोड की गई इमेज का संदर्भ देते हुए event बनाते हैं.

**चरण 1: इमेज अपलोड करें**

```bash
curl -X POST "https://api.roboflow.com/vision-events/upload" \\
  -H "Authorization: Bearer YOUR_API_KEY" \\
  -F "file=@inspection_photo.jpg"
```

**प्रतिक्रिया:**

```json
{
  "success": true,
  "sourceId": "abc123def456",
  "url": "https://storage.googleapis.com/your-workspace/abc123def456/original.jpg"
}
```

**चरण 2: अपलोड की गई इमेज का संदर्भ देते हुए event बनाएं**

```bash
curl -X POST "https://api.roboflow.com/vision-events" \\
  -H "Content-Type: application/json" \\
  -H "Authorization: Bearer YOUR_API_KEY" \\
  -d '{
    "eventType": "quality_check",
    "useCaseId": "assembly-line-qa",
    "timestamp": "2026-03-30T14:30:00.000Z",
    "deviceId": "factory-cam-01",
    "streamId": "line-3",
    "images": [
      {
        "sourceId": "abc123def456",
        "objectDetections": [
          {
            "class": "defect",
            "x": 320,
            "y": 240,
            "width": 50,
            "height": 40,
            "confidence": 0.95
          }
        ]
      }
    ],
    "eventData": {
      "result": "fail"
    },
    "customMetadata": {
      "line_id": "line-3",
      "shift": "morning",
      "part_number": "PN-4421"
    }
  }'
```

**प्रतिक्रिया:**

```json
{
  "eventId": "evt-789ghi",
  "created": true
}
```

#### वीडियो संलग्न करें

Video clips एक form upload के बजाय signed upload का उपयोग करते हैं, क्योंकि clips 3 GB तक हो सकते हैं। upload तैयार करें ताकि आपको `videoId`, `PUT` फ़ाइल को लौटाए गए URL पर, फिर `videoId` को event के `videos` array में जोड़ें:

```json
"videos": [
  { "sourceId": "Kq4vX8mNp2RtY6wZ1bCd", "label": "line-3 camera" }
]
```

देखें [Vision Event का वीडियो अपलोड करें](/deployment/hi/monitoring-and-analytics/vision-events/upload-a-vision-event-video.md) प्रत्येक चरण के लिए.

#### बैच में इवेंट बनाएं

batch endpoint का उपयोग करके एक ही request में अधिकतम 100 events भेजें:

```bash
curl -X POST "https://api.roboflow.com/vision-events/batch" \\
  -H "Content-Type: application/json" \\
  -H "Authorization: Bearer YOUR_API_KEY" \\
  -d '{
    "events": [
      {
        "eventType": "quality_check",
        "useCaseId": "alksjdflaalsf32",
        "eventData": { "result": "pass" },
        "customMetadata": { "line_id": "line-1" }
      },
      {
        "eventType": "quality_check",
        "useCaseId": "alksjdflaalsf32",
        "eventData": { "result": "fail" },
        "customMetadata": { "line_id": "line-2" }
      }
    ]
  }'
```

{% hint style="info" %}
प्रति batch request अधिकतम 100 events.
{% endhint %}

### एज डिवाइस बैकअप

ऐसे enterprise deployments के लिए जहाँ connectivity बीच-बीच में बाधित हो सकती है, edge device events को स्थानीय रूप से संग्रहीत करता है और connectivity बहाल होने पर उन्हें Roboflow से sync करता है.

{% hint style="info" %}
Edge Device Backup के लिए Deployment Manager आवश्यक है। देखें [Deployment Manager documentation](/deployment/hi/self-hosted/enterprise/deployment-manager.md) सेटअप निर्देशों के लिए.
{% endhint %}

Vision Events backup सक्षम करने के लिए:

1. खोलें **Deployment Manager** अपनी workspace में
2. कॉन्फ़िगर करने के लिए device चुनें
3. सक्षम करें **Vision Events Backup** device के [Event Store](/deployment/hi/self-hosted/enterprise/deployment-manager/services/event-store.md) configuration में
4. Events को device पर स्थानीय event store में लिखा जाता है
5. जब device फिर से कनेक्ट होता है, तो events स्वचालित रूप से Roboflow से sync हो जाते हैं

Sync पूरा होने के बाद events Vision Events dashboard में दिखाई देते हैं.

जब "Backup Mode" "Records and Files" होता है, तो device पर events से जुड़े video clips भी upload होते हैं, ताकि वे dashboard में चल सकें। MP4 और MOV clips upload होते हैं, प्रति event अधिकतम चार तक। अन्य formats device पर ही रहती हैं। जो clip upload होने में विफल रहता है, वह हर retry पर उसके event को लगभग एक घंटे तक विलंबित करता है। बार-बार विफल होने पर (डिफ़ॉल्ट रूप से 3) event बिना clip के sync हो जाता है। देखें [Draft Events and Video](/deployment/hi/self-hosted/enterprise/deployment-manager/services/event-store.md#draft-events-and-video) कि एक pipeline device पर clips कैसे संलग्न करती है.

<figure><img src="https://2297977984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-dad946e36678b43e2fe868c8972b9b8853eb724f%2Fimage%20(455).png?alt=media" alt="" width="375"><figcaption></figcaption></figure>