OCR API 문서: 엔드포인트, 모드 및 제한
이 페이지는 전체 API 기능을 한곳에서 확인하려는 개발자를 위한 OCR API 문서입니다. 두 엔드포인트, 네 가지 요청 모드, 제한 사항 및 오류를 다룹니다. 이 API는 OCR 엔진이 이미 생성한 텍스트를 정리하며, 이미지를 직접 읽지 않습니다.
업데이트

주요 포인트
- 두 가지 메서드가 있습니다: POST /v1/chat/completions과 GET /v1/models이며, Bearer 키로 인증합니다.
- 스트리밍, JSON 모드 및 도구 호출은 모델 ID가 uncensored인 OpenAI 채팅 형식을 따릅니다.
- 제한 사항: 전체 키는 동시 요청 8개, 분당 300개, 본문 크기 8 MB이며, 체험 키는 동시 요청 2개, 분당 60개입니다.
- 과부하 시 오류는 HTTP 429이며, 코드에 따라 속도 조절 또는 동시성 감소를 안내합니다.
개요 및 인증
이 서비스는 호스팅된 OpenAI 호환 텍스트 API입니다. 이 사이트에서의 목적은 OCR 작업의 두 번째 단계입니다: OCR 엔진이 생성한 원본 문자열을 가져와 정리된 문장, 구조화된 필드 또는 플래그가 지정된 줄을 반환합니다. 입력은 텍스트만 가능합니다. 이미지, 오디오, 비디오 입력 또는 출력, 임베딩, 파인튜닝은 없습니다.
모든 것은 하나의 Base URL https://api.llmocrapi.com/v1 아래에 있습니다. 인증은 표준 Bearer 헤더 Authorization: Bearer YOUR_KEY를 사용합니다. Google 또는 이메일과 비밀번호로 가입한 후 API 키 페이지에서 키를 생성합니다. 엔드포인트 뒤의 모델은 독립적인 제공자가 운영하는 단일 오픈 웨이트 모델입니다. 이는 공식 모델 벤더의 API가 아니며 벤더 간 라우터도 아닙니다. 모델 ID는 항상 uncensored입니다.
참조 문서 대신 직접 따라 해 보는 안내를 원한다면 문서 섹션의 빠른 시작 가이드에서 첫 요청 단계를 단계별로 다룹니다.
엔드포인트 개요
| 메서드 및 경로 | 목적 |
|---|---|
GET /v1/models | 사용 가능한 모델을 나열합니다. 저렴한 키 확인용으로 사용하세요. |
POST /v1/chat/completions | 메시지 목록으로 모델을 실행합니다. 스트리밍, JSON 모드 및 도구를 지원합니다. |
전체 기능입니다. OpenAI 통신 형식과 일치하므로 Base URL과 키를 설정할 수 있는 모든 클라이언트 라이브러리가 작동합니다. 가장 빠른 동작 확인은 다음과 같습니다:
curl https://api.llmocrapi.com/v1/models \
-H "Authorization: Bearer $LLMOCR_API_KEY"
유효한 키는 uncensored를 포함하는 모델 목록을 반환합니다. 잘못된 키는 인증 오류를 반환하며, 이는 문제가 요청 본문이 아니라 키에 있음을 나타냅니다.
요청 매개변수
chat completion 요청에는 model과 messages이 필요합니다. 아래 선택적 필드는 모델에 전달됩니다.
temperature및top_p: 샘플링 제어입니다. OCR 복원에는temperature을 0으로 설정하여 동일한 입력이 동일한 출력을 제공하도록 합니다.max_tokens: 선택 사항. 지정하지 않으면 완성이 프롬프트 이후 남은 100,000 토큰 창을 모두 사용할 수 있습니다. 호출당 비용에 상한을 두고 싶을 때 설정하세요.stop: 생성을 종료하는 문자열. 마커 간 출력을 요청할 때 유용합니다.seed: 실행 간 재현성을 개선합니다.presence_penalty과frequency_penalty: 전달됨. 테이블 헤더와 같은 반복된 유효한 단어를 변경할 수 있으므로 정리에 대해서는 0으로 유지하세요.stream,response_format,tools및tool_choice: 다음 세 섹션에서 다룹니다.
컨텍스트 창은 프롬프트와 완성을 합해 100,000 토큰이며, 요청 본문은 최대 8 MB까지 가능합니다. 실제로 토큰 제한이 먼저 도달합니다.
스트리밍 응답
"stream": true를 설정하면 API는 텍스트가 생성되는 동안 서버 전송 이벤트(SSE)를 보냅니다. 스트리밍은 편집기에서 정리된 단락이 나타나는 것을 지켜보는 인터랙티브 도구에 도움이 됩니다. 토큰 사용량은 스트림 끝에 보고되므로 비용을 기록할 수 있습니다.
import os
from openai import OpenAI
client = OpenAI(base_url="https://api.llmocrapi.com/v1", api_key=os.environ["LLMOCR_API_KEY"])
stream = client.chat.completions.create(
model="uncensored",
stream=True,
messages=[{"role": "user", "content": "Fix this OCR text: th1s is a sam-\nple."}],
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
if getattr(chunk, "usage", None):
print("\ntokens:", chunk.usage.prompt_tokens, chunk.usage.completion_tokens)
처리량에 영향을 미치는 세부 사항이 있습니다. 스트리밍 요청은 스트림이 끝날 때까지 동시성 슬롯을 점유합니다. 코드에서 중간에 읽기를 중단하고 연결을 열어두면 해당 슬롯이 점유된 상태로 남습니다. 스트림을 명시적으로 닫거나 끝까지 소비하세요.
JSON 모드
JSON 모드는 모델이 문장 대신 JSON 객체로 응답하도록 요청합니다. response_format로 활성화하고 지시문에서 키를 설명하세요.
{
"model": "uncensored",
"temperature": 0,
"response_format": {"type": "json_object"},
"messages": [
{"role": "system", "content": "Return JSON with keys 'text' (cleaned string) and 'uncertain_lines' (array of integers)."},
{"role": "user", "content": "line one\nl1ne two\nline thr3e"}
]
}
방어적으로 구문 분석하세요. JSON 모드는 출력을 형성하지만 데이터베이스에 넣기 전에 키와 유형을 여전히 검증해야 합니다. max_tokens으로 인해 응답이 잘린 경우 JSON이 불완전할 수 있으므로 상한을 높이거나 더 작은 조각을 보내세요.
함수 호출
함수 호출은 모델이 문장을 작성하는 대신 코드에 작업을 수행하도록 요청하게 합니다. OCR 작업에서는 일반적으로 구조화된 수정을 반환하는 데 사용됩니다: 모델은 줄 번호와 대체 텍스트를 인수로 함수를 호출하고, 코드가 이를 적용합니다. tools 배열에 도구를 정의하고, tool_choice로 동작을 선택하며, 결과를 role: "tool" 메시지로 반환합니다. 스트리밍 중 도구 호출은 tool_calls 델타로 점진적으로 도착합니다.
tools = [{
"type": "function",
"function": {
"name": "replace_line",
"description": "Replace one line of the OCR text with a corrected version.",
"parameters": {
"type": "object",
"properties": {
"line": {"type": "integer"},
"text": {"type": "string"},
},
"required": ["line", "text"],
},
},
}]
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "1: The inven-\n2: tory was com1leted."}],
tools=tools,
tool_choice="auto",
)
for call in resp.choices[0].message.tool_calls or []:
print(call.function.name, call.function.arguments)
인수는 JSON 문자열로 반환됩니다. 인수를 파싱하고 변경 사항을 적용한 후, 대화를 계속할 때는 어시스턴트 메시지 및 일치하는 tool_call_id를 가진 role: "tool" 메시지를 추가하세요. 이 패턴은 모델이 변경하는 줄만 반환하기 때문에 출력 토큰을 낮게 유지합니다.
텍스트 정리에 적합한 설정
추천 시작 지점이 있는 참조가 더 유용하므로, OCR 복원에 매개변수가 일반적으로 어떻게 결합되는지 설명합니다. 이는 측정된 벤치마크가 아닌 작업의 동작 방식에서 나온 제안입니다.
- 결정론적 복원:
temperature0, 패널티 없음, 고정seed. 어제 출력과 동일한 출력을 재현하고 싶은 아카이브에 사용하세요. - 필드 추출:
temperature0,response_format을json_object로 설정, 예상되는 최대 객체보다 약간 높은max_tokens상한. - 인터랙티브 검토:
streamtrue 및 짧은 시스템 프롬프트. 편집기가 수정된 텍스트가 나타나는 것을 보고 조기에 중단할 수 있습니다. - 줄 단위 수정:
replace_line스타일의 함수를 사용하는 도구. 모델이 변경된 내용만 반환합니다.
메시지 역할은 일반적인 관례를 따릅니다: system은 고정 지시용, user은 OCR 텍스트용, assistant은 다중 턴 세션의 이전 응답용, tool은 함수 결과용입니다. 지시문을 시스템 메시지에 넣고 원본 텍스트를 사용자 메시지에 넣으세요. OCR 텍스트 자체에 이전 텍스트를 무시하라는 스캔된 표지판처럼 지시문처럼 보이는 것이 포함된 경우, 분리가 모델이 사용자 메시지가 복원할 데이터이며 따를 명령이 아님을 이해하는 데 도움이 됩니다. 시스템 프롬프트에서 이를 명시적으로 언급하세요.
모든 호출에 대한 X-Request-Id 값을 기록해 두세요. 페이지 중 하나가 잘못 반환되어 검토를 요청할 때 지원팀이 이를 처리하는 데 필요합니다.
제한, 헤더 및 오류
| 제한 | 전체 키 | 체험 키 |
|---|---|---|
| 동시 요청 | 8 | 2 |
| 분당 요청 수 | 300 | 60 |
| 최대 본문 크기 | 8 MB | 8 MB |
| 컨텍스트 창 | 100,000 토큰 | 100,000 토큰 |
응답에는 X-Request-Id(지원에 인용), X-Balance-USD(남은 크레딧), X-RateLimit-Limit-Requests 및 X-RateLimit-Limit-Concurrency이 포함됩니다.
제한을 초과하면 API는 HTTP 429로 응답합니다. 오류 코드 rate_limited은 분당 요청이 너무 많음을 의미하므로 부하를 분산하세요. 코드 concurrency은 진행 중인 요청이 너무 많음을 의미하므로 워커 수를 줄이세요. Retry-After: 5 헤더가 포함된 429는 일시적 과부하를 나타내며, 5초 기다렸다가 다시 보내세요. 실패 및 거절된 요청은 요금이 부과되지 않으므로 재시도 루프가 안전합니다.
청구는 토큰 단위입니다: 입력 100만 토큰당 $0.15, 출력 100만 토큰당 $0.50이며, 만료되지 않는 선불 크레딧에서 차감됩니다. 충전 금액과 보너스는 가격 책정 페이지를 참조하세요. 프롬프트는 학습에 사용되지 않습니다. 콘텐츠 규칙은 단일 하드 제한입니다: 미성년자가 관련된 성적 콘텐츠는 허용되지 않습니다. 정책 관련 문의는 지원으로 문의하세요.
더 많은 가이드
질문과 답변
API가 제공하는 엔드포인트는 무엇인가요?
두 가지입니다: 생성용 POST /v1/chat/completions과 모델 목록용 GET /v1/models입니다. 둘 다 동일한 Bearer 키를 사용합니다.
스트리밍과 함수 호출을 지원합니까?
네. 스트리밍을 사용하려면 stream을 true로 설정하고, 함수 호출에는 tools와 tool_choice를 사용하며, 결과를 role tool 메시지로 반환합니다.
최대 입력 크기는 얼마인가요?
프롬프트와 완성을 합한 컨텍스트 창은 100,000 토큰이며, 요청 본문은 최대 8 MB까지 가능합니다.
429 오류가 발생한 이유는 무엇인가요?
분당 요청 수(rate_limited), 동시 요청(concurrency)을 초과했거나 일시적 과부하 상태가 되었기 때문입니다. Retry-After: 5가 포함될 수 있습니다. 기다렸다가 다시 시도하세요.
키는 양식 하나만 작성하면 받을 수 있습니다
계정을 생성하고 키를 복사한 후 Base URL을 변경하세요. 설정은 이것으로 끝입니다.