이미지 유해성 진단

Classic/VPC 환경에서 이용 가능합니다.

공개 URL 또는 Base64 인코딩된 데이터를 사용하여 이미지의 유해성을 탐지합니다.

요청 헤더

CLOVA GreenEye API에서 공통으로 사용하는 헤더에 대한 정보는 CLOVA GreenEye 공통 헤더를 참조해 주십시오.

요청 경로 파라미터

파라미터에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`domainId`	String	Required	도메인 아이디 콘솔의 Domain > API 연동 설정에서 Invoke URL을 통해 확인 가능
`signature`	String	Required	서명 콘솔의 Domain > API 연동 설정에서 Invoke URL을 통해 확인 가능

참고

요청 경로 파라미터는 사용자마다 다른 문자열로 구성되어 있습니다. 네이버 클라우드 플랫폼 콘솔에서 서비스 이용 신청 및 도메인 생성을 완료한 후, Domain의 API 연동 설정에서 제공되는 APIGW Invoke URL에서 확인할 수 있습니다. 자세한 방법은 CLOVA GreenEye 사용 가이드를 참조해 주십시오.

요청 바디

요청 바디에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`version`	String	Required	CLOVA GreenEye 서비스 버전 `V1`
`requestId`	String	Optional	API 호출 UUID 필요한 경우, 임의의 값 입력
`timestamp`	Number	Required	요청 시간의 Timestamp 값
`images`	Array	Required	이미지 정보 호출당 1개의 이미지만 입력 가능

`images`

images에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`name`	String	Required	이미지 이름 이미지 식별 및 응답 결과 확인 시 사용
`url`	String	Conditional	이미지를 가져올 수 있는 공개 URL `url`과 `data` 중 입력 필수 `url`과 `data` 모두 입력 시 `url` 무시하고 `data` 적용
`data`	String	Conditional	Base64로 인코딩한 이미지 바이트 `url`과 `data` 중 입력 필수 `url`과 `data` 모두 입력 시 `url` 무시하고 `data` 적용

요청 예시

요청 예시는 다음과 같습니다.

curl --location --request POST 'https://clovagreeneye.apigw.ntruss.com/custom/v1/{domainId}/{signature}/predict' \
--header 'X-GREEN-EYE-SECRET: {Client Secret}' \
--header 'Content-Type: application/json' \
--data '{
    "version": "V1",
    "requestId": {RequestId},
    "timestamp": 1724750100000,
    "images": [
        {
            "name": "20191025_155202",
            "url": "https://kr.object.ncloudstorage.com/bk1/20191025_155202.jpg"
        }
    ]
}'

응답

응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`version`	String	-	CLOVA GreenEye 서비스 버전
`requestId`	String	-	요청 UUID
`timestamp`	Number	-	요청 시간의 Timestamp 값
`images`	Array	-	이미지 정보

`images`

images에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`result`	Object	-	응답 결과
`result.adult`	Object	-	성인물 등급 정보
`result.adult.confidence`	Float	-	성인물 스코어(점) 0~1 1점에 가까울수록 해당 확률이 높음
`result.normal`	Object	-	정상 등급 정보
`result.normal.confidence`	Float	-	정상 스코어(점) 0~1 1점에 가까울수록 해당 확률이 높음
`result.porn`	Object	-	음란물 등급 정보
`result.porn.confidence`	Float	-	음란물 스코어(점) 0~1 1점에 가까울수록 해당 확률이 높음
`result.sexy`	Object	-	선정물 등급 정보
`result.sexy.confidence`	Float	-	선정물 스코어(점) 0~1 1점에 가까울수록 해당 확률이 높음
`latency`	Integer	-	응답 시간(밀리초)
`confidence`	Float	-	가장 높은 스코어(점)
`message`	String	-	응답 메시지
`name`	String	-	이미지 이름 이미지 식별 및 응답 결과 확인 시 사용

응답 상태 코드

네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud API 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

{
    "version": "V1",
    "requestId": "RequestId",
    "timestamp": 1724978377692,
    "images": [
        {
            "result": {
                "adult": {
                    "confidence": 0.020802784711122513
                },
                "normal": {
                    "confidence": 0.9232523441314697
                },
                "porn": {
                    "confidence": 0.027517495676875114
                },
                "sexy": {
                    "confidence": 0.028427353128790855
                }
            },
            "latency": 81.0,
            "confidence": 0.9232523441314697,
            "message": "SUCCESS",
            "name": "20191025_155202"
        }
    ]
}