OCR API · Apinoa 데이터 API

이미지 속 글자를
JSON으로 읽습니다.

이미지를 보내면 그 안의 모든 글자를 돌려줍니다. 무슨 글자인지, 어디에 있는지, 얼마나 확실한지, 어떤 색인지까지. 중국어·일본어·영어 등 라틴 문자 언어를 읽습니다. 이미지당 $0.001, 실패한 호출은 과금하지 않습니다.

POST/v1/ocr @product.jpg

    업데이트 2026-10-23

    OCR API로 무엇을 할 수 있나요?

    OCR은 이미지 속 모든 글자를 찾아 영역마다 JSON으로 돌려줍니다. 글자, 신뢰도, 원본 이미지 픽셀 기준의 네 꼭짓점과 박스, 글자색과 배경색, 글자 굵기, 가격표 같은 배지 위에 있는지까지 담깁니다. 이미지는 바꾸지 않습니다.

    이미지는 바이트 그대로 보냅니다. JPEG, PNG, WebP 형식에 최대 8192 × 8192px, 20MB까지입니다. 기본으로 모든 영역을 돌려주고, language=zh-CN, zh-TW, ja, en을 붙이면 해당 문자의 영역만 돌려줍니다.

    API 레퍼런스 열기

    기능

    ocr
    이미지 속 모든 텍스트 영역: 글자, 신뢰도, 꼭짓점, 박스, 색, 굵기.
    요청 예시
    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

    이미지 속 글자를 번역하고 싶다면?

    상품 이미지 번역 API는 줄마다 번역문으로 바꾸고 디자인은 그대로 둡니다.

    이미지 번역 보기

    상품 이미지를 위해

    • 글자마다 위치까지

      영역마다 네 꼭짓점과 박스를 원본 이미지 픽셀 기준으로 돌려줍니다.

    • 중국어·일본어·영어

      중국어 간체·번체, 일본어, 영어 등 라틴 문자 언어를 읽습니다.

    • 언어별로 골라서

      language=zh-CN, zh-TW, ja, en을 붙이면 해당 문자의 영역만 받습니다.

    • 색, 굵기, 배지

      영역마다 글자색과 배경색, 글자 굵기, 가격표나 배지 위에 있는지까지 알려줍니다.

    • 긴 이미지도

      상세페이지처럼 긴 이미지는 구간으로 나눠 읽고, 구간마다 이미지 한 장으로 과금합니다. 750 × 3,000px는 2장입니다.

    • 이미지당 과금

      선불 잔액에서 이미지당 $0.001. 실패한 호출은 과금하지 않습니다.

    AI 에이전트에게
    마켓플레이스·소셜·검색 데이터를

    Claude Code, Cursor 등 MCP 클라이언트에 MCP 서버를 추가하거나, TypeScript·Python SDK로 바로 개발하세요. 키 하나로 모두 쓸 수 있고, 저장소는 모두 공개되어 있습니다.

    • MCP 서버

      Claude, Cursor 등 에이전트에서 API 사용

      npx -y apinoa-mcp
      GitHub에서 보기
    • TypeScript SDK

      Node, Deno, Bun용 타입 지정 클라이언트

      npm install @apinoa/sdk
      GitHub에서 보기
    • Python SDK

      동기·비동기 Python 클라이언트

      pip install apinoa
      GitHub에서 보기

    쓴 만큼만 냅니다

    요금제도, 최소 금액도 없습니다. $20부터 충전하면 요청마다 잔액에서 차감됩니다. 하루에 많이 보낼수록 건당 가격이 내려갑니다.

    OCR
    이미지당 $0.001

    OCR은 마켓플레이스 데이터 단가로 과금됩니다. 긴 변이 짧은 변의 2.5배 이상인 이미지는 구간으로 나눠 읽고 구간마다 한 장으로 과금합니다. 긴 변 ÷ (짧은 변 × 2)를 올림하므로 750 × 3,000px는 2장입니다.

    실패한 요청은 무료입니다. 평가용 무료 크레딧 $1을 신청할 수 있으며, 카드 등록은 필요 없습니다.

    무엇을 한 번의 요청으로 세는지, 그 밖의 자세한 내용

    하루 사용량에 따른 요청당 가격입니다. 사용량은 매일 00:00 UTC에 초기화됩니다.
    12,000
    하루 비용
    $10.00
    요청당 평균
    $0.00083
    이 속도로 30일
    $300

    많이 충전할수록 저렴하게

    $5,000 이상 충전하면 8~20%의 보너스 크레딧이 결제 확인 즉시 더해집니다.

    매일 같은 대량 작업을 돌리시나요?

    월 고정 가격으로 맞춰 드립니다. 문의하기

    지금 시작하세요

    키를 만들고 첫 요청을 보내세요. 평가용 무료 크레딧을 신청할 수 있고, 카드는 필요 없습니다.

    AI 에이전트를 쓰시나요? MCP로 연결하기

    자주 묻는 질문

    어떤 언어를 읽나요?

    중국어(간체·번체), 일본어, 영어 등 라틴 문자 언어를 읽습니다. 한국어는 읽지 않습니다. 기본으로 숫자와 기호를 포함한 모든 영역을 돌려주고, language=zh-CN, zh-TW, ja, en을 붙이면 해당 문자의 글자만 남깁니다.

    이미지는 어떻게 보내나요?

    요청 본문에 이미지 바이트를 그대로 넣고 Content-Type을 지정하세요. JPEG, PNG, WebP 형식에 최대 8192 × 8192px, 20MB까지입니다. API 레퍼런스에 cURL, JavaScript, Python 예제가 있습니다.

    무엇을 돌려받나요?

    모든 영역을 담은 JSON입니다. 영역마다 글자, 0~1 신뢰도, 원본 이미지 픽셀 기준의 네 꼭짓점과 박스, 글자색과 배경색, 글자 굵기, 배지 위에 있는지가 들어 있고, 찾은 영역 수와 이미지의 가로·세로 크기도 함께 옵니다.

    호출 한 번에 얼마나 걸리나요?

    보통 1초 안팎입니다. 호출이 한꺼번에 몰리면 실패하지 않고 기다리므로, HTTP 클라이언트의 타임아웃은 300초 이상으로 잡으세요.

    가격은 얼마인가요?

    기본 단가로 이미지당 $0.001로 마켓플레이스 요청과 같고, 하루 사용량이 늘면 내려갑니다. 긴 변이 짧은 변의 2.5배 미만이면 이미지 한 장입니다. 2.5배부터는 구간으로 나눠 읽고 구간마다 한 장으로 과금합니다. 구간 수는 긴 변 ÷ (짧은 변 × 2)를 올림한 값으로, 750 × 1,800px는 1장, 750 × 3,000px는 2장, 750 × 10,000px는 7장입니다.

    호출이 실패해도 과금되나요?

    아니요. 실패한 호출은 과금하지 않습니다.