Universe 검색

Python SDK로 Roboflow Universe의 프로젝트, 데이터셋, 모델을 프로그래밍 방식으로 검색합니다.

Python SDK

Roboflow Universe 커뮤니티가 공유한 프로젝트, 데이터셋, 모델의 공개 카탈로그입니다. Python SDK는 Universe를 프로그래밍 방식으로 검색하는 데 사용할 수 있는 저수준 어댑터를 제공합니다.

검색

from roboflow.adapters import rfapi

results = rfapi.search_universe(
    "vehicles",
    api_key="YOUR_API_KEY",
    project_type="object-detection",  # 선택 사항
    limit=12,
    page=1,
)

for project in results.get("results", []):
    print(project["workspace"], project["project"], project["name"])

매개변수

• query (str, 위치 인자) - 검색어.

• api_key (str, 키워드 전용) - Roboflow API 키입니다. Universe 속도 제한에 필요합니다.

• project_type (str, 키워드 전용, 선택 사항) - 프로젝트 유형으로 필터링합니다. 다음 중 하나: object-detection, 분류, instance-segmentation, semantic-segmentation, keypoint-detection.

• limit (int, 키워드 전용, 기본값 12) - 페이지 크기.

• page (int, 키워드 전용, 기본값 1) - 1부터 시작하는 페이지 번호.

응답

이 함수는 JSON 응답 본문을 그대로 반환합니다. 각 결과 항목에는 workspace 슬러그, project 슬러그, 프로젝트 이름, 유형, 이미지 수, 그리고 (학습된 모델의 경우) 바로 Roboflow().workspace(...).project(...).version(...).model.predict().

에 연결할 수 있는 버전 메타데이터가 포함됩니다. thumbnail 및 annotationThumbnail 필드도 포함됩니다(둘 다 null 허용 문자열). thumbnail 는 프로젝트의 썸네일 이미지 URL이며, annotationThumbnail 는 프로젝트의 주석이 달린 샘플 이미지 URL입니다. 어느 필드든 null 해당 데이터가 없을 때는

Universe 모델을 직접 실행하기

search_universe를 사용해 모델을 찾았다면 search_universe와 마찬가지로 이 모델에서 추론을 실행할 수 있습니다:

import roboflow

rf = roboflow.Roboflow(api_key="YOUR_API_KEY")
project = rf.workspace("roboflow-100").project("poker-cards-cxcvz")
model = project.version(1).model

predictions = model.predict("hand.jpg", confidence=50, overlap=30).json()

참조: 이미지에서 모델 실행 에 대한 자세한 내용은 predict() 를 확인하세요.

CLI

공개 데이터셋과 모델을 Roboflow Universe 명령줄에서 검색할 수 있습니다.

Universe 검색

roboflow universe search "hard hats"

roboflow universe search "hard hats" --json

옵션

플래그	설명
--type	필터 기준: 데이터셋 또는 model
--limit	최대 결과 수(기본값: 12)

예시

데이터셋만 검색:

roboflow universe search "safety vest" --type dataset

결과 수 제한:

roboflow universe search "license plates" --type model --limit 5

JSON 출력

사용하세요 --json 파이프 처리해도 안전한 구조화된 출력을 위해:

roboflow universe search "hard hats" --json | jq '.[].name'
roboflow universe search "cars" --type dataset --limit 3 --json

종료 코드: 0 = 성공, 1 = 오류, 2 = 인증 오류.