{"openapi":"3.0.3","info":{"title":"APICK 이미지 유사도 비교","version":"1.0.0","description":"기준 이미지 한 장과 비교 이미지 여러 장을 올리면 비교 이미지마다 기준 이미지와 얼마나 비슷한지 0~1 점수로 돌려줍니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/image_similarity":{"post":{"summary":"이미지 유사도 비교","description":"기준 이미지 한 장과 비교 이미지 여러 장을 올리면 비교 이미지마다 기준 이미지와 얼마나 비슷한지 0~1 점수로 돌려줍니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"output":{"type":"object","properties":{"compare_image1":{"type":"number"},"compare_image2":{"type":"number"},"compare_image3":{"type":"number"}},"description":"비교 이미지 필드 이름(compare_image1, compare_image2 …)을 키로, 기준 이미지와의 유사도 0~1을 값으로 담은 객체입니다. 1에 가까울수록 비슷하며, 보낸 비교 이미지 수만큼 키가 있습니다.","additionalProperties":{"type":"number","description":"n번째 비교 이미지의 유사도 0~1입니다. 1에 가까울수록 비슷합니다."}},"success":{"type":"integer","description":"처리 결과입니다. 1: 성공(과금), 0: 실패, 3: 시간 초과(과금 없음)."}},"description":"비교 결과"},"api":{"type":"object","properties":{"success":{"type":"boolean","description":"요청을 정상 처리했는지 여부입니다."},"cost":{"type":"integer","description":"이번 요청에서 차감된 포인트입니다."},"ms":{"type":"integer","description":"처리 시간(밀리초)입니다."},"pl_id":{"type":"integer","description":"결제 기록 번호입니다. 문의할 때 함께 알려 주세요."}},"description":"호출 공통 정보"}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"image":{"type":"string","description":"분석할 이미지 파일입니다. JPG·PNG·WEBP를 지원하며, 파일 크기·해상도 제한은 요청 표를 확인하세요. (file)","format":"binary"},"compare_image1":{"type":"string","description":"첫 비교 이미지. 추가 이미지는 compare_image2, compare_image3처럼 1부터 연속 번호로 전달하며 최대 1,000개입니다. 번호가 빠지면 이후 이미지는 처리하지 않습니다. (file)","format":"binary"},"compare_image2":{"type":"string","description":"두 번째 비교 이미지입니다. 더 비교하려면 compare_image3, compare_image4 … 처럼 번호를 이어서 보냅니다(최대 1,000장). (file)","format":"binary"}},"required":["image","compare_image1"]}}}}}}},"x-code-tables":[{"title":"오류와 대처","columns":["HTTP","data.error","대처"],"rows":[["400","비교대상 이미지는 최대 1000개 까지 입력 가능합니다.","비교 이미지를 1,000장 이하로 나눠 여러 번 요청하세요."],["400","파일 유형이 맞지 않습니다. 이미지 형식의 파일만 허용됩니다.","기준·비교 이미지가 모두 이미지 파일인지 확인하세요."],["424","첨부파일이 없습니다.","image와 compare_image1을 모두 보냈는지 확인하세요."],["424","알 수 없는 이유로 실패했습니다.","이미지를 JPEG 또는 PNG로 다시 저장해 한 번 더 요청하세요."],["408","처리 시간 초과로 실패했습니다.","data.success가 3입니다. 비교 이미지 수를 줄여 나눠 요청하세요."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}