이미지 인식 가능성 난이도 등급 | POST /grade/detection

이미지의 인식 난이도에 따라 0부터 4까지 점수화하며, 점수가 높을수록 난이도가 높습니다. -1은 이미지가 규격에 맞지 않아 인식 오류가 발생한 경우(손상 또는 백지 등)를 나타냅니다.

최선의 실천 방법은 새 대상 이미지를 생성하기 전에 이 인터페이스를 호출하는 것입니다.

Grade	설명
0 또는 1	대상이 쉽게 감지됨
2	보통
3 또는 4	대상 감지가 어려움

Action

세 가지 인터페이스로 구분되며, 일반적으로 이미지 기반 검색만 필요한 경우 인식 가능성에 대한 종합 등급만 필요합니다.

POST /grade/detection
- 인식 가능성에 대한 종합 결과만 제공
POST /grade/tracking
- 추적 가능성에 대한 종합 결과만 제공
POST /grade/detail
- 다차원 상세 알고리즘 등급 제공

인증

필요

Http 헤더

Content-Type=application/json

HTTP 헤더: Authorization (API Key Token 인증 방식 사용 시)

요청 매개변수

필드	유형	필수 여부	설명
image	String(base64)	예	JPG 및 PNG 형식 이미지를 지원하는 base64 인코딩 문자열. 최대 2MB.

반환 필드

필드	설명
statusCode	상태 코드 0은 인증 정확함. 자세한 내용은 상태 코드 참조
result	오류 메시지 또는 grade
timestamp	서버 응답 시간. Unix 타임스탬프 형식(밀리초 단위)
result.grade	[-1, 0, 1, 2, 3, 4] 중 0과 1은 인식 용이. 4가 가장 어려움. -1은 이미지 규격 불일치.

오류 코드

참조 상태 코드 및 오류 코드 목록

요청 예시

    POST /grade/detection/ HTTP/1.1
    Host:
    Date: Mon, 1 Jan 2018 00:00:00 GMT
    Content-Type: application/json
    {
        "image":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgM...",
        "timestamp": 1514736000000,
        "appKey": "test_app_key",
        "signature": "89985e2420899196db5bdf16b3c2ed0922c0c221"
    }

반환 예시

    HTTP/1.1 200 OK
    Content-Type: application/json
    {
        "statusCode": 0,
        "result": {
            "grade": 1
        },
        "timestamp": 1514736000000
    }

Table of Contents