Image Operations - Analyze Image

  • 참조
서비스:
Azure AI Services
API 버전:
2023-10-01

이미지 분석
잠재적으로 유해한 이미지 콘텐츠를 분석하기 위한 동기 API입니다. 현재 증오, 셀프 하름, 성적 및 폭력의 네 가지 범주를 지원합니다.

POST {endpoint}/contentsafety/image:analyze?api-version=2023-10-01

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
endpoint
 path True

string

지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름, 예: https://.cognitiveservices.azure.com).
api-version
 query True

string

이 작업에 사용할 API 버전입니다.

요청 본문

Name 필수 형식 Description
image True

ImageData

분석할 이미지입니다.
categories

ImageCategory[]

범주가 분석됩니다. 할당되지 않은 경우 범주에 대한 기본 분석 결과 집합이 반환됩니다.
outputType

AnalyzeImageOutputType

이는 이미지 분석 출력의 유형을 나타냅니다. 값이 할당되지 않은 경우 기본값은 "FourSeverityLevels"입니다.

응답

Name 형식 Description
200 OK

AnalyzeImageResult

요청이 성공했습니다.
Other Status Codes

Azure.Core.Foundations.ErrorResponse

예기치 않은 오류 응답입니다.

헤더

x-ms-error-code: string

보안

Ocp-Apim-Subscription-Key

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

OAuth2Auth

형식: oauth2
Flow: application
토큰 URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

범위

Name Description
https://cognitiveservices.azure.com/.default

예제

Analyze Image

샘플 요청

POST {endpoint}/contentsafety/image:analyze?api-version=2023-10-01

{
  "image": {
    "content": "Y29udGVudDE="
  }
}

샘플 응답

상태 코드:
200 
{
  "categoriesAnalysis": [
    {
      "category": "Hate",
      "severity": 0
    },
    {
      "category": "SelfHarm",
      "severity": 0
    },
    {
      "category": "Sexual",
      "severity": 0
    },
    {
      "category": "Violence",
      "severity": 2
    }
  ]
}

정의

Name Description
AnalyzeImageOptions

이미지 분석 요청입니다.
AnalyzeImageOutputType

이는 이미지 분석 출력의 유형을 나타냅니다. 값이 할당되지 않은 경우 기본값은 "FourSeverityLevels"입니다.
AnalyzeImageResult

이미지 분석 응답입니다.
Azure.Core.Foundations.Error

오류 개체입니다.
Azure.Core.Foundations.ErrorResponse

오류 세부 정보가 포함된 응답입니다.
Azure.Core.Foundations.InnerError

오류에 대한 보다 구체적인 정보를 포함하는 개체입니다. Microsoft One API 지침에 따라 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
ImageCategoriesAnalysis

이미지 분석 결과입니다.
ImageCategory

이미지 콘텐츠 분석에서 지원되는 피해 범주입니다.
ImageData

이미지는 base64로 인코딩된 바이트 또는 Blob URL일 수 있습니다. 이러한 옵션 중 하나만 선택할 수 있습니다. 둘 다 제공되면 요청이 거부됩니다. 최대 이미지 크기는 2048 x 2048 픽셀이며 최소 이미지 크기는 50 x 50 픽셀이지만 4MB를 초과해서는 안됩니다.

AnalyzeImageOptions

이미지 분석 요청입니다.

Name 형식 Default value Description
categories

ImageCategory[]

범주가 분석됩니다. 할당되지 않은 경우 범주에 대한 기본 분석 결과 집합이 반환됩니다.
image

ImageData

분석할 이미지입니다.
outputType

AnalyzeImageOutputType

FourSeverityLevels

이는 이미지 분석 출력의 유형을 나타냅니다. 값이 할당되지 않은 경우 기본값은 "FourSeverityLevels"입니다.

AnalyzeImageOutputType

이는 이미지 분석 출력의 유형을 나타냅니다. 값이 할당되지 않은 경우 기본값은 "FourSeverityLevels"입니다.

Name 형식 Description
FourSeverityLevels

string

4개 수준의 출력 심각도 값은 0,2,4,6일 수 있습니다.

AnalyzeImageResult

이미지 분석 응답입니다.

Name 형식 Description
categoriesAnalysis

ImageCategoriesAnalysis[]

범주에 대한 분석 결과입니다.

Azure.Core.Foundations.Error

오류 개체입니다.

Name 형식 Description
code

string

서버에서 정의한 오류 코드 집합 중 하나입니다.
details

Azure.Core.Foundations.Error[]

이 보고된 오류로 이어진 특정 오류에 대한 세부 정보 배열입니다.
innererror

Azure.Core.Foundations.InnerError

오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.
message

string

사람이 읽을 수 있는 오류 표현입니다.
target

string

오류의 대상입니다.

Azure.Core.Foundations.ErrorResponse

오류 세부 정보가 포함된 응답입니다.

Name 형식 Description
error

Azure.Core.Foundations.Error

오류 개체입니다.

Azure.Core.Foundations.InnerError

오류에 대한 보다 구체적인 정보를 포함하는 개체입니다. Microsoft One API 지침에 따라 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Name 형식 Description
code

string

서버에서 정의한 오류 코드 집합 중 하나입니다.
innererror

Azure.Core.Foundations.InnerError

내부 오류입니다.

ImageCategoriesAnalysis

이미지 분석 결과입니다.

Name 형식 Description
category

ImageCategory

이미지 분석 범주입니다.
severity

integer

입력 콘텐츠의 심각도에 따라 값이 증가합니다. 이 필드의 값은 요청에 지정된 출력 형식에 따라 결정됩니다. 출력 형식은 'FourSeverityLevels'일 수 있으며 출력 값은 0, 2, 4, 6일 수 있습니다.

ImageCategory

이미지 콘텐츠 분석에서 지원되는 피해 범주입니다.

Name 형식 Description
Hate

string

이미지에 대한 피해 범주 - 증오.
SelfHarm

string

이미지의 피해 범주 - SelfHarm입니다.
Sexual

string

이미지에 대한 피해 범주 - 성적.
Violence

string

이미지의 피해 범주 - 폭력.

ImageData

이미지는 base64로 인코딩된 바이트 또는 Blob URL일 수 있습니다. 이러한 옵션 중 하나만 선택할 수 있습니다. 둘 다 제공되면 요청이 거부됩니다. 최대 이미지 크기는 2048 x 2048 픽셀이며 최소 이미지 크기는 50 x 50 픽셀이지만 4MB를 초과해서는 안됩니다.

Name 형식 Description
blobUrl

string

이미지의 Blob URL입니다.
content

string

이미지의 Base64 인코딩입니다.