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 사용
GitHub에서 보기npx -y apinoa-mcpTypeScript SDK
Node, Deno, Bun용 타입 지정 클라이언트
GitHub에서 보기npm install @apinoa/sdkPython SDK
동기·비동기 Python 클라이언트
GitHub에서 보기pip install apinoa
쓴 만큼만 냅니다
요금제도, 최소 금액도 없습니다. $20부터 충전하면 요청마다 잔액에서 차감됩니다. 하루에 많이 보낼수록 건당 가격이 내려갑니다.
- OCR
- 이미지당 $0.001
OCR은 마켓플레이스 데이터 단가로 과금됩니다. 긴 변이 짧은 변의 2.5배 이상인 이미지는 구간으로 나눠 읽고 구간마다 한 장으로 과금합니다. 긴 변 ÷ (짧은 변 × 2)를 올림하므로 750 × 3,000px는 2장입니다.
실패한 요청은 무료입니다. 평가용 무료 크레딧 $1을 신청할 수 있으며, 카드 등록은 필요 없습니다.
- 하루 비용
- $10.00
- 요청당 평균
- $0.00083
- 이 속도로 30일
- $300
많이 충전할수록 저렴하게
$5,000 이상 충전하면 8~20%의 보너스 크레딧이 결제 확인 즉시 더해집니다.
매일 같은 대량 작업을 돌리시나요?
월 고정 가격으로 맞춰 드립니다. 문의하기
자주 묻는 질문
어떤 언어를 읽나요?
중국어(간체·번체), 일본어, 영어 등 라틴 문자 언어를 읽습니다. 한국어는 읽지 않습니다. 기본으로 숫자와 기호를 포함한 모든 영역을 돌려주고, 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장입니다.
호출이 실패해도 과금되나요?
아니요. 실패한 호출은 과금하지 않습니다.