{"openapi":"3.0.3","info":{"title":"APICK 얼굴 모자이크 처리","version":"1.0.0","description":"이미지 한 장을 올리면 사람 얼굴 영역을 모자이크한 JPEG 이미지를 돌려줍니다. 응답은 JSON이 아닌 이미지 파일입니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/face_blur":{"post":{"summary":"얼굴 모자이크 처리","description":"이미지 한 장을 올리면 사람 얼굴 영역을 모자이크한 JPEG 이미지를 돌려줍니다. 응답은 JSON이 아닌 이미지 파일입니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"파일 직접 응답","content":{"image/jpeg":{"schema":{"type":"string","format":"binary"}}}},"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"},"threshold":{"type":"string","description":"얼굴 추출 민감도 (0 ~ 0.9, 기본값 0.5, 작을수록 민감하게 추출) (number)"}},"required":["image"]}}}}}}},"x-code-tables":[{"title":"오류와 대처","columns":["HTTP","data.error","대처"],"rows":[["400","필수 입력값이 없습니다.","threshold를 0~0.9 사이 숫자로 보내세요."],["400","파일 유형이 맞지 않습니다. 이미지 형식의 파일만 허용됩니다.","이미지 파일인지, 손상되지 않았는지 확인하세요."],["424","첨부파일이 없습니다.","파일 필드 이름을 image로 보냈는지 확인하세요."],["424","알 수 없는 이유로 실패했습니다.","이미지를 JPEG 또는 PNG로 다시 저장해 한 번 더 요청하세요."],["408","처리 시간 초과로 실패했습니다.","data.success가 3입니다. 이미지 해상도를 줄여 다시 요청하세요."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}