Vision Events का बैच बनाएं

एक साथ कई observations ingest करने के लिए एक ही request में अधिकतम 100 Vision Events रिकॉर्ड करें।

के बारे में

यह एंडपॉइंट कई विजन इवेंट्स एक ही अनुरोध में, एक बार में 100 तक। इसका उपयोग तब करें जब किसी डिप्लॉयमेंट को एक साथ कई अवलोकनों को अंतर्ग्रहण करना हो, जो इवेंट्स को अलग-अलग बनाने की तुलना में अधिक कुशल है। एकल इवेंट रिकॉर्ड करने के लिए, देखें एक Vision Event बनाएं.

HTTP API

एक ही अनुरोध में 100 तक विज़न इवेंट्स बनाएं। जब आपको एक साथ कई इवेंट्स को अंतर्ग्रहण करने की आवश्यकता हो, तब यह इवेंट्स को अलग-अलग बनाने की तुलना में अधिक कुशल है।

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

Batch Create Vision Events

post

Create up to 100 vision events in a single request.

Authorizations

bearerAuth

AuthorizationstringRequired

Roboflow API key passed as a Bearer token.

Body

application/json

Responses

201

Events created successfully.

application/json

createdintegerOptional

eventIdsstring[]Optional

deprecationsstring[]Optional

400

Validation error.

application/json

403

Insufficient permissions for this resource.

application/json

post/vision-events/batch

HTTPcURLJavaScriptPython

POST /vision-events/batch HTTP/1.1
Host: api.roboflow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 733

{
  "events": [
    {
      "eventId": "text",
      "eventType": "quality_check",
      "useCaseId": "text",
      "timestamp": "2026-08-10T01:43:47.346Z",
      "deviceId": "text",
      "streamId": "text",
      "workflowId": "text",
      "workflowVersion": "text",
      "images": [
        {
          "label": "text",
          "sourceId": "text",
          "inputSourceId": "text",
          "objectDetections": [
            {
              "class": "text",
              "x": 1,
              "y": 1,
              "width": 1,
              "height": 1,
              "confidence": 1
            }
          ],
          "classifications": [
            {
              "class": "text",
              "confidence": 1
            }
          ],
          "instanceSegmentations": [
            {
              "class": "text",
              "x": 1,
              "y": 1,
              "width": 1,
              "height": 1,
              "confidence": 1,
              "points": [
                [
                  1
                ]
              ]
            }
          ],
          "keypoints": [
            {
              "class": "text",
              "x": 1,
              "y": 1,
              "width": 1,
              "height": 1,
              "confidence": 1,
              "keypoints": [
                {
                  "id": 1,
                  "x": 1,
                  "y": 1,
                  "occluded": true
                }
              ]
            }
          ]
        }
      ],
      "displayImagePosition": 1,
      "eventData": {},
      "customMetadata": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ]
}

{
  "created": 1,
  "eventIds": [
    "text"
  ],
  "deprecations": [
    "text"
  ]
}

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

curl -X POST "https://api.roboflow.com/vision-events/batch" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "events": [
      {
        "eventId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "eventType": "quality_check",
        "useCaseId": "a1b3c8e1",
        "timestamp": "2024-01-15T10:30:00Z",
        "eventData": {
          "result": "pass"
        }
      },
      {
        "eventId": "9c4d6a2e-81f3-4b7a-bc9e-3f1a2d4e5c6b",
        "eventType": "quality_check",
        "useCaseId": "a1b3c8e1",
        "timestamp": "2024-01-15T10:31:00Z",
        "eventData": {
          "result": "fail"
        }
      }
    ]
  }'

अनुरोध बॉडी पैरामीटर

• इवेंट्स (array, आवश्यक, अधिकतम 100): इवेंट ऑब्जेक्ट्स की एक ऐरे। प्रत्येक इवेंट उसी स्कीमा का पालन करता है जैसा एक Vision Event बनाएं endpoint के माध्यम से query किया जा सकता है।

अपने इवेंट्स में इमेज शामिल करने के लिए, पहले प्रत्येक इमेज को एक विज़न इवेंट इमेज अपलोड करें एंडपॉइंट का उपयोग करके अपलोड करें, फिर लौटाए गए sourceId को इमेज ऑब्जेक्ट में संदर्भित करें। देखें Image Objects विवरण के लिए।

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

201

{
  "created": 2,
  "eventIds": ["f47ac10b-58cc-4372-a567-0e02b2c3d479", "9c4d6a2e-81f3-4b7a-bc9e-3f1a2d4e5c6b"]
}

400

{
  "error": "बैच आकार 100 इवेंट्स की अधिकतम सीमा से अधिक है"
}

403

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

प्रतिक्रिया में एक warnings एक ऑब्जेक्ट जिसमें प्रति-इवेंट सत्यापन चेतावनियाँ (इवेंट इंडेक्स द्वारा कुंजीबद्ध) होती हैं, और एक deprecations ऐरे, यदि अप्रचलित फ़ील्ड नामों का उपयोग किया गया था। देखें सत्यापन और चेतावनियाँ विवरण के लिए।

Python SDK

एक ही अनुरोध में कई विज़न इवेंट्स बनाएं। सर्वर प्रति बैच 100 इवेंट्स तक की अनुमति देता है।

import roboflow

roboflow.login()

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

result = ws.write_vision_events_batch([
    {
        "eventId": "e5f6a7b8-c3d4-4e5f-a0b1-c2d3e4f5a6b7",
        "eventType": "quality_check",
        "useCaseId": "a1b3c8e1",
        "timestamp": "2024-01-15T10:00:00Z",
        "eventData": {"result": "pass"},
    },
    {
        "eventId": "f6a7b8c9-d4e5-4f6a-b1c2-d3e4f5a6b7c8",
        "eventType": "quality_check",
        "useCaseId": "a1b3c8e1",
        "timestamp": "2024-01-15T10:01:00Z",
        "eventData": {"result": "fail"},
        "customMetadata": {"line": "A1"},
    },
])

print(result["created"])    # बनाए गए इवेंट्स की संख्या
print(result["eventIds"])   # बनाए गए इवेंट IDs की सूची

सूची में प्रत्येक इवेंट उसी स्कीमा का पालन करता है जैसा एक एकल इवेंट. इवेंट स्कीमा और सत्यापन व्यवहार के पूर्ण विवरण के लिए, देखें the REST API reference.