Image Analysis - Segment

서비스:

Cognitive Services - Computer Vision

API 버전:

2023-02-01-preview

입력 이미지를 분석합니다. 요청에는 콘텐츠 형식 ['image/*', 'application/octet-stream']이 있는 이미지 스트림 또는 이미지 스트림을 검색하는 데 사용할 URL 속성이 포함된 JSON 페이로드가 포함됩니다. 픽셀 값이 분석 모드에 따라 달라지는 콘텐츠 형식 'image/png'의 이미지 스트림이 반환됩니다. 반환된 이미지는 모드의 입력 이미지인 foregroundMatting과 동일한 차원을 둡니다. 반환된 이미지는 입력 이미지와 동일한 가로 세로 비율 및 크기가 모드의 경우 최대 16메가픽셀로 제한됩니다. backgroundRemoval.

POST /imageanalysis:segment?api-version=2023-02-01-preview

선택적 매개 변수:

POST /imageanalysis:segment?mode={mode}&api-version=2023-02-01-preview

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
api-version	query	True	string	요청된 API 버전입니다.
mode	query		SegmentationModeApiModel	요청된 분석 모드입니다. backgroundRemoval, foregroundMatting 중 하나입니다.

요청 본문

Name	필수	형식	Description
url	True	string	이미지의 공개적으로 연결할 수 있는 URL입니다.

응답

Name	형식	Description
200 OK	file	성공 Media Types: "image/png", "application/json"
Other Status Codes	ErrorResponse	오류 Media Types: "image/png", "application/json" 헤더 x-ms-error-code: string

예제

Segment_BackgroundRemoval_FromImageUrl

Segment_ForegroundMatting_FromImageUrl

Segment_BackgroundRemoval_FromImageUrl

Sample request

HTTP

POST /imageanalysis:segment?mode=backgroundRemoval&api-version=2023-02-01-preview

{
  "url": "{image url}"
}

Sample response

Status code:

200

"Ynl0ZXM="

Segment_ForegroundMatting_FromImageUrl

Sample request

HTTP

POST /imageanalysis:segment?mode=foregroundMatting&api-version=2023-02-01-preview

{
  "url": "{image url}"
}

Sample response

Status code:

200

"Ynl0ZXM="

정의

Name	Description
ErrorResponse	오류가 발생할 때 응답이 반환됩니다.
ErrorResponseDetails	오류 정보입니다.
ErrorResponseInnerError	자세한 오류입니다.
ImageUrl	분석할 이미지를 가리키는 URL이 있는 JSON 문서입니다.
SegmentationModeApiModel	요청된 분석 모드입니다. backgroundRemoval, foregroundMatting 중 하나입니다.

ErrorResponse

오류가 발생할 때 응답이 반환됩니다.

Name	형식	Description
error	ErrorResponseDetails	오류 정보입니다.

ErrorResponseDetails

오류 정보입니다.

Name	형식	Description
code	string	오류 코드
details	ErrorResponseDetails[]	자세한 오류 목록입니다.
innererror	ErrorResponseInnerError	자세한 오류입니다.
message	string	오류 메시지입니다.
target	string	오류의 대상입니다.

ErrorResponseInnerError

자세한 오류입니다.

Name	형식	Description
code	string	오류 코드
innererror	ErrorResponseInnerError	자세한 오류입니다.
message	string	오류 메시지입니다.

ImageUrl

분석할 이미지를 가리키는 URL이 있는 JSON 문서입니다.

Name	형식	Description
url	string	이미지의 공개적으로 연결할 수 있는 URL입니다.

SegmentationModeApiModel

요청된 분석 모드입니다. backgroundRemoval, foregroundMatting 중 하나입니다.

Name	형식	Description
backgroundRemoval	string
foregroundMatting	string