로보플로 비주얼 검색

로보플로 프로젝트에서 시각적으로 유사한 이미지 후보를 찾습니다.

입력 이미지와 비슷하게 보이는 이미지를 Roboflow 프로젝트에서 검색하고 가장 가까운 후보와 메타데이터를 반환합니다.

이 블록의 작동 방식

이 블록은 기존 Roboflow 프로젝트 이미지 검색 API를 사용합니다:

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

2. 이미지를 Roboflow 프로젝트 검색에 보냅니다 image_base64

3. 이미지 URL, 태그, 사용자 메타데이터와 같은 유용한 필드를 요청합니다

4. 최적 후보, 최적 후보 이미지, 메타데이터, 태그 및 상위 후보 목록을 반환합니다

대상 프로젝트에는 이미 업로드된 이미지가 포함되어 있어야 합니다. Roboflow는 플랫폼의 기존 이미지 인덱싱 파이프라인을 사용해 이러한 이미지를 시각적 검색용으로 인덱싱합니다. 이 블록은 이미지를 생성하거나, 메타데이터를 업데이트하거나, 인덱스를 관리하지 않습니다.

유형 식별자

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

속성

이름	유형	설명	참조
name	str	이 단계에 대한 고유 식별자를 입력하세요..	❌
workspace	str	대상 프로젝트를 소유한 Roboflow 작업공간 URL 슬러그..	✅
target_project	str	검색할 Roboflow 프로젝트 URL 슬러그..	✅
top_k	정수	반환할 시각적으로 유사한 이미지 후보 수입니다. 가장 가까운 후보만 필요할 때는 1을 사용하세요..	✅

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

런타임 호환성

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

입력 및 출력 바인딩

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

입력 및 출력 바인딩

• 입력

  • 이미지 (이미지): 시각적 검색 쿼리로 사용할 이미지..

  • workspace (string): 대상 프로젝트를 소유한 Roboflow 작업공간 URL 슬러그..

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

  • top_k (정수): 반환할 시각적으로 유사한 이미지 후보 수입니다. 가장 가까운 후보만 필요할 때는 1을 사용하세요..

• 출력

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

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

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

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

  • message (string): 문자열 값.

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

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

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

예시 JSON 정의

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