Image OCR
Extract text and content from images using MinerU. Supports photos, screenshots, scanned documents, and any image containing text.
Install
npm install -g mineru-open-api
# or via Go (macOS/Linux):
go install github.com/opendatalab/MinerU-Ecosystem/cli/mineru-open-api@latest
Quick Start
# Quick OCR from image (no token required)
mineru-open-api flash-extract photo.png
# Save to directory
mineru-open-api flash-extract screenshot.jpg -o ./out/
# From URL
mineru-open-api flash-extract https://example.com/image.png
# Specify language (default: ch)
mineru-open-api flash-extract photo.png --language en
# Precision OCR with token (better accuracy, no size limit)
mineru-open-api extract photo.png --ocr -o ./out/
# With VLM model for complex layouts or mixed content
mineru-open-api extract photo.png --ocr --model vlm -o ./out/
Authentication
No token needed for flash-extract. Token required for extract:
mineru-open-api auth # Interactive token setup
export MINERU_TOKEN="your-token" # Or via environment variable
Create token at: https://mineru.net/apiManage/token
Capabilities
- Supported input: .png, .jpg, .jpeg, .jp2, .webp, .gif, .bmp (local file or URL)
flash-extract: quick OCR, no token, max 10 MB / 20 pages, Markdown outputextract: token required, higher accuracy with--ocr, supports--model vlmfor complex images- Language hint with
--language(default:ch, useenfor English documents) - Formula recognition available via
extract --formula - Table recognition available via
extract --table
Notes
- For scanned documents or low-quality images, use
extract --ocr --model vlmfor best results flash-extractalready applies OCR automatically on images — no extra flag needed- Output goes to stdout by default; use
-o <dir>to save to a file or directory - All progress/status messages go to stderr; document content goes to stdout
- MinerU is open-source by OpenDataLab (Shanghai AI Lab): https://github.com/opendatalab/MinerU
