> 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/manage/manage-images.md).

# इमेजें प्रबंधित करें

REST API और Python SDK के माध्यम से अलग-अलग इमेजें अपलोड, एनोटेट, निरीक्षण, टैग और हटाएँ।

## परिचय

Roboflow की मदद से आप REST API और Python SDK के ज़रिए किसी प्रोजेक्ट में अलग-अलग इमेज अपलोड, एनोटेट, निरीक्षण, टैग और डिलीट कर सकते हैं। जब आपको बल्क डेटासेट अपलोड फ़्लो से ज़्यादा बारीक नियंत्रण चाहिए, तब इन कार्रवाइयों का इस्तेमाल करें (उदाहरण के लिए, स्ट्रीम से एक बार में एक इमेज अपलोड करना, बाद में एनोटेशन जोड़ना, या इमेज का मेटाडेटा और टैग अपडेट करना)। एक साथ पूरा लेबल किया हुआ डेटासेट बल्क में इंपोर्ट करने के लिए देखें [डेटासेट अपलोड करें](https://docs.roboflow.com/datasets/hi/create-and-upload/upload-a-dataset.md).

## HTTP API

### इमेज अपलोड करें

इमेज इन तीन तरीकों में से किसी एक से भेजें:

* मल्टीपार्ट फ़ाइल अपलोड। स्थानीय फ़ाइलों के लिए यह सबसे कुशल विकल्प है।
* पूरे अनुरोध के मुख्य भाग के रूप में base64 स्ट्रिंग। इसका इस्तेमाल तब करें, जब आपका क्लाइंट मल्टीपार्ट अनुरोध तैयार न कर सके।
* image `image` क्वेरी पैरामीटर में सार्वजनिक URL दें। Roboflow अपने सर्वर से इमेज फ़ेच करता है, इसलिए अनुरोध के मुख्य भाग में कुछ नहीं भेजा जाता।

हर अपलोड से एक इमेज ID मिलता है। इमेज के लिए एनोटेशन अपलोड करने हेतु इसका इस्तेमाल करें। अपलोड की गई इमेज प्रोजेक्ट के Annotate पेज पर, Unassigned कॉलम में, आपके बताए गए बैच में या "API के ज़रिए अपलोड की गई" में दिखाई देती हैं।

{% openapi src="/files/9b24c8c5c54de70d122d94a78d16a9afdfc9a7b8" path="/dataset/{project}/upload" method="post" %}
[manage-images.yaml](https://2706998663-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-e79147570726f4d6b42c79beb72e2651a92dfd6d%2Fmanage-images.yaml?alt=media)
{% endopenapi %}

### एनोटेशन अपलोड करें

पहले से अपलोड की गई इमेज के साथ एनोटेशन फ़ाइल जोड़ें। यह किसी भी [समर्थित एनोटेशन फ़ॉर्मैट](https://roboflow.com/formats) के साथ काम करता है, जिसकी फ़ाइल में इमेज का फ़ाइल नाम संदर्भित हो। आप ऐप के Upload पेज पर अपनी इमेज के साथ एनोटेशन फ़ाइलें ड्रैग करके भी ला सकते हैं।

डिफ़ॉल्ट रूप से, एनोटेशन इमेज को Dataset में जोड़ देता है। जो इमेज किसी एनोटेशन जॉब में नहीं है, वह अपने बैच से हटकर उस जॉब में चली जाती है जिसका नाम आप `jobName`से देते हैं, या "API के ज़रिए एनोटेट की गई" जॉब में चली जाती है। इमेज को Dataset में जोड़े बिना एनोटेशन सहेजने के लिए `addToDataset=false` भेजें।

Action Recognition Project के लिए, वीडियो के सेगमेंट वाली एक [`roboflow-video-coco` दस्तावेज़](https://docs.roboflow.com/datasets/hi/create-and-upload/adding-data.md#import-video-segment-annotations) भेजें और इमेज ID की जगह वीडियो ID का इस्तेमाल करें।

{% openapi src="/files/9b24c8c5c54de70d122d94a78d16a9afdfc9a7b8" path="/dataset/{project}/annotate/{imageId}" method="post" %}
[manage-images.yaml](https://2706998663-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-e79147570726f4d6b42c79beb72e2651a92dfd6d%2Fmanage-images.yaml?alt=media)
{% endopenapi %}

### इमेज के बारे में विवरण पाएँ

इमेज का फ़ाइल नाम, स्प्लिट, टैग, मेटाडेटा, एनोटेशन और इमेज URL पढ़ें। वीडियो के लिए, जवाब में उसका पोस्टर इमेज, कुछ समय के लिए मान्य डाउनलोड लिंक और उसके [एक्शन सेगमेंट](https://docs.roboflow.com/datasets/hi/annotate/annotate/annotate-video-segments.md).

{% openapi src="/files/9b24c8c5c54de70d122d94a78d16a9afdfc9a7b8" path="/{workspace}/{project}/images/{imageId}" method="get" %}
[manage-images.yaml](https://2706998663-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-e79147570726f4d6b42c79beb72e2651a92dfd6d%2Fmanage-images.yaml?alt=media)
{% endopenapi %}

### वर्शन जाँच के साथ एनोटेशन सहेजें

किसी और के बदलाव को ओवरराइट किए बिना, इमेज के एनोटेशन को JSON शेप से बदलें। पहले, इमेज को `include=annotation`के साथ पाएँ। फिर उसका `annotationGroupVersion` इस रूप में भेजें: `expectedGroupVersion`—भले ही इमेज में कोई सहेजा हुआ एनोटेशन न हो। अगर आपके पढ़ने के बाद एनोटेशन बदल गया हो, तो सेव 409 स्टेटस के साथ विफल होगा। हर सेव अगली बार इस्तेमाल करने के लिए नया वर्शन लौटाता है।

{% openapi src="/files/9b24c8c5c54de70d122d94a78d16a9afdfc9a7b8" path="/{workspace}/{project}/images/{imageId}/annotation" method="put" %}
[manage-images.yaml](https://2706998663-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-e79147570726f4d6b42c79beb72e2651a92dfd6d%2Fmanage-images.yaml?alt=media)
{% endopenapi %}

### डेटासेट से इमेज डिलीट करें

ID के ज़रिए किसी प्रोजेक्ट से इमेज हटाएँ। अगर किसी अन्य प्रोजेक्ट में उस इमेज का इस्तेमाल नहीं हो रहा है, तो वह हमेशा के लिए डिलीट हो जाती है।

{% openapi src="/files/9b24c8c5c54de70d122d94a78d16a9afdfc9a7b8" path="/{workspace}/{project}/images" method="delete" %}
[manage-images.yaml](https://2706998663-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-e79147570726f4d6b42c79beb72e2651a92dfd6d%2Fmanage-images.yaml?alt=media)
{% endopenapi %}

### इमेज टैग जोड़ें और हटाएँ

किसी प्रोजेक्ट की एक इमेज पर टैग जोड़ें, हटाएँ या बदलें। आपको फ़ाइल नाम नहीं, इमेज ID चाहिए: [इसे खोजने के लिए प्रोजेक्ट में खोजें](https://docs.roboflow.com/datasets/hi/manage/manage-datasets/dataset-search.md#search-images-in-a-project) ।

{% openapi src="/files/9b24c8c5c54de70d122d94a78d16a9afdfc9a7b8" path="/{workspace}/{project}/images/{imageId}/tags" method="post" %}
[manage-images.yaml](https://2706998663-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-e79147570726f4d6b42c79beb72e2651a92dfd6d%2Fmanage-images.yaml?alt=media)
{% endopenapi %}

### इमेज मेटाडेटा और टैग अपडेट करें

अपने वर्कस्पेस में कहीं भी मौजूद इमेज में [कस्टम मेटाडेटा](https://docs.roboflow.com/datasets/hi/create-and-upload/adding-data/image-metadata.md) और टैग लिखें। एक इमेज के लिए सिंगल-इमेज एंडपॉइंट का इस्तेमाल करें। जवाब देने से पहले यह बदलाव लागू कर देता है।

{% openapi src="/files/9b24c8c5c54de70d122d94a78d16a9afdfc9a7b8" path="/{workspace}/images/{imageId}/metadata" method="post" %}
[manage-images.yaml](https://2706998663-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-e79147570726f4d6b42c79beb72e2651a92dfd6d%2Fmanage-images.yaml?alt=media)
{% endopenapi %}

एक अनुरोध में अधिकतम 1,000 इमेज बदलने के लिए बैच एंडपॉइंट का इस्तेमाल करें। यह बैकग्राउंड में चलता है और टास्क URL लौटाता है। टास्क पूरा होने तक इसे [Async Tasks API](https://docs.roboflow.com/reference/platform/rest-api/async-tasks) से पोल करें। इसके नतीजे में सफल इमेज की संख्या और विफल इमेज की सूची होती है।

{% openapi src="/files/9b24c8c5c54de70d122d94a78d16a9afdfc9a7b8" path="/{workspace}/images/metadata" method="post" %}
[manage-images.yaml](https://2706998663-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-e79147570726f4d6b42c79beb72e2651a92dfd6d%2Fmanage-images.yaml?alt=media)
{% endopenapi %}

## Python SDK

`Project` प्रति-छवि कार्रवाइयाँ उपलब्ध कराता है, जो बल्क [`upload_dataset`](https://docs.roboflow.com/datasets/hi/create-and-upload/upload-a-dataset.md#python-sdk) प्रवाह की पूरक हैं। इनका उपयोग तब करें, जब आपको एकल छवियों के अपलोड पर अधिक नियंत्रण चाहिए, बाद में एनोटेशन जोड़ना हो, या किसी स्ट्रीम से एक-एक करके छवियाँ शामिल करनी हों।

### छवि अपलोड करें (वैकल्पिक एनोटेशन के साथ)

`Project.upload()` उच्च-स्तरीय “सही काम करने” वाला हेल्पर है। यह एक छवि और उससे मेल खाने वाली वैकल्पिक एनोटेशन फ़ाइल स्वीकार करता है और दोनों को एक ही कॉल में प्रोजेक्ट पर भेजता है।

```python
import roboflow

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

result = project.upload(
    image_path="./photo.jpg",
    annotation_path="./photo.xml",   # optional; matched VOC / COCO / etc. annotation
    split="train",                    # train | valid | test
    batch_name="ingest-2026-05",     # optional; groups uploads in the web UI
    tag_names=["camera-A", "indoor"], # optional; apply tags
    is_prediction=False,              # set True for model-generated annotations awaiting review
    num_retry_uploads=2,              # retries on transient upload failures
)
print(result)
```

`single_upload()` निम्न-स्तरीय विकल्प है, जो वही तर्क स्वीकार करता है और छवि तथा (यदि दिया गया हो तो) एनोटेशन—दोनों के कच्चे API प्रतिसाद लौटाता है।

### केवल छवि अपलोड करें

```python
project.upload_image(
    image_path="./photo.jpg",
    split="train",
    batch_name="ingest-2026-05",
    tag_names=["camera-A"],
)
```

जब एनोटेशन अभी उपलब्ध न हों और छवि सीधे लेबलर के पास भेजी जानी हो, तब उपयोगी है।

### अपलोड करने से पहले छवि की पुष्टि करें

`check_valid_image()` API से संपर्क किए बिना Roboflow की स्थानीय आकार/फ़ॉर्मैट जाँच करता है:

```python
if project.check_valid_image("./photo.jpg"):
    project.upload_image("./photo.jpg")
```

### मौजूदा छवि में एनोटेशन जोड़ें

`save_annotation()` प्रोजेक्ट में पहले से मौजूद छवि के लिए एनोटेशन पोस्ट करता है। कहीं और बनाए गए लेबल जोड़ने या मॉडल की भविष्यवाणी को ग्राउंड ट्रुथ के रूप में चिह्नित करने के लिए उपयोगी है।

```python
project.save_annotation(
    image_id="<image-id>",
    annotation_path="./photo.xml",
    is_prediction=False,
    annotation_overwrite=True,    # replace any existing annotation
)
```

यदि आपके एनोटेशन फ़ॉर्मैट के लिए आवश्यक हो, तो क्लास इंडेक्स को क्लास नामों से मैप करने के लिए `annotation_labelmap="./labelmap.yaml"` पास करें।

is\_prediction=True `के साथ सहेजने पर छवि समीक्षा कार्य में भेजी जा सकती है। देखें कि` भविष्यवाणियाँ कहाँ पहुँचती हैं [।](https://docs.roboflow.com/datasets/hi/create-and-upload/upload-a-dataset.md#where-predictions-land).

### छवि का मेटाडेटा प्राप्त करें

```python
info = project.image("<image-id>")
print(info["name"], info["split"], info["annotations"])
```

इमेज मेटाडेटा, मौजूदा स्प्लिट और एनोटेशन की स्थिति लौटाता है।

### इमेज हटाएँ

प्रोजेक्ट-स्तर (केवल इस प्रोजेक्ट की इमेज हटाता है):

```python
project.delete_images(["<image-id-1>", "<image-id-2>"])
```

वर्कस्पेस-स्तर (इमेज को उन सभी प्रोजेक्ट से हटाता है जो उनका संदर्भ देते हैं—सावधानी से उपयोग करें):

```python
workspace.delete_images(["<image-id-1>", "<image-id-2>"])
```

### v1.3.6+ में अपलोड के बारे में एक नोट

के अनुसार `roboflow` 1.3.6 में, SDK इमेज को Pillow के ज़रिए फिर से एन्कोड करने के बजाय उसके मूल बाइट अपलोड करता है। इससे वेब अपलोडर के साथ समानता बहाल होती है और Roboflow सर्वर SHA-256 के आधार पर अपलोड की डुप्लिकेट पहचान पाता है। अगर आपके ऑटोमेशन में एक ही इमेज को दो बार अपलोड किया जाता है (उदाहरण के लिए, उसे कई बैच में जोड़ने के लिए), तो दूसरी बार अपलोड सफल होगा और अतिरिक्त स्टोरेज क्रेडिट खर्च नहीं होंगे।

## CLI

एक इमेज और उसके वैकल्पिक एनोटेशन, टैग या मेटाडेटा अपलोड करने के लिए CLI का उपयोग करें।

```bash
roboflow image upload photo.jpg -p PROJECT_ID
```

### विकल्प

<table data-search="false"><thead><tr><th>फ़्लैग</th><th>विवरण</th></tr></thead><tbody><tr><td><code>-p</code>, <code>--project</code></td><td>प्रोजेक्ट ID (आवश्यक)</td></tr><tr><td><code>-a</code>, <code>--annotation</code></td><td>एनोटेशन फ़ाइल का पथ</td></tr><tr><td><code>-m</code>, <code>--labelmap</code></td><td>लेबल मैप फ़ाइल का पथ</td></tr><tr><td><code>-s</code>, <code>--split</code></td><td>डेटासेट स्प्लिट: <code>train</code>, <code>valid</code>, या <code>test</code>. डिफ़ॉल्ट है <code>train</code>.</td></tr><tr><td><code>-t</code>, <code>--tag</code></td><td>अल्पविराम से अलग किए गए टैग नाम</td></tr><tr><td><code>-M</code>, <code>--metadata</code></td><td>JSON स्ट्रिंग के रूप में मेटाडेटा</td></tr><tr><td><code>--is-prediction</code></td><td>अपलोड को प्रेडिक्शन के रूप में चिह्नित करें</td></tr><tr><td><code>-b</code>, <code>--batch</code></td><td>बैच का नाम</td></tr></tbody></table>

### उदाहरण

एनोटेशन के साथ इमेज अपलोड करें:

```bash
roboflow image upload photo.jpg -p my-project -a annotation.xml -s valid
```

टैग और मेटाडेटा के साथ इमेज अपलोड करें:

```bash
roboflow image upload photo.jpg -p my-project -t "outdoor,daytime" -M '{"camera_id":"cam001"}'
```

डायरेक्टरी या `.zip` आर्काइव, देखें [डेटासेट अपलोड करें](https://docs.roboflow.com/datasets/hi/create-and-upload/upload-a-dataset.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_search</code></td><td>किसी प्रोजेक्ट के अंदर इमेज खोजें।</td></tr><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>annotations_save</code></td><td>किसी मौजूदा इमेज के लिए एनोटेशन सेव करें।</td></tr></tbody></table>
