For the complete documentation index, see llms.txt. This page is also available as Markdown.

키포인트 감지

Roboflow에서 호스팅되는 객체 감지 모델에서 추론을 실행합니다.

호스팅된 API를 사용하여 Python으로 추론을 실행하려면 다음을 사용하세요. roboflow Python 패키지:

from roboflow import Roboflow
rf = Roboflow(api_key="API_KEY")
project = rf.workspace().project("MODEL_ENDPOINT")
model = project.version(VERSION).model

# 로컬 이미지에서 추론
print(model.predict("your_image.jpg", confidence=40, overlap=30).json())

# 예측 결과를 시각화
# model.predict("your_image.jpg", confidence=40, overlap=30).save("prediction.jpg")

# 다른 곳에 호스팅된 이미지에서 추론
# print(model.predict("URL_OF_YOUR_IMAGE", hosted=True, confidence=40, overlap=30).json())

응답 객체 형식

호스팅된 API 추론 경로는 JSON 예측 배열을 포함한 객체입니다. 각 예측에는 다음 속성이 있습니다:

  • x = 감지된 객체의 가로 중심점

  • y = 감지된 객체의 세로 중심점

  • width = 경계 상자의 너비

  • height = 경계 상자의 높이

  • class = 감지된 객체의 클래스 레이블

  • confidence = 감지된 객체의 레이블과 위치 좌표가 올바르다는 모델의 신뢰도

  • 키포인트 = 키포인트 예측 배열

    • x = 키포인트의 가로 중심(이미지 왼쪽 상단 모서리를 기준으로)

    • y = 키포인트의 세로 중심(이미지 왼쪽 상단 모서리를 기준으로)

    • class_name = 키포인트 이름

    • class_id = 키포인트의 ID, skeleton에 매핑됩니다 정점 version record에서 정점 색상과 skeleton edge를 매핑하기 위해, Project Version 보기

    • confidence = 키포인트가 올바른 위치에 있고 보이는지(가려지거나 삭제되지 않았는지)에 대한 신뢰도

REST API에서 가져온 예시 응답 객체는 다음과 같습니다:

해당 image 속성에는 추론에 사용하기 위해 전송된 이미지의 높이와 너비가 포함됩니다. 경계 상자 계산에 이러한 값을 사용해야 할 수도 있습니다.

Inference API 매개변수

Inference API 사용하기

POST https://serverless.roboflow.com/:datasetSlug/:versionNumber

base64 인코딩된 이미지를 모델 엔드포인트에 직접 POST할 수 있습니다. 또는 URL을 image 쿼리 문자열의 매개변수로 전달할 수 있습니다. 이미지가 이미 다른 곳에 호스팅되어 있다면.

경로 매개변수

이름
유형
설명

datasetSlug

string

데이터셋 이름의 URL 안전 버전입니다. 메인 프로젝트 보기의 URL을 보거나, 모델을 학습한 후 데이터셋 버전의 학습 결과 섹션에 있는 "Get curl command" 버튼을 클릭하면 웹 UI에서 찾을 수 있습니다.

버전

number

데이터셋 버전을 식별하는 버전 번호입니다

쿼리 매개변수

이름
유형
설명

image

string

추가할 이미지의 URL입니다. 이미지가 다른 곳에 호스팅되어 있는 경우 사용하세요. (요청 본문에 base64로 인코딩된 이미지를 POST하지 않는 경우 필수입니다.) 참고: URL 인코딩을 잊지 마세요.

클래스

string

예측을 특정 클래스의 예측으로만 제한합니다. 쉼표로 구분된 문자열로 제공하세요. 예시: dog,cat 기본값: 없음(모든 클래스 표시)

겹침

number

같은 클래스의 경계 상자 예측이 하나의 상자로 결합되기 전에 겹칠 수 있는 최대 비율(0-100 척도)입니다. 기본값: 30

confidence

number

반환되는 예측에 대한 임계값으로, 0-100 척도입니다. 숫자가 낮을수록 더 많은 예측이 반환됩니다. 숫자가 높을수록 더 적은 고신뢰 예측이 반환됩니다. 기본값: 40

스트로크

number

예측 주위에 표시되는 경계 상자의 너비(픽셀 단위)입니다(다음 경우에만 영향을 줍니다 형식image). 기본값: 1

레이블

boolean

예측에 텍스트 레이블을 표시할지 여부입니다(다음 경우에만 영향을 줍니다 형식image). 기본값: false

형식

string

json - JSON 예측 배열을 반환합니다. (response format 탭을 참조하세요). image - 주석이 달린 예측 결과가 포함된 이미지를 binary blob으로 반환하며, Content-Typeimage/jpeg. image_and_json - base64의 visualization 필드를 포함한 JSON 예측 배열을 반환합니다. 기본값: json

api_key

string

워크스페이스 API 설정 페이지에서 얻은 API 키

요청 본문

이름
유형
설명

string

base64로 인코딩된 이미지입니다. (쿼리 매개변수에 이미지 URL을 전달하지 않는 경우 필수입니다.)

마지막 업데이트

도움이 되었나요?