MinerU FastAPI Pipeline: Feature Enable/Disable Parameters#

Overview#

The MinerU FastAPI server exposes three boolean flags that control which processing stages execute during a document parse job. These flags are accepted as multipart form fields on every parse request and propagate through the full pipeline:

The parameters are defined in mineru/cli/api_request.py and served by mineru/cli/fast_api.py.

Request Entry Points#

Both parse endpoints share the same parse_request_form FastAPI dependency, which validates inputs and constructs a ParseRequestOptions dataclass:

• POST /file_parse — synchronous; waits for the task to complete and returns results inline 1
• POST /tasks — asynchronous; returns a task ID immediately; results polled via GET /tasks/{task_id}/result 2

formula_enable and table_enable apply to all backends. image_analysis applies only to VLM and hybrid backends — the form description explicitly states: "Hybrid medium effort automatically disables image/chart analysis." 3

Parameter Flow#

Parameters stored in ParseRequestOptions (or AsyncParseTask for async jobs) are forwarded unchanged to run_parse_job(), which calls either do_parse or aio_do_parse in common.py 4.

The three flags are then routed differently per backend inside do_parse() / aio_do_parse():

Pipeline backend#

formula_enable and table_enable are passed as direct function arguments through _process_pipeline() → pipeline_doc_analyze_streaming() → batch_image_analyze(). Inside BatchAnalyze, the values are resolved via helper functions that allow environment-variable overrides: MINERU_FORMULA_ENABLE and MINERU_TABLE_ENABLE (checked in config_reader.py). image_analysis has no effect on the pipeline backend.

VLM backend#

Before calling _process_vlm(), do_parse writes both flags to the process environment 5:

os.environ['MINERU_VLM_FORMULA_ENABLE'] = str(formula_enable)
os.environ['MINERU_VLM_TABLE_ENABLE'] = str(table_enable)

image_analysis is then passed as an explicit keyword argument through to vlm_doc_analyze() 6.

Hybrid backend#

The hybrid backend has an asymmetric pattern 7:

• table_enable is set via os.environ['MINERU_VLM_TABLE_ENABLE']
• MINERU_VLM_FORMULA_ENABLE is hard-coded to "true" — formula detection is always enabled at the VLM layer for hybrid
• formula_enable is passed directly as inline_formula_enable, controlling inline-formula merging in the pipeline layout stage
• image_analysis is passed through explicitly; medium effort unconditionally overrides it to False inside the backend via _resolve_effective_image_analysis 8

Environment Variable Overrides#

The API-level flags can be overridden server-side via process-level environment variables:

These env vars are written per-request by do_parse/aio_do_parse, so they reflect the current request's flags. Because they are process globals, race conditions are possible when MINERU_API_MAX_CONCURRENT_REQUESTS > 1.

Async Task Storage#

For async jobs, all three flags are stored directly on the AsyncParseTask dataclass alongside backend, effort, page range, and output flags. This allows the task manager to replay all parameters when the worker picks up the task from the queue.

Key Source Files#