> 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/datasets/hi/create-and-upload/adding-data/image-metadata.md).

# इमेज मेटाडेटा

मेटाडेटा आपको अपने Roboflow कार्यक्षेत्र में छवियों के साथ कस्टम कुंजी-मूल्य युग्म जोड़ने देता है। मेटाडेटा का उपयोग अपनी छवियों के साथ संरचित जानकारी संग्रहीत करने के लिए करें - जैसे कैप्चर स्थितियाँ, डिवाइस पहचानकर्ता, गुणवत्ता स्कोर, या कोई भी डोमेन-विशिष्ट विशेषताएँ - और फिर उन्हीं विशेषताओं के आधार पर अपने डेटा को खोजें, फ़िल्टर करें और व्यवस्थित करें।

## अवलोकन

प्रत्येक छवि में मेटाडेटा की कितनी भी प्रविष्टियाँ हो सकती हैं। एक प्रविष्टि होती है एक **कुंजी** (जैसे नाम जैसे `camera_id`) के साथ जोड़ी गई एक **मूल्य** (एक स्ट्रिंग, संख्या, या बूलियन)।

| मूल्य का प्रकार | उदाहरण                                      |
| --------------- | ------------------------------------------- |
| स्ट्रिंग        | `location: "warehouse-3"`, `shift: "night"` |
| संख्या          | `temperature: 72.5`, `quality_score: 95`    |
| बूलियन          | `reviewed: true`, `is_night: false`         |

### उपयोग के मामले

* **संदर्भ कैप्चर करें** - कैमरा ID, GPS निर्देशांक, मौसम, प्रकाश स्थितियाँ रिकॉर्ड करें
* **गुणवत्ता ट्रैकिंग** - विश्वास स्कोर, समीक्षा स्थिति, एनोटेटर IDs संलग्न करें
* **डेटा विभाजन** - लक्षित प्रशिक्षण सेट बनाने के लिए अपने डेटासेट को किसी भी विशेषता से फ़िल्टर करें
* **बाहरी सिस्टम लिंकिंग** - ऐसे पहचानकर्ता संग्रहीत करें जो छवियों को आपके आंतरिक टूल्स से जोड़ते हैं

## मेटाडेटा जोड़ना

आप वेब UI, Python SDK, REST API के माध्यम से, या स्वचालित रूप से के ज़रिए छवियों में मेटाडेटा जोड़ सकते हैं [S3 बकेट मिरर](/datasets/hi/create-and-upload/adding-data/datasources.md).

{% hint style="info" %}
यदि आपकी छवियाँ AWS S3 जैसे क्लाउड स्टोरेज में रहती हैं, तो [Datasources](/datasets/hi/create-and-upload/adding-data/datasources.md) और Bucket Mirror का उपयोग करें ताकि छवि फ़ाइलें और मेटाडेटा साइडकार्स सिंक में रहें। Signed URL या मैन्युअल अपलोड वही निरंतर मेटाडेटा सिंक व्यवहार प्रदान नहीं करते हैं।
{% endhint %}

### वेब अनुप्रयोग

{% stepper %}
{% step %}

#### एक छवि खोलें

अपने प्रोजेक्ट में कोई भी छवि खोलें।
{% endstep %}

{% step %}

#### कुंजी और मूल्य दर्ज करें

मेटाडेटा अनुभाग में, एक दर्ज करें **कुंजी** पहले इनपुट में और एक **मूल्य** दूसरे इनपुट में।
{% endstep %}

{% step %}

#### जोड़ें

दबाएँ **Enter** सहेजने के लिए या Add पर क्लिक करें
{% endstep %}
{% endstepper %}

मूल्यों को स्वचालित रूप से प्रकार के अनुसार पार्स किया जाता है:

| दर्ज किया गया मूल्य | के रूप में संग्रहीत       |
| ------------------- | ------------------------- |
| `front`             | `"सामने"` (स्ट्रिंग)      |
| `95`                | `95` (संख्या)             |
| `3.14`              | `3.14` (संख्या)           |
| `true` / `false`    | `true` / `false` (बूलियन) |

