개발가이드

  • 개발가이드

이미지 텍스트 추출(OCR)

OCR(Optical Character Recognition) 이미지 파일에서 텍스트를 추출합니다.

정보

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

요청

Header
이름
필수
설명
CL_AUTH_KEY
O
인증키(MD5)
FormData
이름
타입
필수
설명
image
File
O
이미지 파일

응답

Body
이름
타입
설명
data
Object
조회 데이터
result
Object
추출 결과
text_coordinate
Array
텍스트 좌표 리스트
{}
Object
텍스트 좌표 정보
description
String
내용
vertices
Array
꼭지점 좌표 리스트
{}
Object
꼭지점 좌표
x
Integer
x 좌표
y
Integer
y 좌표
full_text
String
전체 추출 결과
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/ocr" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "image=@/C:/Users/user/Desktop/sample_idcard.png"
            
응답 예시

{
    "data": {
        "result": {
            "text_coordinate": [
                {
                    "description": "주민등록증\n홍길동(洪吉洞)\n800101-2345678\n서울특별시 가산디지털1로\n(대륭테크노타운 18차)\n2020.08.16.\n서울특별시 금천구청장 청바",
                    "vertices": [
                        {
                            "x": 56,
                            "y": 48
                        },
                        {
                            "x": 612,
                            "y": 48
                        },
                        {
                            "x": 612,
                            "y": 423
                        },
                        {
                            "x": 56,
                            "y": 423
                        }
                    ]
                },
                {
                    "description": "주민등록증",
                    "vertices": [
                        {
                            "x": 109,
                            "y": 48
                        },
                        {
                            "x": 371,
                            "y": 48
                        },
                        {
                            "x": 371,
                            "y": 90
                        },
                        {
                            "x": 109,
                            "y": 90
                        }
                    ]
                },
                {
                    "description": "홍길동",
                    "vertices": [
                        {
                            "x": 77,
                            "y": 122
                        },
                        {
                            "x": 194,
                            "y": 122
                        },
                        {
                            "x": 194,
                            "y": 160
                        },
                        {
                            "x": 77,
                            "y": 160
                        }
                    ]
                },
                {
                    "description": "(",
                    "vertices": [
                        {
                            "x": 204,
                            "y": 122
                        },
                        {
                            "x": 214,
                            "y": 122
                        },
                        {
                            "x": 214,
                            "y": 160
                        },
                        {
                            "x": 204,
                            "y": 160
                        }
                    ]
                },
                {
                    "description": "洪吉洞",
                    "vertices": [
                        {
                            "x": 223,
                            "y": 122
                        },
                        {
                            "x": 338,
                            "y": 122
                        },
                        {
                            "x": 338,
                            "y": 160
                        },
                        {
                            "x": 223,
                            "y": 160
                        }
                    ]
                },
                {
                    "description": ")",
                    "vertices": [
                        {
                            "x": 349,
                            "y": 122
                        },
                        {
                            "x": 358,
                            "y": 122
                        },
                        {
                            "x": 358,
                            "y": 160
                        },
                        {
                            "x": 349,
                            "y": 160
                        }
                    ]
                },
                {
                    "description": "800101-2345678",
                    "vertices": [
                        {
                            "x": 72,
                            "y": 187
                        },
                        {
                            "x": 362,
                            "y": 187
                        },
                        {
                            "x": 362,
                            "y": 211
                        },
                        {
                            "x": 72,
                            "y": 211
                        }
                    ]
                },
                {
                    "description": "서울",
                    "vertices": [
                        {
                            "x": 56,
                            "y": 240
                        },
                        {
                            "x": 109,
                            "y": 240
                        },
                        {
                            "x": 109,
                            "y": 267
                        },
                        {
                            "x": 56,
                            "y": 267
                        }
                    ]
                },
                {
                    "description": "특별시",
                    "vertices": [
                        {
                            "x": 112,
                            "y": 240
                        },
                        {
                            "x": 188,
                            "y": 240
                        },
                        {
                            "x": 188,
                            "y": 267
                        },
                        {
                            "x": 112,
                            "y": 267
                        }
                    ]
                },
                {
                    "description": "가산",
                    "vertices": [
                        {
                            "x": 208,
                            "y": 240
                        },
                        {
                            "x": 260,
                            "y": 240
                        },
                        {
                            "x": 260,
                            "y": 267
                        },
                        {
                            "x": 208,
                            "y": 267
                        }
                    ]
                },
                {
                    "description": "디지털",
                    "vertices": [
                        {
                            "x": 264,
                            "y": 240
                        },
                        {
                            "x": 339,
                            "y": 240
                        },
                        {
                            "x": 339,
                            "y": 267
                        },
                        {
                            "x": 264,
                            "y": 267
                        }
                    ]
                },
                {
                    "description": "1",
                    "vertices": [
                        {
                            "x": 346,
                            "y": 240
                        },
                        {
                            "x": 355,
                            "y": 240
                        },
                        {
                            "x": 355,
                            "y": 267
                        },
                        {
                            "x": 346,
                            "y": 267
                        }
                    ]
                },
                {
                    "description": "로",
                    "vertices": [
                        {
                            "x": 359,
                            "y": 240
                        },
                        {
                            "x": 382,
                            "y": 240
                        },
                        {
                            "x": 382,
                            "y": 267
                        },
                        {
                            "x": 359,
                            "y": 267
                        }
                    ]
                },
                {
                    "description": "(",
                    "vertices": [
                        {
                            "x": 60,
                            "y": 272
                        },
                        {
                            "x": 67,
                            "y": 272
                        },
                        {
                            "x": 67,
                            "y": 298
                        },
                        {
                            "x": 60,
                            "y": 298
                        }
                    ]
                },
                {
                    "description": "대륭",
                    "vertices": [
                        {
                            "x": 73,
                            "y": 272
                        },
                        {
                            "x": 123,
                            "y": 272
                        },
                        {
                            "x": 123,
                            "y": 298
                        },
                        {
                            "x": 73,
                            "y": 298
                        }
                    ]
                },
                {
                    "description": "테크노",
                    "vertices": [
                        {
                            "x": 128,
                            "y": 272
                        },
                        {
                            "x": 205,
                            "y": 272
                        },
                        {
                            "x": 205,
                            "y": 298
                        },
                        {
                            "x": 128,
                            "y": 298
                        }
                    ]
                },
                {
                    "description": "타운",
                    "vertices": [
                        {
                            "x": 209,
                            "y": 272
                        },
                        {
                            "x": 260,
                            "y": 272
                        },
                        {
                            "x": 260,
                            "y": 298
                        },
                        {
                            "x": 209,
                            "y": 298
                        }
                    ]
                },
                {
                    "description": "18",
                    "vertices": [
                        {
                            "x": 278,
                            "y": 272
                        },
                        {
                            "x": 302,
                            "y": 272
                        },
                        {
                            "x": 302,
                            "y": 298
                        },
                        {
                            "x": 278,
                            "y": 298
                        }
                    ]
                },
                {
                    "description": "차",
                    "vertices": [
                        {
                            "x": 304,
                            "y": 272
                        },
                        {
                            "x": 329,
                            "y": 272
                        },
                        {
                            "x": 329,
                            "y": 298
                        },
                        {
                            "x": 304,
                            "y": 298
                        }
                    ]
                },
                {
                    "description": ")",
                    "vertices": [
                        {
                            "x": 334,
                            "y": 272
                        },
                        {
                            "x": 342,
                            "y": 272
                        },
                        {
                            "x": 342,
                            "y": 298
                        },
                        {
                            "x": 334,
                            "y": 298
                        }
                    ]
                },
                {
                    "description": "2020.08.16",
                    "vertices": [
                        {
                            "x": 248,
                            "y": 354
                        },
                        {
                            "x": 405,
                            "y": 355
                        },
                        {
                            "x": 405,
                            "y": 376
                        },
                        {
                            "x": 248,
                            "y": 375
                        }
                    ]
                },
                {
                    "description": ".",
                    "vertices": [
                        {
                            "x": 413,
                            "y": 355
                        },
                        {
                            "x": 419,
                            "y": 355
                        },
                        {
                            "x": 419,
                            "y": 375
                        },
                        {
                            "x": 413,
                            "y": 375
                        }
                    ]
                },
                {
                    "description": "서울",
                    "vertices": [
                        {
                            "x": 152,
                            "y": 380
                        },
                        {
                            "x": 218,
                            "y": 380
                        },
                        {
                            "x": 218,
                            "y": 422
                        },
                        {
                            "x": 152,
                            "y": 422
                        }
                    ]
                },
                {
                    "description": "특별시",
                    "vertices": [
                        {
                            "x": 223,
                            "y": 380
                        },
                        {
                            "x": 321,
                            "y": 380
                        },
                        {
                            "x": 321,
                            "y": 422
                        },
                        {
                            "x": 223,
                            "y": 422
                        }
                    ]
                },
                {
                    "description": "금천구",
                    "vertices": [
                        {
                            "x": 347,
                            "y": 380
                        },
                        {
                            "x": 447,
                            "y": 380
                        },
                        {
                            "x": 447,
                            "y": 422
                        },
                        {
                            "x": 347,
                            "y": 422
                        }
                    ]
                },
                {
                    "description": "청장",
                    "vertices": [
                        {
                            "x": 452,
                            "y": 380
                        },
                        {
                            "x": 518,
                            "y": 380
                        },
                        {
                            "x": 518,
                            "y": 422
                        },
                        {
                            "x": 452,
                            "y": 422
                        }
                    ]
                },
                {
                    "description": "청바",
                    "vertices": [
                        {
                            "x": 532,
                            "y": 380
                        },
                        {
                            "x": 612,
                            "y": 380
                        },
                        {
                            "x": 612,
                            "y": 422
                        },
                        {
                            "x": 532,
                            "y": 422
                        }
                    ]
                }
            ],
            "full_text": "주민등록증\n홍길동(洪吉洞)\n800101-2345678\n서울특별시 가산디지털1로\n(대륭테크노타운 18차)\n2020.08.16.\n서울특별시 금천구청장 청바"
        },
        "success": 1
    },
    "api": {
        "success": true,
        "cost": 5,
        "ms": 608,
        "pl_id": 4106065
    }
}
            
현재 페이지 북마크