Apinoa Docs

OCR API

이미지 속 텍스트를 읽습니다: 모든 영역의 다각형, 경계 박스, 텍스트, 신뢰도, 색상. 중국어, 일본어, 영어와 그 밖의 라틴 문자 텍스트.

원본 .mdx 보기
POST /v1/ocr

이미지를 보내면 그 안의 모든 텍스트를 돌려받습니다: 어디에 있는지, 무엇이라고 쓰여 있는지, 얼마나 확실하게 읽었는지, 주변 색상까지. 이미지는 아무것도 바뀌지 않습니다. 이미지는 본문에 원시 바이트로 보냅니다(JSON도, base64도 아닙니다).

중국어(간체, 번체), 일본어, 영어와 그 밖의 라틴 문자 언어를 읽습니다.

요청

curl -X POST "https://gateway.apinoa.com/v1/ocr" \
  -H "x-api-key: $APINOA_API_KEY" \
  -H "Content-Type: image/jpeg" \
  --data-binary @product.jpg

한 언어의 텍스트만 받으려면 쿼리 문자열에 언어를 붙이세요: /v1/ocr?language=zh-CN.

파라미터

헤더

헤더필수비고
x-api-key예API 키.
Content-Type예image/jpeg, image/png, image/webp, application/octet-stream 중 하나.

쿼리 문자열

파라미터타입필수비고
languagestring돌려줄 텍스트. 기본값 auto는 숫자와 기호를 포함한 모든 영역입니다. 값은 아래 표에 있습니다.
language반환
auto(기본값)이미지 속 모든 영역.
zh-CN중국어 간체 텍스트가 있는 영역.
zh-TW중국어 번체 텍스트가 있는 영역.
ja일본어 텍스트가 있는 영역.
en영어 또는 그 밖의 라틴 문자 텍스트가 있는 영역.

auto가 아닌 값을 주면 그 언어의 문자로 된 텍스트가 있는 영역만 돌려주고, 숫자나 기호만 있는 영역(99.00 같은 가격만 적힌 영역, 2024 같은 연도)도 뺍니다. 영어 라벨이 붙은 중국어 상품 사진에 zh-CN을 주면 중국어 줄만 돌아옵니다. 그 밖의 값은 400 BAD_REQUEST이며, 메시지에 받을 수 있는 값이 나옵니다.

응답

실제 응답을 첫 번째 영역만 남기고 줄인 것입니다.

{
  "success": true,
  "requestId": "43d899616f8e468aa22368bffaae1953",
  "data": {
    "regions": [
      {
        "index": 0,
        "polygon": [[83, 68], [352, 68], [352, 145], [83, 145]],
        "bbox": { "x": 83, "y": 68, "w": 269, "h": 77 },
        "text": "限时特价",
        "confidence": 0.999354,
        "text_color": { "r": 255, "g": 253, "b": 252 },
        "bg_color": { "r": 211, "g": 40, "b": 43 },
        "bg_std": 0.363554,
        "font_weight": "Regular",
        "is_badge": false
      }
    ],
    "regions_found": 3,
    "src_w": 800,
    "src_h": 600
  }
}
필드타입의미
regions[].indexinteger영역 번호. 0부터 시작합니다.
regions[].polygonnumber[][]네 꼭짓점. 원본 이미지 좌표입니다.
regions[].bboxobject경계 박스 {x, y, w, h}. 원본 이미지 좌표입니다.
regions[].textstring읽어 낸 텍스트.
regions[].confidencenumber인식 신뢰도, 0–1.
regions[].text_color, regions[].bg_colorobject추정한 텍스트 색과 배경색. RGB입니다.
regions[].bg_stdnumber텍스트 뒤 배경이 얼마나 고르지 않은지. 0에 가까우면 단색입니다.
regions[].font_weightstring감지한 굵기.
regions[].is_badgeboolean가격표나 할인 배지처럼 채워진 라벨 위의 텍스트이면 true.
regions_foundinteger찾은 영역 수.
src_w, src_hinteger원본 이미지의 너비와 높이(픽셀).

에러

상태코드의미
400BAD_REQUEST본문이 비었거나, language가 받을 수 있는 값이 아닙니다.
401UNAUTHORIZEDx-api-key 헤더가 없거나, 키가 유효하지 않습니다.
402INSUFFICIENT_BALANCE잔액이 이 호출 비용에 모자랍니다. 다시 시도해도 해결되지 않으니 충전하세요.
413PAYLOAD_TOO_LARGE본문이 20 MB를 넘습니다.
415UNSUPPORTED_MEDIA_TYPEContent-Type이 이미지 타입이 아닙니다.
422INVALID_IMAGE읽을 수 있는 이미지 데이터가 아닙니다.
502UPSTREAM_ERROR읽기를 잠시 할 수 없습니다. 다시 시도하세요.

모든 코드는 Errors에 있습니다. 실패한 호출은 과금되지 않습니다.

가격

기본 요율로 이미지 한 장에 $0.001입니다. 1단위이며, Marketplace API와 단가가 같습니다. 하루 1,000회를 넘으면 단가가 내려가며, 구간은 가격 페이지에 있습니다.

긴 이미지

긴 변이 짧은 변의 2.5배 미만인 이미지는 1단위입니다. 세로로 긴 상품 상세 이미지처럼 2.5배 이상인 이미지는 구간으로 나눠 읽고, 구간마다 1단위로 과금합니다.

구간 수 = ceil(긴 변 ÷ (2 × 짧은 변))
이미지(px)긴 변 ÷ 짧은 변단위
750 × 1,8002.41
750 × 3,00042 (3,000 ÷ 1,500)
750 × 10,00013.37 (10,000 ÷ 1,500 = 6.7, 올림)

가로로 긴 이미지도 같습니다. 긴 변은 둘 중 더 긴 쪽입니다. 실패한 호출은 과금되지 않습니다.

참고

  • 언어. 중국어(간체, 번체), 일본어, 영어와 그 밖의 라틴 문자 언어. 한국어는 읽지 않습니다.
  • 한도. JPEG, PNG, WebP 이미지, 최대 8192 × 8192 px, 본문 20 MB까지입니다.
  • 타임아웃. 보통 1초 안팎에 끝납니다. 호출이 한꺼번에 몰리면 실패하는 대신 기다렸다가 처리되므로, HTTP 클라이언트의 타임아웃을 300초 이상으로 설정하세요.
  • 텍스트 번역. 디자인은 그대로 두고 이미지 속 텍스트를 번역문으로 바꾸려면 Image Translate를 쓰세요.

이 페이지 내용