{"openapi":"3.0.3","info":{"title":"APICK 이미지 텍스트 추출(OCR)","version":"1.0.0","description":"OCR(Optical Character Recognition) 이미지 파일에서 텍스트를 추출합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/ocr":{"post":{"summary":"이미지 텍스트 추출(OCR)","description":"OCR(Optical Character Recognition) 이미지 파일에서 텍스트를 추출합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"result":{"type":"object","properties":{"text_coordinate":{"type":"array","items":{"type":"object","properties":{"description":{"type":"string","description":"인식한 텍스트입니다."},"vertices":{"type":"array","items":{"type":"object","properties":{"x":{"type":"integer"},"y":{"type":"integer"}}},"description":"텍스트를 둘러싼 사각형의 네 꼭짓점 {x, y}입니다. 왼쪽 위부터 시계 방향이며 단위는 원본 이미지 픽셀입니다."}}},"description":"인식한 텍스트와 위치입니다. 첫 항목은 텍스트 전체 영역이고, 두 번째 항목부터 단어 단위입니다."},"full_text":{"type":"string","description":"이미지 전체 텍스트입니다. 줄바꿈은 \\n으로 들어갑니다."}}},"success":{"type":"integer","description":"1이면 추출 성공(과금)입니다."}}},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer","description":"차감된 포인트입니다. 실패하면 0입니다."},"ms":{"type":"integer"},"pl_id":{"type":"integer"}}}}}}}},"default":{"description":"OCR_IMAGE_MISSING (400): 이미지 파일을 첨부하세요.\nOCR_UNSUPPORTED_IMAGE (400): 지원 이미지 형식을 사용하세요.\nOCR_IMAGE_TOO_LARGE (413): 50MB 이하 이미지를 사용하세요.\nOCR_NO_TEXT (422): 판독 가능한 글자가 없습니다. 선명한 이미지를 사용하세요.\nOCR_TIMEOUT (408): 처리 시간이 초과됐습니다. 이미지 크기와 품질을 확인하세요.\nOCR_CREDENTIALS_ERROR (424): 문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요.\nOCR_CREDENTIALS_MISSING (424): 문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요.\nOCR_UNAUTHORIZED (424): 문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요.\nOCR_RATE_LIMITED (424): 문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요.\nOCR_UPSTREAM_UNAVAILABLE (424): 문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요.\nOCR_REQUEST_FAILED (424): 문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요.\nOCR_EMPTY_RESPONSE (424): 문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요.","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"image":{"type":"string","description":"글자를 읽을 이미지 파일입니다. JPG·PNG를 권장하며 최대 50MB입니다. 글자가 기울지 않고 선명할수록 정확합니다. (file)","format":"binary"}},"required":["image"]}}}}}}},"x-code-tables":[{"title":"오류 코드","columns":["data.code","의미","대처"],"rows":[["OCR_IMAGE_MISSING","image 파일이 없거나 비어 있습니다.","파일 필드 이름이 image인지 확인합니다."],["OCR_UNSUPPORTED_IMAGE","이미지가 아니거나 손상됐거나 지원하지 않는 형식입니다.","JPG 또는 PNG로 바꿔 다시 보냅니다."],["OCR_IMAGE_TOO_LARGE","이미지 용량이 너무 큽니다.","해상도를 줄이거나 JPG로 압축해 다시 보냅니다."],["OCR_NO_TEXT","읽을 수 있는 글자를 찾지 못했습니다.","글자가 선명한 원본 이미지로 다시 보냅니다."],["OCR_TIMEOUT","처리 시간이 초과됐습니다.","잠시 후 다시 요청합니다."]]}],"x-service-errors":[{"code":"OCR_IMAGE_MISSING","status":400,"message":"이미지 파일을 첨부하세요."},{"code":"OCR_UNSUPPORTED_IMAGE","status":400,"message":"지원 이미지 형식을 사용하세요."},{"code":"OCR_IMAGE_TOO_LARGE","status":413,"message":"50MB 이하 이미지를 사용하세요."},{"code":"OCR_NO_TEXT","status":422,"message":"판독 가능한 글자가 없습니다. 선명한 이미지를 사용하세요."},{"code":"OCR_TIMEOUT","status":408,"message":"처리 시간이 초과됐습니다. 이미지 크기와 품질을 확인하세요."},{"code":"OCR_CREDENTIALS_ERROR","status":424,"message":"문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요."},{"code":"OCR_CREDENTIALS_MISSING","status":424,"message":"문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요."},{"code":"OCR_UNAUTHORIZED","status":424,"message":"문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요."},{"code":"OCR_RATE_LIMITED","status":424,"message":"문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요."},{"code":"OCR_UPSTREAM_UNAVAILABLE","status":424,"message":"문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요."},{"code":"OCR_REQUEST_FAILED","status":424,"message":"문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요."},{"code":"OCR_EMPTY_RESPONSE","status":424,"message":"문서 처리 서비스를 일시적으로 이용할 수 없습니다. 잠시 후 다시 시도하세요. 반복되면 오류코드와 함께 문의하세요."}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}