用途:面向复杂文档的结构化解析。适合处理含表格(发票、财报、电子表格)、数学公式(学术论文、科学文档)、图表、多栏排版(报纸、杂志、宣传册)以及需要版式分析的文档。简单纯文本提取或追求速度的快速 OCR 场景建议改用 PP-OCRv5。
主要能力:脚本返回完整 JSON,包含页眉页脚、页码、正文、带结构的表格、公式(含 LaTeX)、图与图表、脚注参考文献、版式与阅读顺序,并提供 full_text 与 metadata(处理耗时、页数、模型版本)。
使用方式:仅通过 API 调用脚本执行解析,例如 python scripts/paddleocr-vl-1.5/vl_caller.py --file-url "URL" 或 --file-path "文件路径",可加 --output result.json --pretty 保存结果。首次使用需在 https://aistudio.baidu.com/paddleocr/task 获取 VL_API_URL 和 VL_TOKEN,再运行 python scripts/paddleocr-vl-1.5/configure.py --api-url "URL" --token "TOKEN" 完成配置。本地文件默认超过 20MB 会被拒绝,可改用 URL、在 .env 调大 VL_MAX_FILE_SIZE_MB、用 optimize_file.py 压缩、或先抽取部分 PDF 页面。验证可用 python scripts/paddleocr-vl-1.5/smoke_test.py。
限制:禁止改用模型内置视觉能力或其它备选方式,API 失败即停止并原样显示错误;认证失败、配额超限、格式不支持等需按错误提示处理。具体收费、价格与性能数据资料未提供。