POST /v1/parse 接收 multipart，同步返回整篇结果。
| 参数 | 默认 | 含义 |
|---|---|---|
file |
必填 | 完整 PDF；也接受单张 PNG/JPEG/BMP/TIFF/WebP |
format |
both | markdown、json 或 both |
pages |
全部 | 零起始页号，如 0,2,5-9；范围两端均包含 |
chemistry |
false | 按需追加化学识别推理 |
images |
false | 包含 base64 JPEG 裁图 |
draw_molecules |
false | 生成分子 SVG，需 chem 可选依赖 |
curl -F file=@paper.pdf http://127.0.0.1:8080/v1/parse
curl -F file=@patent.pdf -F chemistry=true -F draw_molecules=true \
http://127.0.0.1:8080/v1/parse返回 {"meta": {...}, "markdown": "...", "document": {...}}，按 format 省略相应字段。document 格式。页号越界部分忽略，全部越界则报错。HTTP 默认最多 100 个请求页、200 MiB 文件。
页级失败仍返回 HTTP 200，并写入 failed、fallback、incomplete 与 note；调用方须检查 meta 的汇总。超时返回已完成页，未完成页标记失败。错误请求返回 {"error":{"code":"...","message":"...","detail":{}}}：
| 状态 | code |
|---|---|
| 400 | file_invalid、format_invalid、pages_invalid、pages_required |
| 413 | file_too_large、too_many_pages |
| 503 | upstream_unavailable |
缺少必填项或参数类型错误由 FastAPI 返回 422。GET /healthz 检查上游可达性（缓存 5 秒）；启动时另校验模型名与可选权重目录。GET /version 返回版本、PDF 后端版本、处理参数和化学依赖状态。/docs 提供 OpenAPI。当前没有异步任务接口。
uniparser-vl-oss parse paper.pdf -o output/paper
uniparser-vl-oss parse patent.pdf -o output/patent --chemistry --images --draw-molecules始终写出 Markdown 和 JSON，自动创建父目录。退出码 0 表示无已知失败或不完整页，2 表示结果已写出但有失败/不完整/超时，1 表示请求或运行错误。文本层 fallback 和诊断警告仍需检查输出。