> 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-image.md).

# Vision Event Image अपलोड करें

## के बारे में

यह एंडपॉइंट आपकी workspace में एक छवि अपलोड करता है, इसमें उपयोग के लिए [विजन इवेंट्स](/deployment/hi/monitoring-and-analytics/vision-events.md). अपलोड workspace-स्तरीय है और किसी प्रोजेक्ट से जुड़ा नहीं है; लौटाया गया `sourceId` फिर इसका संदर्भ दिया जा सकता है `images` ऐरे में, जब आप [एक इवेंट बनाते हैं](/deployment/hi/monitoring-and-analytics/vision-events/create-a-vision-event.md). इसका उपयोग मॉडल द्वारा प्रोसेस किए गए मूल या आउटपुट फ़्रेम संलग्न करने के लिए करें, ताकि उन्हें इवेंट के साथ देखा जा सके।

## HTTP API

विज़न इवेंट्स में उपयोग के लिए एक छवि अपलोड करें। यह एक workspace-स्तरीय अपलोड है जो किसी विशिष्ट प्रोजेक्ट से संबद्ध नहीं है। लौटाया गया `sourceId` का संदर्भ दिया जा सकता है `images` इवेंट बनाते समय ऐरे में।

**आवश्यक स्कोप:** `vision-events:write` या `device:update`

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

### उदाहरण अनुरोध

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

### अनुरोध पैरामीटर

के रूप में भेजें `multipart/form-data`:

* **`फ़ाइल`** (बाइनरी, आवश्यक): अपलोड की जाने वाली छवि फ़ाइल। समर्थित प्रारूप: JPEG, PNG, WebP, GIF, TIFF, BMP, HEIC, और AVIF।
* **`नाम`** (स्ट्रिंग, वैकल्पिक): छवि के लिए एक कस्टम नाम।
* **`मेटाडेटा`** (JSON स्ट्रिंग, वैकल्पिक): छवि से संलग्न करने के लिए कस्टम मेटाडेटा। यह एक वैध JSON ऑब्जेक्ट होना चाहिए जो इवेंट कस्टम मेटाडेटा जैसी ही सीमाओं का पालन करे: अधिकतम 100 कुंजियाँ, कुंजी नामों का मेल होना चाहिए `[a-zA-Z0-9_ -]+` (अधिकतम 100 वर्ण), स्ट्रिंग मान अधिकतम 1000 वर्ण, संख्या और बूलियन मान भी समर्थित हैं।

### उदाहरण प्रतिक्रिया

{% tabs %}
{% tab title="201" %}

```json
{
  "success": true,
  "sourceId": "ve-img-abc123def456",
  "url": "https://storage.roboflow.com/vision-events/images/ve-img-abc123def456.jpg"
}
```

का उपयोग करें `sourceId` में मान `images[].sourceId` फ़ील्ड में, जब [एक विज़न इवेंट बनाते समय](/deployment/hi/monitoring-and-analytics/vision-events/create-a-vision-event.md#http-api):

```json
{
  "eventId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "eventType": "quality_check",
  "useCaseId": "a1b3c8e1",
  "timestamp": "2024-01-15T10:30:00Z",
  "images": [
    {
      "sourceId": "ve-img-abc123def456",
      "objectDetections": [
        {
          "class": "defect",
          "x": 100,
          "y": 200,
          "width": 50,
          "height": 30,
          "confidence": 0.95
        }
      ]
    }
  ],
  "eventData": {
    "result": "fail"
  }
}
```

{% endtab %}

{% tab title="400" %}

```json
{
  "error": "No file provided"
}
```

{% endtab %}

{% tab title="403" %}

```json
{
  "error": "इस संसाधन के लिए पर्याप्त अनुमतियाँ नहीं हैं."
}
```

{% endtab %}
{% endtabs %}

## Python SDK

विज़न इवेंट्स में उपयोग के लिए एक स्थानीय छवि अपलोड करें। लौटाया गया `sourceId` का संदर्भ दिया जा सकता है `images` इवेंट बनाते समय ऐरे में।

```python
import roboflow

roboflow.login()

rf = roboflow.Roboflow()
ws = rf.workspace()

# एक छवि अपलोड करें
result = ws.upload_vision_event_image("inspection-photo.jpg")
source_id = result["sourceId"]

# आप एक वैकल्पिक नाम और मेटाडेटा भी प्रदान कर सकते हैं
result = ws.upload_vision_event_image(
    "inspection-photo.jpg",
    name="line-a-check-001",
    metadata={"camera": "cam-1", "shift": "morning"},
)
```

यह `sourceId` प्रतिक्रिया से प्राप्त मान का उपयोग किया जाता है `images` ऐरे में, जब [एक विज़न इवेंट बनाते समय](/deployment/hi/monitoring-and-analytics/vision-events/create-a-vision-event.md#python-sdk):

```python
ws.write_vision_event({
    "eventId": "d4e5f6a7-b2c3-4d4e-9f6a-7b8c9d0e1f2a",
    "eventType": "quality_check",
    "useCaseId": "a1b3c8e1",
    "timestamp": "2024-01-15T10:30:00Z",
    "images": [
        {
            "sourceId": source_id,
            "label": "inspection-photo",
            "objectDetections": [
                {"class": "defect", "x": 100, "y": 200, "width": 50, "height": 30, "confidence": 0.95}
            ],
        }
    ],
    "eventData": {"result": "fail"},
})
```

समर्थित छवि प्रारूपों और मेटाडेटा सीमाओं के लिए, देखें [REST API reference](#http-api).