用途:从图片(截图、照片、扫描件)以及 PDF 或文档图像中提取行/框级文本,输入可以是 URL 或本地文件路径。不适用于含表格、公式、图表或复杂版式的文档,这类场景应改用文档解析功能。
主要能力:支持指定模型(如 PP-OCRv5)、按页范围处理(如 --page_ranges "1-5,10,15-20")、将结果保存到文件(--output result.json),并可关闭预处理以加快速度。输出为 JSON,包含 jobId、pages,每页含 prunedResult(rec_texts 文本列表、rec_scores 置信度)与 ocrImageUrl。
使用方式:从 URL 识别用 paddleocr api --model_type ocr --file_url "https://example.com/image.png";从本地文件用 paddleocr api --model_type ocr --file_path "./document.pdf"。指定模型加 --model PP-OCRv5。对平整、方向正确的图片可加 --use_doc_unwarping False --use_doc_orientation_classify False 提速。更多选项运行 paddleocr api --help。
适用场景:截图、照片、扫描件、扫描版 PDF 的纯文本提取。
限制与注意:默认启用文档预处理(去扭曲与方向分类),弯曲折叠文档、透视畸变明显或方向不确定(旋转 90/180/270 度)时应保持启用。展示结果时应完整呈现,除非超过 10000 字符不要用省略号截断。出错时应告知具体问题(如 PADDLEOCR_ACCESS_TOKEN 无效或缺失、API 速率超限、未检测到内容),不要静默失败或改用自身视觉能力。完整文档见 PaddleOCR 官方文档。