> 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/workflows/hi/blocks/blocks/run-a-model/roboflow-visual-search-classifier.md).

# Roboflow Visual Search Classifier

दृश्य रूप से सबसे निकटतम छवि के लिए Roboflow वर्गीकरण प्रोजेक्ट में खोज करें और मिलान की गई छवि की वर्गीकरण एनोटेशन को एक मानक वर्गीकरण भविष्यवाणी के रूप में लौटाएँ। एकल-लेबल एनोटेशन एकल-लेबल वर्गीकरण आकार में लौटाए जाते हैं, और बहु-लेबल एनोटेशन बहु-लेबल वर्गीकरण आकार में लौटाए जाते हैं। वर्गीकरण विश्वसनीयता, सर्वोत्तम उम्मीदवार की सार्वजनिक Roboflow प्रोजेक्ट खोज score field से प्राप्त की जाती है जब वह मौजूद हो `स्कोर` फ़ील्ड जब मौजूद हो।

यह ब्लॉक एक बाहरी विज़ुअल खोज API कॉल करता है और वास्तविक-समय या उच्च-थ्रूपुट कार्यभार के लिए अभिप्रेत नहीं है। विलंबता सीमित करने के लिए, क्वेरी छवियों को डिफ़ॉल्ट रूप से आस्पेक्ट अनुपात बनाए रखते हुए 224 पिक्सेल की अधिकतम साइड लंबाई तक डाउनस्केल किया जाता है। बढ़ाएँ `max_image_size` जब सूक्ष्म विज़ुअल मिलान कम विलंबता से अधिक महत्वपूर्ण हो।

## यह ब्लॉक कैसे काम करता है

यह ब्लॉक Roboflow प्रोजेक्ट छवि खोज का उपयोग करता है:

1. वर्कफ़्लो से एक इनपुट छवि प्राप्त करता है
2. यदि इसकी बड़ी भुजा इससे अधिक हो, तो क्वेरी छवि को डाउनस्केल करता है `max_image_size`
3. क्वेरी छवि को Roboflow प्रोजेक्ट खोज में इस रूप में भेजता है `image_base64`
4. उम्मीदवार छवि फ़ील्ड और वर्गीकरण लेबल या एनोटेशन का अनुरोध करता है
5. सर्वोत्तम उम्मीदवार की एनोटेशन को अनुमानित वर्ग के रूप में उपयोग करता है
6. API को मैप करता है `स्कोर` फ़ील्ड को, जब मौजूद हो, वर्गीकरण विश्वसनीयता में मैप करता है
7. परिणाम को मानक के माध्यम से लौटाता है `predictions` वर्गीकरण आउटपुट

लक्षित प्रोजेक्ट को दृश्य खोज परिणामों में वर्गीकरण एनोटेशन डेटा प्रकट करना चाहिए। यह ब्लॉक कोई मॉडल प्रशिक्षित नहीं करता, एनोटेशन नहीं बनाता, कच्चे खोज बैकएंड प्रासंगिकता स्कोर का उपभोग नहीं करता, या दृश्य खोज अनुक्रमणिका का प्रबंधन नहीं करता।

### प्रकार पहचानकर्ता

स्टेप में निम्नलिखित पहचानकर्ता का उपयोग करें `"type"` फ़ील्ड: `roboflow_core/visual_search_classifier@v1` अपने वर्कफ़्लो में ब्लॉक को एक स्टेप के रूप में जोड़ने के लिए।

### गुण

| **नाम**          | **प्रकार** | **विवरण**                                                                                                                                                                                                       | संदर्भ |
| ---------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| `name`           | `str`      | इस स्टेप के लिए एक विशिष्ट पहचानकर्ता दर्ज करें..                                                                                                                                                               | ❌      |
| `target_project` | `str`      | खोजने के लिए Roboflow वर्गीकरण प्रोजेक्ट URL स्लग..                                                                                                                                                             | ✅      |
| `workspace`      | `str`      | वैकल्पिक Roboflow workspace URL स्लग जो लक्षित प्रोजेक्ट का स्वामी है। यदि प्रदान नहीं किया गया है, तो workspace अनुरोध API key से हल किया जाता है..                                                            | ✅      |
| `top_k`          | `int`      | दृश्य रूप से समान छवि उम्मीदवारों की संख्या जिनका अनुरोध करना है। वर्गीकरण के लिए निकटतम उम्मीदवार का उपयोग किया जाता है..                                                                                      | ✅      |
| `max_image_size` | `int`      | विज़ुअल खोज क्वेरी छवि के लिए पिक्सेल में अधिकतम साइड लंबाई। इससे बड़ी छवियों को खोज से पहले आस्पेक्ट अनुपात बनाए रखते हुए डाउनस्केल किया जाता है। उच्च विलंबता पर अधिक सूक्ष्म मिलान के लिए इस मान को बढ़ाएँ.. | ✅      |

