Detect Objects In Stream - Detect Objects In Stream

서비스:

Azure AI Services

API 버전:

3.2

지정된 이미지에서 개체 검색을 수행합니다. (1) 이미지 업로드 또는 (2) 이미지 URL 지정 등 두 가지 입력 방법이 지원됩니다. 성공적인 응답은 JSON으로 반환됩니다. 요청이 실패하면 응답에 오류 코드와 잘못된 사항을 이해하는 데 도움이 되는 메시지가 포함됩니다.

POST {Endpoint}/vision/v3.2/detect

선택적 매개 변수:

POST {Endpoint}/vision/v3.2/detect?overload=stream&model-version={model-version}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
Endpoint	path	True	string	지원되는 Cognitive Services 엔드포인트.
model-version	query		string pattern: ^(latest|\d{4}-\d{2}-\d{2})(-preview)?$	AI 모델의 버전을 지정하는 선택적 매개 변수입니다. 허용되는 값은 "latest", "2021-04-01", "2021-05-01"입니다. 기본값은 "latest"입니다.

요청 헤더

Media Types: "application/octet-stream", "multipart/form-data"

Name	필수	형식	Description
Ocp-Apim-Subscription-Key	True	string

요청 본문

Media Types: "application/octet-stream", "multipart/form-data"

Name	형식	Description
Image	object (file)	이미지 스트림입니다.

응답

Name	형식	Description
200 OK	DetectResult	응답에는 JSON 형식의 검색된 개체가 포함됩니다.
Other Status Codes	ComputerVisionErrorResponse	오류 응답입니다.

보안

Ocp-Apim-Subscription-Key

형식: apiKey
In(다음 안에): header

예제

Successful DetectObjects request

샘플 요청

HTTP

POST https://westus.api.cognitive.microsoft.com/vision/v3.2/detect?overload=stream


"{binary}"

샘플 응답

상태 코드:

200

{
  "objects": [
    {
      "rectangle": {
        "x": 0,
        "y": 0,
        "w": 50,
        "h": 50
      },
      "object": "tree",
      "confidence": 0.9,
      "parent": {
        "object": "plant",
        "confidence": 0.95
      }
    }
  ],
  "requestId": "1ad0e45e-b7b4-4be3-8042-53be96103337",
  "metadata": {
    "width": 100,
    "height": 100,
    "format": "Jpeg"
  },
  "modelVersion": "2021-04-01"
}

정의

Name	Description
BoundingRect	이미지 내 영역의 경계 상자입니다.
ComputerVisionError	API 요청 오류입니다.
ComputerVisionErrorCodes	오류 코드입니다.
ComputerVisionErrorResponse	API 오류 응답입니다.
ComputerVisionInnerError	API 요청 오류에 대한 세부 정보입니다.
ComputerVisionInnerErrorCodeValue	오류 코드입니다.
DetectedObject	이미지에서 검색된 개체입니다.
DetectResult	DetectImage 호출의 결과입니다.
ImageMetadata	이미지 메타데이터.
ObjectHierarchy	이미지 내에서 검색된 개체입니다.

BoundingRect

Object

이미지 내 영역의 경계 상자입니다.

Name	형식	Description
h	integer (int32)	영역의 왼쪽 위 지점에서 측정된 높이(픽셀)입니다.
w	integer (int32)	영역의 왼쪽 위 지점에서 측정된 너비(픽셀)입니다.
x	integer (int32)	영역 왼쪽 위 점의 X 좌표(픽셀)입니다.
y	integer (int32)	영역 왼쪽 위 점의 Y 좌표(픽셀)입니다.

ComputerVisionError

Object

API 요청 오류입니다.

Name	형식	Description
code	ComputerVisionErrorCodes	오류 코드입니다.
innererror	ComputerVisionInnerError	내부 오류에는 보다 구체적인 정보가 포함됩니다.
message	string	서비스에서 보고한 오류를 설명하는 메시지입니다.

ComputerVisionErrorCodes

열거형

오류 코드입니다.

값	Description
InvalidRequest
InvalidArgument
InternalServerError
ServiceUnavailable

ComputerVisionErrorResponse

Object

API 오류 응답입니다.

Name	형식	Description
error	ComputerVisionError	오류 내용입니다.

ComputerVisionInnerError

Object

API 요청 오류에 대한 세부 정보입니다.

Name	형식	Description
code	ComputerVisionInnerErrorCodeValue	오류 코드입니다.
message	string	오류 메시지입니다.

ComputerVisionInnerErrorCodeValue

열거형

오류 코드입니다.

값	Description
InvalidImageFormat
UnsupportedMediaType
InvalidImageUrl
NotSupportedFeature
NotSupportedImage
Timeout
InternalServerError
InvalidImageSize
BadArgument
DetectFaceError
NotSupportedLanguage
InvalidThumbnailSize
InvalidDetails
InvalidModel
CancelledRequest
NotSupportedVisualFeature
FailedToProcess
Unspecified
StorageException

DetectedObject

Object

이미지에서 검색된 개체입니다.

Name	형식	Description
confidence	number (double)	이미지의 개체를 0에서 1 사이의 값으로 관찰한 신뢰도 점수입니다.
object	string	개체의 레이블입니다.
parent	ObjectHierarchy	분류 관점에서 부모 개체입니다. 부모 개체는 이 개체의 보다 일반적인 형태입니다. 예를 들어 '불독'에는 'dog'의 부모가 있습니다.
rectangle	BoundingRect	검색된 개체의 대략적인 위치입니다.

DetectResult

Object

DetectImage 호출의 결과입니다.

Name	형식	Description
metadata	ImageMetadata	이미지 메타데이터.
modelVersion	string pattern: ^(latest|\d{4}-\d{2}-\d{2})(-preview)?$	AI 모델의 버전입니다.
objects	DetectedObject[]	검색된 개체의 배열입니다.
requestId	string	REST API 요청의 ID입니다.

ImageMetadata

Object

이미지 메타데이터.

Name	형식	Description
format	string	이미지 형식입니다.
height	integer (int32)	이미지 높이(픽셀)입니다.
width	integer (int32)	이미지 너비(픽셀)입니다.

ObjectHierarchy

Object

이미지 내에서 검색된 개체입니다.

Name	형식	Description
confidence	number (double)	이미지의 개체를 0에서 1 사이의 값으로 관찰한 신뢰도 점수입니다.
object	string	개체의 레이블입니다.
parent	ObjectHierarchy	분류 관점에서 부모 개체입니다. 부모 개체는 이 개체의 보다 일반적인 형태입니다. 예를 들어 '불독'에는 'dog'의 부모가 있습니다.