<figure><img src="/files/621953c17837de38ca38aab8d8242e5cfd0a8727" alt=""><figcaption><p>एनोटेशन टूल का मेटाडेटा संपादक</p></figcaption></figure>

### Python SDK

एक `मेटाडेटा` डिक्शनरी छवि अपलोड करते समय पास करें:

```python
import roboflow

rf = roboflow.Roboflow(api_key="YOUR_API_KEY")
project = rf.workspace("your-workspace").project("your-project")

project.upload(
    image_path="image.jpg",
    metadata={
        "camera_id": "cam001",
        "location": "warehouse-3",
        "temperature": 72.5,
        "is_night": False
    }
)
```

### CLI

का उपयोग करें `roboflow image metadata` मौजूदा छवियों पर मेटाडेटा और टैग अपडेट करने के लिए कमांड:

```bash
# एकल छवि पर मेटाडेटा सेट करें
roboflow image metadata <image_id> -m '{"camera_id": "cam001", "location": "warehouse-3"}'

# किसी छवि में टैग जोड़ें
roboflow image metadata <image_id> --tags "reviewed,v2"

# मेटाडेटा कुंजियाँ हटाएँ
roboflow image metadata <image_id> --remove-metadata "old_key,deprecated_field"

# टैग हटाएँ
roboflow image metadata <image_id> --remove-tags "draft"

# संयोजन: एक ही कॉल में मेटाडेटा सेट करें, टैग जोड़ें, और टैग हटाएँ
roboflow image metadata <image_id> -m '{"quality_score": 95}' --tags "reviewed" --remove-tags "pending"

# कई छवियों का बैच अपडेट करें (async)
roboflow image metadata img1,img2,img3 -m '{"batch": "june-2026"}' --tags "processed" --poll
```

एकल छवि ID समकालिक रूप से अपडेट होती है। अल्पविराम से अलग किए गए अनेक IDs (अधिकतम 1,000) बैच async endpoint का उपयोग करते हैं। जोड़ें `--poll` बैच के समाप्त होने की प्रतीक्षा करने के लिए; इसके बिना कमांड एक `taskId` जिसे आप बाद में जाँच सकते हैं `roboflow asynctasks get <task-id>`.

| फ़्लैग                 | विवरण                                                 |
| ---------------------- | ----------------------------------------------------- |
| `-m`, `--metadata`     | सेट करने के लिए कुंजी-मूल्य युग्मों की JSON स्ट्रिंग  |
| `--remove-metadata`    | हटाने के लिए अल्पविराम से अलग की गई मेटाडेटा कुंजियाँ |
| `--tags`               | जोड़ने के लिए अल्पविराम से अलग किए गए टैग             |
| `--remove-tags`        | हटाने के लिए अल्पविराम से अलग किए गए टैग              |
| `--poll` / `--no-poll` | बैच पूरा होने तक प्रतीक्षा करें (केवल बैच मोड)        |
| `--timeout`            | सेकंड में पोलिंग समय-सीमा (डिफ़ॉल्ट: 1800)            |

### REST API

#### अपलोड के दौरान मेटाडेटा जोड़ें

एक `मेटाडेटा` फ़ील्ड (JSON-stringified) को multipart form data में शामिल करें जब छवि अपलोड कर रहे हों:

```bash
curl -X POST "https://api.roboflow.com/dataset/your-dataset/upload?api_key=$ROBOFLOW_API_KEY" \
  -F "name=image.jpg" \
  -F "split=train" \
  -F "file=@image.jpg" \
  -F 'metadata={"camera_id":"cam001","temperature":72.5}'
```

### S3 बकेट मिरर

का उपयोग करते समय [Datasources](/datasets/hi/create-and-upload/adding-data/datasources.md) S3 बकेट से छवियों को सिंक करने के लिए, मेटाडेटा प्रत्येक छवि के साथ रखी गई JSON साइडकार फ़ाइलों के माध्यम से आयात किया जाता है। देखें [Datasources](/datasets/hi/create-and-upload/adding-data/datasources.md) साइडकार फ़ाइल प्रारूप, सीमाओं और अपडेट रणनीतियों के लिए।

