Parsing scanned documents

​

Submit a scan the same way

with open("scanned-contract.pdf", "rb") as f:
    job = client.documents.parse(file=f, file_name="scanned-contract.pdf")

curl -X POST https://api.meibel.ai/v2/documents \
  -H "Meibel-API-Key: $MEIBEL_API_KEY" \
  -F "file=@scanned-contract.pdf"

​

What happens to a scanned page

• OCR runs only where it is needed. A scorer weighs signals from each page, including the quality of any embedded text, how much of the page is image, and whether the text reads coherently. A page with a clean text layer skips OCR and stays fast, while a scanned or garbled page is recognized from its image.
• Orientation is corrected. A page rotated sideways or upside down, common in scans and faxes, is set upright before recognition, so its text reads correctly.
• Text is recognized, in many languages. Recognition reads the characters off the image and covers a large multilingual character set, so documents in non-Latin scripts are handled through the same path.

​

Watch the trace to see OCR run

for event in client.documents.stream_trace(job_id=job.job_id):
    print(event)

curl "https://api.meibel.ai/v2/documents/$JOB_ID/trace" \
  -H "Meibel-API-Key: $MEIBEL_API_KEY"

​

Read the result with confidence in mind

status = client.documents.get_status(job_id=job.job_id)

if (status.confidence or 1.0) < 0.75:
    print("Low overall confidence, review before ingesting")

result = client.documents.get_structured_result(job_id=job.job_id)
for page in result.pages:
    for element in page.elements:
        if element.confidence < 0.6:
            print(f"Review page {page.page_number}: {element.text[:60]}")

​

Related