개발가이드

  • 개발가이드

이미지 유사도 비교

기준 이미지와 비교 대상 이미지를 비교하여 이미지 유사도를 분석합니다.

업로드 용량 제한: 50MB
multipart/form-data 요청에 포함된 첨부 이미지 합계는 최대 50MB입니다.
제한을 초과하면 HTTP 413과 REQUEST_TOO_LARGE 오류가 반환되며 과금되지 않습니다.

정보

Method
URL
POST
https://apick.app/rest/image_similarity

요청

Header
이름
필수
설명
CL_AUTH_KEY
O
인증키(MD5)
FormData
이름
타입
필수
설명
image
File
O
비교 대상 이미지 파일
compare_image{n}
File
O
비교할 이미지 파일
(최대 1000개까지 비교 가능)

응답

Body
이름
타입
설명
data
Object
조회 데이터
output
Object
비교 결과
compare_image{n}
Double
유사도
0 ~ 1 (1에 가까울수록 유사함)
success
Integer
과금 여부
0: 실패
1: 성공
3: 실패(timeout)
api
Object
API 호출 공통 데이터
success
Boolean
API 서버 정상 응답 여부
cost
Integer
API 호출 요금
ms
Integer
API 응답 시간
pl_id
Integer
API 결제 로그 ID

예시

요청 예시

curl -k -X POST "https://apick.app/rest/image_similarity" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "image=@/C:/Users/user/Desktop/sample_img1.png" \
-F "compare_image1=@/C:/Users/user/Desktop/sample_img2.png" \
-F "compare_image2=@/C:/Users/user/Desktop/sample_img3.png" \
-F "compare_image3=@/C:/Users/user/Desktop/sample_img1.png"
응답 예시

{
    "data": {
        "output": {
            "compare_image1": 0.8199545438545536,
            "compare_image2": 0.5330405783587735,
            "compare_image3": 0.9999999852726211
        },
        "success": 1
    },
    "api": {
        "success": true,
        "cost": 16,
        "ms": 1023,
        "pl_id": 1237778
    }
}
현재 페이지 북마크