एक Vision Event छवि अपलोड करें

एक workspace-level image अपलोड करें और Vision Event बनाते समय इसके sourceId का संदर्भ दें।

के बारे में

यह एंडपॉइंट एक इमेज को आपके वर्कस्पेस में अपलोड करता है, जिसका उपयोग किया जाता है विजन इवेंट्स. अपलोड वर्कस्पेस-स्तरीय है और किसी भी प्रोजेक्ट से जुड़ा नहीं है; लौटाया गया sourceId फिर इसका संदर्भ लिया जा सकता है images ऐरे में, जब आप एक इवेंट बनाते हैं. इसका उपयोग मूल या आउटपुट फ्रेम को संलग्न करने के लिए करें जिन्हें किसी मॉडल ने संसाधित किया है, ताकि वे इवेंट के साथ देखे जा सकें।

HTTP API

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

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

Upload a Vision Event Image

post

Upload an image for use in vision events.

Authorizations

bearerAuth

AuthorizationstringRequired

Roboflow API key passed as a Bearer token.

Body

multipart/form-data

filestring · binaryRequired

The image file to upload.

namestringOptional

Custom name for the image.

metadatastringOptional

JSON string of custom metadata.

Responses

201

Image uploaded successfully.

application/json

successbooleanOptional

sourceIdstringOptional

Reference ID for use in event images.

urlstringOptional

Public URL of the uploaded image.

400

Missing file or invalid metadata.

application/json

403

Insufficient permissions for this resource.

application/json

post/vision-events/upload

HTTPcURLJavaScriptPython

POST /vision-events/upload HTTP/1.1
Host: api.roboflow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 49

{
  "file": "binary",
  "name": "text",
  "metadata": "text"
}

{
  "success": true,
  "sourceId": "text",
  "url": "text"
}

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

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:

• file (बाइनरी, आवश्यक): अपलोड की जाने वाली इमेज फ़ाइल। समर्थित प्रारूप: JPEG, PNG, WebP, GIF, TIFF, BMP, HEIC, और AVIF.

• name (स्ट्रिंग, वैकल्पिक): इमेज के लिए एक कस्टम नाम।

• metadata (JSON स्ट्रिंग, वैकल्पिक): इमेज से जोड़ने के लिए कस्टम मेटाडेटा। यह एक वैध JSON ऑब्जेक्ट होना चाहिए जो इवेंट कस्टम मेटाडेटा जैसी ही सीमाओं का पालन करे: अधिकतम 100 keys, कुंजी नामों को मिलना चाहिए [a-zA-Z0-9_ -]+ (अधिकतम 100 वर्ण), स्ट्रिंग मान अधिकतम 1000 वर्ण, संख्या और बूलियन मान भी समर्थित हैं। जिन कुंजियों की शुरुआत होती है _rf_internal_ Roboflow के लिए आरक्षित हैं और अस्वीकार कर दी जाती हैं।

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

201

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

का उपयोग करें sourceId मान को images[].sourceId फ़ील्ड में, जब एक विजन इवेंट बनाते समय:

{
  "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"
  }
}

400

{
  "error": "No file provided"
}

403

{
  "error": "Insufficient permissions for this resource."
}

Python SDK

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

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 ऐरे में, जब एक विजन इवेंट बनाते समय:

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 संदर्भ.