Roboflow 시각 검색 분류기

가장 시각적으로 유사한 주석 이미지를 찾아 이미지를 분류합니다.

시각적으로 가장 가까운 이미지를 찾기 위해 Roboflow 분류 프로젝트를 검색하고, 일치한 이미지의 분류 주석을 표준 분류 예측으로 반환합니다. 단일 레이블 주석은 단일 레이블 분류 형식으로 반환되고, 다중 레이블 주석은 다중 레이블 분류 형식으로 반환됩니다. 분류 신뢰도는 가장 좋은 후보의 공개 Roboflow 프로젝트 검색 점수 필드에서 가져옵니다 점수 필드가 있을 경우.

이 블록은 외부 시각 검색 API 호출을 수행하며, 실시간 또는 대규모 처리 작업에는 적합하지 않습니다. 지연 시간을 제한하기 위해, 기본적으로 쿼리 이미지는 가로세로 비율을 유지한 채 최대 변 길이 224픽셀로 축소됩니다. 늘리기 max_image_size 더 낮은 지연 시간보다 더 정밀한 시각적 매칭이 더 중요할 때.

이 블록의 작동 방식

이 블록은 Roboflow 프로젝트 이미지 검색을 사용합니다:

1. 워크플로우에서 입력 이미지를 받습니다

2. 쿼리 이미지의 긴 변이 초과하면 축소합니다 max_image_size

3. 쿼리 이미지를 Roboflow 프로젝트 검색에 다음으로 보냅니다: image_base64

4. 후보 이미지 필드와 분류 레이블 또는 주석을 요청합니다

5. 가장 좋은 후보의 주석을 예측된 클래스로 사용합니다

6. API의 점수 필드를 분류 신뢰도로 매핑합니다. 해당 필드가 있을 경우

7. 표준을 통해 결과를 반환합니다 예측 분류 출력

대상 프로젝트는 시각 검색 결과에서 분류 주석 데이터를 노출해야 합니다. 이 블록은 모델을 학습하지 않으며, 주석을 생성하지도 않고, 원시 검색 백엔드 관련성 점수를 사용하지도 않으며, 시각 검색 인덱스를 관리하지도 않습니다.

유형 식별자

단계에서 다음 식별자를 사용하세요 "type" 필드: roboflow_core/visual_search_classifier@v1 워크플로우에 이 블록을 단계로 추가하려면.

속성

이름	유형	설명	참조
name	str	이 단계에 대한 고유 식별자를 입력하세요..	❌
target_project	str	검색할 Roboflow 분류 프로젝트 URL 슬러그..	✅
workspace	str	대상 프로젝트를 소유한 Roboflow 워크스페이스 URL 슬러그입니다. 제공하지 않으면 요청 API 키에서 워크스페이스가 확인됩니다..	✅
top_k	정수	요청할 시각적으로 유사한 이미지 후보의 수입니다. 가장 가까운 후보가 분류에 사용됩니다..	✅
max_image_size	정수	시각 검색 쿼리 이미지의 최대 변 길이(픽셀)입니다. 이보다 큰 이미지는 검색 전에 가로세로 비율을 유지한 채 축소됩니다. 더 높은 지연 시간으로 더 정밀한 매칭을 원하면 이 값을 늘리세요..	✅

이 참조 열은 워크플로우 런타임에서 사용 가능한 동적 값으로 속성을 매개변수화할 수 있는 가능성을 나타냅니다 워크플로우 런타임입니다. 자세한 내용은 바인딩 을 참조하세요.

런타임 호환성

인터넷 필요 - 에어갭 / 오프라인 배포 : 이 블록은 완전히 오프라인 / 에어갭된 배포에서는 접근할 수 없는 서비스에 의존합니다.

입력 및 출력 바인딩

사용 가능한 연결은 바인딩 유형에 따라 달라집니다. 어떤 바인딩 유형인지 확인하세요 Roboflow 시각적 검색 분류기 버전 v1 을 가지고 있는지.

입력 및 출력 바인딩

• 입력

  • 이미지 (이미지): 시각 검색을 사용하여 분류할 이미지..

  • target_project (roboflow_project): 검색할 Roboflow 분류 프로젝트 URL 슬러그..

  • workspace (string): 대상 프로젝트를 소유한 Roboflow 워크스페이스 URL 슬러그입니다. 제공하지 않으면 요청 API 키에서 워크스페이스가 확인됩니다..

  • top_k (정수): 요청할 시각적으로 유사한 이미지 후보의 수입니다. 가장 가까운 후보가 분류에 사용됩니다..

  • max_image_size (정수): 시각 검색 쿼리 이미지의 최대 변 길이(픽셀)입니다. 이보다 큰 이미지는 검색 전에 가로세로 비율을 유지한 채 축소됩니다. 더 높은 지연 시간으로 더 정밀한 매칭을 원하면 이 값을 늘리세요..

• 출력

  • 예측 (classification_prediction): 분류기의 예측 결과.

  • inference_id (inference_id): 추론 식별자.

  • candidate_found (boolean): 불리언 플래그.

  • class_found (boolean): 불리언 플래그.

  • best_candidate (딕셔너리): 딕셔너리.

  • candidates (list_of_values): 모든 유형의 값 목록.

  • best_candidate_image (이미지): 워크플로의 이미지입니다.

  • visual_search_score (float): 실수 값입니다.

  • error_status (boolean): 불리언 플래그.

  • message (string): 문자열 값.

예시 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
	}