> 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-datasets/dataset-search.md). # एक डेटासेट खोजें ## के बारे में डेटासेट खोज आपको फ़ाइल-नाम लुकअप, संरचित फ़िल्टर (टैग, स्प्लिट, क्लास, आयाम, एनोटेशन गिनती), बूलियन लॉजिक, और प्राकृतिक-भाषा अर्थगत खोज का उपयोग करके पूरे प्रोजेक्ट में विशिष्ट छवियाँ खोजने देती है। इसका उपयोग अपने डेटा का ऑडिट करने, गलत लेबल या अनुपलब्ध एनोटेशन को उजागर करने, और समीक्षा या निर्यात के लिए लक्षित उपसमुच्चय बनाने में करें। वही क्वेरीज़ वेब ऐप और सर्च REST API दोनों में उपलब्ध हैं। ## वेब ऐप आप Roboflow में फ़ाइल नाम, सर्च क्वेरी, और क्वेरीज़ तथा फ़िल्टर के मिश्रण का उपयोग करके इमेज फ़ाइलें खोज सकते हैं, ताकि विशिष्ट छवियाँ ढूँढ सकें और अपने डेटा को बेहतर समझ सकें। * **किसी निश्चित टैग वाले स्प्लिट में मौजूद छवियाँ:**\ `tag:factory split:train`\ यह एक टैग फ़िल्टर और एक स्प्लिट फ़िल्टर का उपयोग करता है * **अर्थगत खोज और क्लास फ़िल्टर का उपयोग करके गायब लेबल खोजें**:\ `person -class:helmet`\ यह एक क्लास फ़िल्टर पर अर्थगत खोज और एक उल्टा फ़िल्टर का उपयोग करता है * **यदि किसी क्लास वाली सभी छवियों को किसी निश्चित फ़िल्टर की आवश्यकता हो:**\ `class:helmet AND NOT (tag:v1 OR tag:v2)`\ यह एक क्लास फ़िल्टर, बूलियन लॉजिक, और टैग फ़िल्टरों का उपयोग करता है * **कम एनोटेशन संख्या वाली चौड़ी छवियाँ खोजें:**\ `min-width:1000 max-annotations:1`\ यह एक न्यूनतम चौड़ाई फ़िल्टर और एक अधिकतम एनोटेशन गिनती फ़िल्टर का उपयोग करता है की पूरी सूची देखें [खोज फ़िल्टर](#search-filters) , साथ ही नीचे दिए गए उदाहरणों को भी {% hint style="info" %} आप इन सभी खोज फ़िल्टरों और क्वेरीज़ को एक साथ जोड़ सकते हैं {% endhint %} ### अर्थगत खोज आप छवियों का वर्णन करके उन्हें खोज सकते हैं। ये क्वेरीज़ आपकी खोज शर्तों से सबसे अधिक संबंधित छवियों को खोजेंगी और तब भी छवियाँ ढूँढने में मदद कर सकती हैं जब वस्तुएँ अभी लेबल न की गई हों। अर्थगत खोज तब होती है जब आप बिना किसी फ़िल्टर चयनकर्ता के एक टेक्स्ट क्वेरी दर्ज करते हैं (उदाहरण: `filename:`)
### फ़ाइल नाम से खोजें आप `filename:` फ़िल्टर या फ़ाइल नाम टेक्स्टबॉक्स का उपयोग करके फ़ाइल नाम खोज सकते हैं, जो आपके लिए क्वेरी बनाएगा।
### डेटासेट स्प्लिट के अनुसार खोजें डेटासेट स्प्लिट (train, valid, test) के अनुसार छवियाँ खोजें
छवियों को किसी अलग स्प्लिट में पुनः असाइन करने के लिए, उन्हें चुनें (या किसी खोज से "Select all matching" चुनें) और बल्क क्रियाएँ मेनू में "Change Dataset Split" पर क्लिक करें। बड़े चयन पृष्ठभूमि में संसाधित होते हैं। ### अपलोड तिथि के अनुसार खोजें Roboflow पर पहली बार अपलोड की गई तिथि के आधार पर छवियों को `date:` फ़िल्टर का उपयोग करके फ़िल्टर करें। अपलोड तिथि अपरिवर्तनीय होती है और जब किसी छवि को संपादित, पुनः-एनोटेट, या स्प्लिटों के बीच स्थानांतरित किया जाता है, तो यह नहीं बदलती। उपयोग करें `date:YYYY-MM-DD` किसी सटीक दिन के लिए, या एक सीमा खोजने के लिए तुलना ऑपरेटरों को मिलाएँ: `date>=2026-01-01 date<2026-02-01` ### खोज फ़िल्टर उपलब्ध फ़िल्टर यहाँ हैं: * `like-image:`: छवि सामग्री के आधार पर अर्थगत खोज * `tag` : उपयोगकर्ता द्वारा दिए गए टैग के आधार पर फ़िल्टर करें। * `filename` : दिए गए फ़ाइल नाम से मेल खाने वाले फ़ाइल नामों के लिए खोज चलाता है। आंशिक मिलान चलाने के लिए क्वेरी की शुरुआत और अंत में \* का उपयोग करें। * `split` : स्प्लिट (train, test, valid) के आधार पर फ़िल्टर करता है। * `job:` : दिए गए जॉब ID वाली छवियाँ दिखाता है। * `min-width:X` : X से अधिक चौड़ाई वाली छवियाँ दिखाता है। * `max-width:X` : X से कम चौड़ाई वाली छवियाँ दिखाता है। * `min-height:X` : X से अधिक ऊँचाई वाली छवियाँ दिखाता है। * `max-height:X` : X से कम ऊँचाई वाली छवियाँ दिखाता है। * `min-annotations:X` : निर्दिष्ट संख्या से अधिक एनोटेशन वाली छवियों को फ़िल्टर करता है। * `max-annotations:X` : निर्दिष्ट संख्या से कम एनोटेशन वाली छवियाँ दिखाता है। * `class:CLASS`: कम से कम 1 एनोटेशन वाली छवियाँ दिखाता है जिनमें दिया गया लेबल है। * `date:YYYY-MM-DD` : वह अपरिवर्तनीय तिथि जिसके दिन छवि अपलोड की गई थी, उसके आधार पर फ़िल्टर करता है। तुलना ऑपरेटरों का समर्थन करता है (उदाहरण: `date>=2026-01-01 date<2026-02-01`). #### बूलियन लॉजिक AND, OR, NOT, और कोष्ठकों का उपयोग करके कई फ़िल्टरों को मिलाकर जटिल क्वेरी बनाएँ। `class:helmet AND NOT (tag:v1 OR tag:v2)` #### उल्टे फ़िल्टर फ़िल्टर से मेल खाने वाली छवियों को बाहर करने के लिए फ़िल्टर से पहले एक माइनस चिह्न जोड़ें। `class:helmet -class:vest` #### संख्यात्मक क्लास फ़िल्टर किसी छवि में लेबल किए गए आइटमों की संख्या के आधार पर फ़िल्टर करें। `class:helmet=3 class:vest>=4` ### API आप Roboflow पर अपने डेटासेट और छवियों को [सर्च API](#http-api). ## HTTP API आप REST API का उपयोग करके Roboflow पर होस्ट की गई छवियों को खोज सकते हैं। दो एंडपॉइंट हैं: एक प्रोजेक्ट-स्कोप्ड `/:workspace/:project/search` एंडपॉइंट, और एक पूरे वर्कस्पेस का `/:workspace/search/v1` एंडपॉइंट जो [वेब ऐप डेटासेट खोज](#web-app). ### किसी प्रोजेक्ट में छवियाँ खोजें Roboflow पर होस्ट की गई छवियों को खोजने के लिए, निम्न API एंडपॉइंट पर POST अनुरोध भेजें: ```url https://api.roboflow.com/:workspace/:project/search ``` API के लिए एक उदाहरण अनुरोध यहाँ है: ```bash curl -X POST "https://api.roboflow.com/my-workspace/my-project-name/search?api_key=$ROBOFLOW_API_KEY" \\ -H 'Content-Type: application/json' \\ --data \\ '{ "like_image": "image_id", "in_dataset": true, "limit": 125 }' ``` यह एंडपॉइंट POST बॉडी में निम्न मान स्वीकार करता है: ```json { // जब दिया गया हो, तो परिणाम अर्थगत समानता के अनुसार क्रमबद्ध प्रदान करता है "like_image": string, // जब दिया गया हो, तो परिणाम अर्थगत समानता के अनुसार क्रमबद्ध प्रदान करता है "prompt": string, // डिफ़ॉल्ट 0 है "offset": int, // डिफ़ॉल्ट 50 (अधिकतम: 250) "limit": int, // जब मौजूद हो, तो उस टैग वाली छवियों को फ़िल्टर करता है "tag": string, // जब मौजूद हो, तो उस वर्ग नाम वाली छवियों को फ़िल्टर करता है "class_name": string, // जब मौजूद हो, तो उस प्रोजेक्ट में मौजूद छवियों को फ़िल्टर करता है "in_dataset": string, // जब मौजूद हो, तो केवल किसी भी बैच में मौजूद छवियाँ लौटाता है "batch": boolean, // जब मौजूद हो, तो केवल दिए गए बैच में मौजूद छवियाँ लौटाता है "batch_id": string, // जब मौजूद हो, तो केवल किसी भी एनोटेशन जॉब में मौजूद छवियाँ लौटाता है "annotation_job": boolean, // जब मौजूद हो, तो केवल दिए गए एनोटेशन जॉब में मौजूद छवियाँ लौटाता है "annotation_job_id": string, // लौटाने वाले फ़ील्ड निर्दिष्ट करें, डिफ़ॉल्ट ["id", "created"] है // विकल्प हैं ["id", "name", "annotations", "labels", "split", "tags", "owner", "url", "embedding", "created"] "fields": string[] } ``` सर्च API निम्न संरचना के साथ एक प्रतिक्रिया लौटाएगी। उपलब्ध मान आपके द्वारा निर्दिष्ट अतिरिक्त `फ़ील्ड्स` के आधार पर भिन्न होंगे: ```json { "offset": 0, "total": 292, "results": [ { "id": "image123", "name": "humpbackwhale.jpg", "owner": "owner123", "url": "https://source.roboflow.com/owner123/image123/original.jpg", "annotations": { "count": 5, "classes": { "whale": 1, "fish": 4 } }, "labels": [], "tags": [ "cam_x13" ] } // आदि. ] } ``` ### वर्कस्पेस में छवियाँ खोजें वर्कस्पेस इमेज सर्च API आपको अपने वर्कस्पेस के भीतर छवियों की सूची बनाने और खोजने की सुविधा देता है। इस API के साथ, आप फ़िल्टर, क्रमबद्ध कर सकते हैं, और एक क्वेरी स्ट्रिंग का उपयोग करके अर्थगत खोजें कर सकते हैं जो इसके समान होती है [Roboflow वेब एप्लिकेशन में इमेज खोज सुविधा](#web-app). #### एंडपॉइंट API पर अनुरोध करने के लिए, एक `POST` अनुरोध निम्न एंडपॉइंट पर भेजें: ``` https://api.roboflow.com/{WORKSPACE}/search/v1?api_key=API_KEY ``` जहाँ `WORKSPACE` आपका Workspace ID है, और `API_KEY` आपकी API key है। [जानें कि अपना Workspace ID कैसे खोजें](https://docs.roboflow.com/reference/authentication/authentication/workspace-and-project-ids). [जानें कि अपनी API key कैसे खोजें।](https://docs.roboflow.com/reference/platform/rest-api/authenticate-with-the-rest-api) #### प्रमाणीकरण API तक पहुँचने के लिए, आपको अनुरोध में अपनी API key शामिल करनी होगी। API key को क्वेरी पैरामीटर के रूप में पास किया जाना चाहिए। उदाहरण: `?api_key={YOUR_API_KEY}` #### अनुरोध फ़ॉर्मेट **हेडर** * `Content-Type: application/json` **बॉडी पैरामीटर** * `query` **(आवश्यक)**: फ़िल्टर, क्रमबद्ध करने, या अर्थगत खोज करने के लिए एक गैर-खाली स्ट्रिंग। उदाहरण के लिए: `"nighttime project:{my-project-url}"` छवियों को `my-project-url` प्रोजेक्ट में फ़िल्टर करेगा और उन छवियों के लिए एक अर्थगत क्रमबद्धता लागू करेगा जो `nighttime`. यदि गायब या खाली हो तो 400 त्रुटि लौटाती है। * `pageSize`: प्रति पृष्ठ लौटाए जाने वाले परिणामों की संख्या (डिफ़ॉल्ट: 50)। * `फ़ील्ड्स`: प्रतिक्रिया में शामिल किए जाने वाले फ़ील्डों की सूची। संभावित मान हैं `"tags"`, `"width"`, `"height"`, `"filename"`, `"aspectRatio"`, `"split"`, `"projects"`, `"annotations"`, `"labels"`, `"owner"`, `"url"`. **उदाहरण अनुरोध** ```bash curl --location 'https://api.roboflow.com/{WORKSPACE}/search/v1?api_key={API_KEY}' \\ --header 'Content-Type: application/json' \\ --data '{ "query": "project:foo nightime", "pageSize": 10, "fields": ["tags", "width", "height", "filename", "aspectRatio", "split"] }' ``` #### प्रतिक्रिया फ़ॉर्मेट प्रतिक्रिया एक JSON ऑब्जेक्ट है जिसमें निम्न फ़ील्ड शामिल हैं: * `results`: इमेज ऑब्जेक्ट्स की एक array. * `total`: मिली हुई छवियों की कुल संख्या. * `continuationToken`: पेजिनेशन के लिए एक टोकन. **इमेज ऑब्जेक्ट फ़ील्ड्स** इस पर निर्भर करता है कि `फ़ील्ड्स` पैरामीटर में कौन से फ़ील्ड अनुरोधित किए गए हैं: * `id`: छवि का अद्वितीय पहचानकर्ता। * `projectData`: प्रोजेक्ट URL द्वारा कुंजीबद्ध ऑब्जेक्ट, जिसमें प्रोजेक्ट-विशिष्ट डेटा होता है: * `split`: डेटासेट स्प्लिट को दर्शाता है (उदा., "test"). तब लौटाया जाता है जब `"split"` मौजूद हो `फ़ील्ड्स`. * `inDataset`: एक बूलियन जो दर्शाता है कि छवि डेटासेट में है या नहीं। तब लौटाया जाता है जब `"projects"` मौजूद हो `फ़ील्ड्स`. * `annotations`: इस प्रोजेक्ट में छवि के लिए एनोटेशन डेटा, जिसमें `annotationGroup`, `classes`, और `classCounts`. तब लौटाया जाता है जब `"annotations"` मौजूद हो `फ़ील्ड्स`. * `labels`: इस प्रोजेक्ट में छवि के लिए लेबल डेटा। तब लौटाया जाता है जब `"labels"` मौजूद हो `फ़ील्ड्स`. * `tags`: छवि से जुड़े टैगों की array. * `width`: पिक्सेल में छवि की चौड़ाई। * `height`: पिक्सेल में छवि की ऊँचाई। * `filename`: छवि फ़ाइल का नाम। * `aspectRatio`: छवि का आस्पेक्ट रेशियो। * `owner`: छवि का मालिक पहचानकर्ता। * `url`: मूल छवि फ़ाइल का प्रत्यक्ष URL. **पेजिनेशन और `continuationToken`** द `continuationToken` जो प्रतिक्रिया में लौटाया गया है, आपको खोज परिणाम से मेल खाने वाले पृष्ठों के बीच स्क्रॉल करने देता है। जब `continuationToken` को किसी बाद के अनुरोध में शामिल किया जाता है, तो यह परिणामों का अगला सेट प्राप्त करता है। का उपयोग करने के लिए `continuationToken`, इसे अपने अगले API कॉल के अनुरोध बॉडी में शामिल करें। यह आपके मूल क्वेरी के आधार पर परिणामों का अगला पृष्ठ पुनः प्राप्त करेगा। **त्रुटि प्रतिक्रियाएँ** * `400` - तब लौटाया जाता है जब `query` गायब या खाली हो, या जब एक `project:` फ़िल्टर ऐसे प्रोजेक्ट को संदर्भित करता है जो आपके वर्कस्पेस से संबंधित नहीं है। * `500` - आंतरिक सर्वर त्रुटि। **प्रोजेक्ट और डेटासेट फ़िल्टर** में उपलब्ध सभी फ़िल्टरों के अतिरिक्त [ऐप के भीतर डेटासेट खोज](#web-app), वर्कस्पेस-व्यापी खोज `प्रोजेक्ट` और `डेटासेट` के लिए फ़िल्टरों का भी समर्थन करती है। उदाहरण के लिए आप इस तरह की क्वेरी का उपयोग कर सकते हैं `project:foo project:bar` ताकि उन सभी छवियों को खोजा जा सके जो दोनों प्रोजेक्टों में हैं `foo` और `bar`.\n\nइस तरह की एक क्वेरी `dataset:foo`प्रोजेक्ट में छवियाँ लौटाएगी `foo` जो लेबल की गई हैं और प्रोजेक्ट में डेटासेट में जोड़ी गई हैं। ## Python SDK `Project.search_all()` किसी प्रोजेक्ट में छवियों पर खोज परिणामों का एक पेजिनेटेड iterator लौटाता है। खोज मोडों को जोड़ा जा सकता है: क्लास द्वारा सीमित टेक्स्ट प्रॉम्प्ट, एकल बैच तक सीमित मौजूदा-छवि समानता खोज, आदि। ```python import roboflow rf = roboflow.Roboflow(api_key="YOUR_API_KEY") project = rf.workspace().project("my-detector") records = [] for page in project.search_all( prompt="desk पर एक मग", class_name="mug", in_dataset="my-detector", limit=100, fields=["id", "created", "name", "labels"], ): records.extend(page) print(len(records)) ``` ### पैरामीटर * `prompt` (str, वैकल्पिक) - प्राकृतिक-भाषा खोज प्रॉम्प्ट (CLIP embeddings के माध्यम से अर्थगत खोज)। * `like_image` (str, वैकल्पिक) - पाठ के बजाय दृश्य समानता के आधार पर खोजने के लिए छवि ID। * `tag` (str, वैकल्पिक) - केवल वे छवियाँ जिनमें यह टैग हो। * `class_name` (str, वैकल्पिक) - केवल वे छवियाँ जिनमें इस क्लास का एनोटेशन हो। * `in_dataset` (str, वैकल्पिक) - उस डेटासेट का नाम जिससे छवि संबंधित होनी चाहिए (उस डेटासेट की छवियों तक सीमित करता है, बैच / एनोटेशन-जॉब स्टेजिंग क्षेत्रों को छोड़कर)। * `batch` (bool, वैकल्पिक) और `batch_id` (str, वैकल्पिक) - किसी विशिष्ट अपलोड बैच तक सीमित करें। * `annotation_job` (bool, केवल-कीवर्ड) और `annotation_job_id` (str, केवल-कीवर्ड) - किसी विशिष्ट एनोटेशन जॉब तक सीमित करें। * `offset` (int, डिफ़ॉल्ट `0`) - पेजिनेशन ऑफ़सेट। * `limit` (int, डिफ़ॉल्ट `100`) - पृष्ठ आकार। * `फ़ील्ड्स` (list\[str], वैकल्पिक) - प्रतिक्रिया आकार कम करने के लिए प्रति परिणाम केवल सूचीबद्ध फ़ील्डों का अनुरोध करें। `search_all()` एक जेनरेटर है - प्रत्येक इटरेशन अधिकतम `limit` परिणाम देता है, और ऑफ़सेट स्वतः आगे बढ़ता है। एक बार के एकल-पृष्ठ कॉल के लिए, उपयोग करें `project.search(...)` उसी आर्गुमेंट्स के साथ। ### पूरे वर्कस्पेस में खोज वर्कस्पेस के हर प्रोजेक्ट में खोज करने के लिए, उपयोग करें `Workspace.search()` / `Workspace.search_all()`. प्रति-प्रोजेक्ट मेथड्स के विपरीत, ये एकल RoboQL `query` स्ट्रिंग (उदाहरण के लिए `"class:forklift"`, `"tag:review"`, या semantic CLIP search के लिए मुक्त-पाठ) तथा वैकल्पिक `page_size` और `फ़ील्ड्स`. प्रत्येक प्राप्त पेज परिणाम पंक्तियों की एक सूची होती है, और पंक्तियों में स्रोत प्रोजेक्ट एक `projects` फ़ील्ड। ```python records = [] for page in rf.workspace().search_all(query="class:forklift"): records.extend(page) ``` ### खोज परिणामों को डाउनलोड करने योग्य डेटासेट के रूप में निर्यात करें `Workspace.search_export()` एक खोज चलाता है और परिणामों को एक डाउनलोड करने योग्य डेटासेट (COCO / YOLO / VOC आदि) के रूप में पैकेज करता है। देखें [डेटा निर्यात (REST)](/datasets/hi/versions/dataset-versions/exporting-data.md#http-api) अंतर्निहित एंडपॉइंट के लिए। ```python path = rf.workspace().search_export( query="forklift", format="coco", location="./forklift-search", ) print(path) ``` ## CLI आप अपने वर्कस्पेस में छवियों को खोज सकते हैं [RoboQL](/datasets/hi/manage/manage-datasets/dataset-search.md) और वैकल्पिक रूप से मेल खाते परिणामों को डाउनलोड करने योग्य डेटासेट के रूप में निर्यात कर सकते हैं। ### खोज ```bash roboflow search "" ``` #### विकल्प | फ़्लैग | विवरण | | ---------- | ------------------------------------------------------ | | `--limit` | लौटाए जाने वाले अधिकतम परिणाम (डिफ़ॉल्ट: 50) | | `--cursor` | पेजिनेशन के लिए कंटिन्यूएशन टोकन | | `--fields` | शामिल किए जाने वाले फ़ील्ड्स की कॉमा से अलग की गई सूची | #### उदाहरण किसी विशिष्ट टैग वाली छवियों को खोजें: ```bash roboflow search "tag:reviewed" ``` किसी विशिष्ट क्लास वाली छवियों को खोजें: ```bash roboflow search "class:person" --limit 100 ``` ### खोज परिणाम निर्यात करें जोड़ें `--export` मेल खाती छवियों को डेटासेट के रूप में डाउनलोड करने के लिए: ```bash roboflow search "" --export -f -l ``` #### निर्यात विकल्प | फ़्लैग | विवरण | | -------------------------- | ------------------------------------------- | | `--export` | निर्यात मोड सक्षम करें | | `-f`, `--format` | एनोटेशन प्रारूप (डिफ़ॉल्ट: coco) | | `-l`, `--location` | निर्यात को सहेजने के लिए स्थानीय निर्देशिका | | `-d`, `--dataset` | किसी विशिष्ट प्रोजेक्ट तक सीमित करें | | `-g`, `--annotation-group` | किसी विशिष्ट एनोटेशन समूह तक सीमित करें | | `--name` | निर्यात के लिए वैकल्पिक नाम | | `--no-extract` | zip फ़ाइल रखें, निष्कर्षण छोड़ें | #### उदाहरण सभी समीक्षित छवियों को COCO प्रारूप में निर्यात करें: ```bash roboflow search "tag:reviewed" --export -f coco -l ./reviewed-export ``` किसी विशिष्ट प्रोजेक्ट की छवियों को YOLOv8 प्रारूप में निर्यात करें: ```bash roboflow search "class:car" --export -d my-project -f yolov8 -l ./cars ``` ### JSON आउटपुट ```bash roboflow search "tag:reviewed" --json ``` ```json { "results": [...], "total": 42, "cursor": "next-page-token" } ``` का उपयोग करें `cursor` मान पेजिनेशन के लिए: ```bash roboflow search "tag:reviewed" --cursor "next-page-token" --json ``` ## MCP सर्वर अपने AI एजेंट को [MCP सर्वर](https://docs.roboflow.com/agents/mcp-server) से कनेक्ट करें, और यह इन टूल्स से छवियाँ खोज सकता है:
टूलविवरण
images_searchकिसी प्रोजेक्ट के अंदर छवियों को खोजें।
images_workspace_searchRoboQL का उपयोग करके पूरे वर्कस्पेस में छवियों को खोजें।