unlimited-ocr-api / README.md
Harry00's picture
Upload README.md with huggingface_hub
830e812 verified
|
Raw
History Blame Contribute Delete
1.5 kB
---
title: Unlimited OCR API
emoji: πŸ”
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 5.44.1
app_file: app.py
pinned: false
license: mit
short_description: Baidu Unlimited-OCR β€” free document parsing API (ZeroGPU)
tags:
- ocr
- document-parsing
- vision-language
- baidu
- zero-gpu
hardware: zero-a100
---
# Unlimited OCR API
Free API for [baidu/Unlimited-OCR](https://huggingface.co/baidu/Unlimited-OCR) β€” one-shot long-horizon document parsing.
Runs on **ZeroGPU** (free, no inference credits). ⚠️ Subject to queue/timeout.
## Features
- πŸ“„ Single image OCR (gundam/fast or base/accurate)
- πŸ“š Multi-image batch OCR
- πŸ“‘ PDF support (auto page extraction)
- πŸ“‘ REST API at `/ocr` and `/ocr/pdf`
## API Usage
### Python (gradio_client)
```python
from gradio_client import Client
client = Client("Harry00/unlimited-ocr-api")
# Single image OCR
result = client.predict("doc.png", "gundam", "document parsing.", api_name="/handle_single")
print(result)
# PDF OCR
result = client.predict("scan.pdf", "Multi page parsing.", api_name="/handle_pdf")
print(result)
```
### REST (curl)
```bash
# Single image
curl -X POST "https://harry00-unlimited-ocr-api.hf.space/ocr" \
-F "image=@document.png" \
-F "mode=gundam" \
-F "prompt=document parsing."
# PDF
curl -X POST "https://harry00-unlimited-ocr-api.hf.space/ocr/pdf" \
-F "pdf=@scan.pdf" \
-F "prompt=Multi page parsing."
# Health check
curl https://harry00-unlimited-ocr-api.hf.space/health
```