यह **संदर्भ** स्तंभ यह इंगित करता है कि संपत्ति को वर्कफ़्लो रनटाइम में उपलब्ध गतिशील मानों के साथ पैरामीटराइज़ किया जा सकता है `वर्कफ़्लो` रनटाइम। देखें *बाइंडिंग्स* अधिक जानकारी के लिए।

### रनटाइम संगतता

`requires_internet` - air-gapped / offline deployments : यह ब्लॉक ऐसी सेवा पर निर्भर करता है जो पूरी तरह ऑफ़लाइन / air-gapped deployments से पहुँचा नहीं जा सकता।

### इनपुट और आउटपुट बाइंडिंग्स

उपलब्ध कनेक्शन उसके बाइंडिंग प्रकारों पर निर्भर करते हैं। देखें कि कौन-से बाइंडिंग प्रकार `Roboflow विज़ुअल सर्च क्लासिफ़ायर` संस्करण `v1` है।

<details>

<summary>इनपुट और आउटपुट बाइंडिंग्स</summary>

* इनपुट
  * `छवि` ([*`छवि`*](/workflows/hi/developer-guide/developer-guide/kinds/image.md)): दृश्य खोज का उपयोग करके वर्गीकृत की जाने वाली छवि..
  * `target_project` ([*`roboflow_project`*](/workflows/hi/developer-guide/developer-guide/kinds/roboflow-project.md)): खोजने के लिए Roboflow वर्गीकरण प्रोजेक्ट URL स्लग..
  * `workspace` ([*`string`*](/workflows/hi/developer-guide/developer-guide/kinds/string.md)): वैकल्पिक Roboflow workspace URL स्लग जो लक्षित प्रोजेक्ट का स्वामी है। यदि प्रदान नहीं किया गया है, तो workspace अनुरोध API key से हल किया जाता है..
  * `top_k` ([*`पूर्णांक`*](/workflows/hi/developer-guide/developer-guide/kinds/integer.md)): दृश्य रूप से समान छवि उम्मीदवारों की संख्या जिनका अनुरोध करना है। वर्गीकरण के लिए निकटतम उम्मीदवार का उपयोग किया जाता है..
  * `max_image_size` ([*`पूर्णांक`*](/workflows/hi/developer-guide/developer-guide/kinds/integer.md)): विज़ुअल खोज क्वेरी छवि के लिए पिक्सेल में अधिकतम साइड लंबाई। इससे बड़ी छवियों को खोज से पहले आस्पेक्ट अनुपात बनाए रखते हुए डाउनस्केल किया जाता है। उच्च विलंबता पर अधिक सूक्ष्म मिलान के लिए इस मान को बढ़ाएँ..
* आउटपुट
  * `predictions` ([`classification_prediction`](/workflows/hi/developer-guide/developer-guide/kinds/classification-prediction.md)): क्लासिफ़ायर से प्राप्त पूर्वानुमान।
  * `inference_id` ([`inference_id`](/workflows/hi/developer-guide/developer-guide/kinds/inference-id.md)): Inference पहचानकर्ता।
  * `candidate_found` ([`boolean`](/workflows/hi/developer-guide/developer-guide/kinds/boolean.md)): बूलियन फ़्लैग.
  * `class_found` ([`boolean`](/workflows/hi/developer-guide/developer-guide/kinds/boolean.md)): बूलियन फ़्लैग.
  * `best_candidate` ([`शब्दकोश`](/workflows/hi/developer-guide/developer-guide/kinds/dictionary.md)): शब्दकोश।
  * `candidates` ([`list_of_values`](/workflows/hi/developer-guide/developer-guide/kinds/list-of-values.md)): किसी भी प्रकार के मानों की सूची।
  * `best_candidate_image` ([`छवि`](/workflows/hi/developer-guide/developer-guide/kinds/image.md)): कार्यप्रवाहों में इमेज।
  * `visual_search_score` ([`float`](/workflows/hi/developer-guide/developer-guide/kinds/float.md)): फ्लोट मान।
  * `error_status` ([`boolean`](/workflows/hi/developer-guide/developer-guide/kinds/boolean.md)): बूलियन फ़्लैग.
  * `message` ([`string`](/workflows/hi/developer-guide/developer-guide/kinds/string.md)): स्ट्रिंग मान.

</details>

<details>

<summary>उदाहरण JSON परिभाषा</summary>

```json
{
	    "name": "<your_step_name_here>",
	    "type": "roboflow_core/visual_search_classifier@v1",
	    "image": "$inputs.image",
	    "target_project": "reference-images",
	    "workspace": "my-workspace",
	    "top_k": 1,
	    "max_image_size": 224
	}
```

</details>