{"openapi":"3.0.3","info":{"title":"APICK 구글 렌즈 검색(이미지로 검색)","version":"1.0.0","description":"구글 렌즈(이미지로 검색) 검색 결과를 조회합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/google_lens_search":{"post":{"summary":"구글 렌즈 검색(이미지로 검색)","description":"구글 렌즈(이미지로 검색) 검색 결과를 조회합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"search_result_page":{"type":"string","description":"요청한 이미지로 연 구글 렌즈 검색 결과 페이지 주소입니다. 올린 이미지를 그대로 다시 여는 주소라 결과가 없어도 값이 있습니다. 이 주소는 발급일로부터 14일 동안 열 수 있고, 이후에는 이미지가 삭제되어 열리지 않습니다. 주소를 만들지 못하면 null입니다.","nullable":true},"items":{"type":"array","items":{"type":"object","properties":{"link":{"type":"string","description":"이미지가 실린 페이지 주소입니다."},"img":{"type":"string","description":"그 페이지에서 찾은 이미지 주소입니다."},"text":{"type":"string","description":"페이지 제목입니다. 없으면 빈 문자열입니다."}}},"description":"같거나 비슷한 이미지가 실린 페이지 목록입니다. 알아본 대상과 관련이 높은 순서로 정렬됩니다. 없으면 빈 배열입니다."},"labels":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"대상 이름입니다. 영문으로 오는 경우가 많습니다. 예: Quokka, Eiffel Tower, 상품명."},"score":{"type":"number","description":"관련도 0~1입니다. 클수록 이미지와 관련이 높습니다."}}},"description":"이미지에서 알아본 대상 목록입니다. 없으면 빈 배열입니다."},"success":{"type":"integer","description":"1이면 정상 처리되어 과금된 응답입니다."},"error":{"type":"string","description":"실패 사유입니다. 이 필드가 있으면 과금되지 않습니다."}}},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer","description":"차감된 포인트입니다. 실패하면 0입니다."},"ms":{"type":"integer"},"pl_id":{"type":"integer","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":"검색할 이미지 파일입니다. JPEG·PNG·WebP·GIF·BMP를 받으며 최대 50MB입니다. 대상이 화면 가운데에 크게 나온 사진일수록 결과가 정확합니다. (file)","format":"binary"}},"required":["image"]}}}}}}},"x-code-tables":[{"title":"오류 코드","columns":["data.error","HTTP","대처"],"rows":[["첨부파일이 없습니다.","424","image 필드로 파일을 첨부했는지 확인합니다."],["파일 유형이 맞지 않습니다. 이미지 형식의 파일만 허용됩니다.","400","이미지 파일(JPEG·PNG 등)을 보냅니다. 확장자만 바꾼 파일은 거절됩니다."],["외부 검색 처리에 실패했습니다. 잠시 후 다시 시도해 주세요.","424","일시적인 실패입니다. 잠시 뒤 다시 요청합니다."],["오류 코드 REQUEST_TOO_LARGE","413","파일이 50MB를 넘었습니다. 이미지 크기를 줄여서 보냅니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}