### MCP सर्वर

अपने AI एजेंट को जोड़ें [MCP सर्वर](https://docs.roboflow.com/agents/mcp-server) और यह इन टूल्स के साथ छवियों को टैग कर सकता है और उन पर मेटाडेटा सेट कर सकता है:

<table data-search="false"><thead><tr><th width="290">टूल</th><th>विवरण</th></tr></thead><tbody><tr><td><code>images_update_metadata</code></td><td>एकल छवि पर मेटाडेटा और टैग अपडेट करें।</td></tr><tr><td><code>images_batch_update_metadata</code></td><td>कई छवियों पर मेटाडेटा और टैग का बैच अपडेट करें।</td></tr><tr><td><code>images_search</code></td><td>जिस छवि को आप अपडेट करना चाहते हैं, उसे टैग, वर्ग, या मेटाडेटा के आधार पर खोजें।</td></tr></tbody></table>

## मेटाडेटा द्वारा खोज

मेटाडेटा का इंडेक्स बनाया जाता है और इसे [एसेट लाइब्रेरी](https://docs.roboflow.com/platform/workspaces/asset-library)में खोजा जा सकता है। मेटाडेटा मानों के आधार पर छवियों को फ़िल्टर करने के लिए खोज बार का उपयोग करें:

```
metadata:camera_id="cam001"
metadata:quality_score>80
metadata:reviewed=true
```

आप मेटाडेटा फ़िल्टरों को अन्य खोज फ़िल्टरों के साथ जोड़ सकते हैं:

```
metadata:location="warehouse-3" AND class:forklift
```

एसेट लाइब्रेरी आपके वर्कस्पेस में मौजूद चीज़ों के आधार पर मेटाडेटा कुंजियों और मूल्यों के लिए स्वतः पूर्णता भी प्रदान करती है।

## कुंजी नामकरण नियम

मेटाडेटा कुंजियों को इन नियमों का पालन करना चाहिए:

| नियम         | विवरण                                                                |
| ------------ | -------------------------------------------------------------------- |
| अनुमत वर्ण   | अक्षर (`a-z`, `A-Z`), संख्याएँ (`0-9`), अंडरस्कोर (`_`), बिंदु (`.`) |
| पहला वर्ण    | अक्षर, संख्या, या अंडरस्कोर होना चाहिए                               |
| निषिद्ध वर्ण | फ़ॉरवर्ड स्लैश (`/`) अनुमत नहीं हैं                                  |

मान्य कुंजियाँ: `camera_id`, `capture.temperature`, `_internal_ref`, `v2_score`

अमान्य कुंजियाँ: `camera/id` (शामिल है `/`), `.starts_with_dot` (से शुरू होता है `.`), `has spaces` (रिक्त स्थान शामिल हैं)

## मेटाडेटा बनाम टैग

मेटाडेटा और [tags](/datasets/hi/manage/manage-datasets/add-tags-to-images.md) दोनों आपको छवियों को व्यवस्थित करने में मदद करते हैं, लेकिन इनके उद्देश्य अलग-अलग हैं:

|                          | टैग                                  | मेटाडेटा                                   |
| ------------------------ | ------------------------------------ | ------------------------------------------ |
| **संरचना**               | सरल लेबल                             | कुंजी-मूल्य युग्म                          |
| **मूल्य**                | कोई मूल्य नहीं, सिर्फ एक नाम         | स्ट्रिंग, संख्या, या बूलियन                |
| **इसके लिए सर्वश्रेष्ठ** | श्रेणीकरण, वर्कफ़्लो स्थिति          | संरचित विशेषताएँ, माप                      |
| **उदाहरण**               | `reviewed`, `v2`, `needs-annotation` | `temperature: 72.5`, `camera_id: "cam001"` |

आप एक ही छवि पर दोनों का उपयोग कर सकते हैं। उदाहरण के लिए, किसी छवि को `reviewed` के रूप में टैग करें `और साथ ही संग्रहीत करें` और `reviewer: "alice"` confidence: 0.95 को मेटाडेटा के रूप में।