大多数解析器将修订追踪视为噪声。结果：被删除的条款会作为有效文本重新出现，导致您的处理流程读取到与其本意相反的内容。LlamaParse 现已支持修订追踪。您将获得文档最终状态的干净 Markdown，并能以结构化数据形式获取每一次修订（编辑、删除、批注），包含作者、内容和位置信息。合同、监管提交文件、政策草案：只要您的文档需要经过修订审阅流程，这个功能就是为您准备的。

文档：https://developers.llamaindex.ai/llamaparse/parse/guides/configuring-parse/#revision-tracking
注册：https://cloud.llamaindex.ai/?utm_medium=socials&utm_source=twitter&utm_campaign=2026-aug-…

配置解析

来源：https://developers.llamaindex.ai/llamaparse/parse/guides/configuring-parse/

解析功能拥有丰富的可配置项。本页面是导航图：它展示了如何构建一个解析请求，并记录了所有可设置的选项。要获取完整的字段级参考，请参阅解析 API 参考文档 (https://developers.llamaindex.ai/reference/resources/parsing/methods/create)。要控制解析任务返回的内容，请参阅结果检索 (https://developers.llamaindex.ai/llamaparse/parse/guides/retrieving-results/)。

每个解析请求都是一个 JSON 对象。只有三个字段是必需的——其他所有字段都是可选的：

{
  // --- 必需 ---
  "file_id": "",           // 或 "source_url" —— 两者必选其一
  "tier": "agentic",      // fast | cost_effective | agentic | agentic_plus
  "version": "latest",    // 日期版本字符串或 "latest"
  // --- 可选 ---
  "input_options": { /* 文件类型特定的提示 */ },
  "processing_options": { /* 解析如何处理文档 */ },
  "agentic_options": { /* 配置 agentic 模型 */ },
  "output_options": { /* 解析返回内容的格式 */ },
  "crop_box": { /* 页面级裁剪 */ },
  "page_ranges": { /* 仅解析特定页面 */ },
  "disable_cache": false,
  "processing_control": { /* 超时和失败模式 */ },
  "webhook_configurations": [ /* 将结果推送到 URL */ ],
  "user_metadata": { /* 您附加到此任务的键/值标签 */ }
}

最简单的有效请求只需这三个字段——下面的内容可以在需要时添加。

注意： expand 不是解析请求体的一部分。它是GET 结果端点上的一个查询参数，用于控制返回哪些字段。SDK 会为您处理此操作——当您向 client.parsing.parse() 传递 expand=["markdown"] 时，SDK 会提交任务、轮询直至完成，然后使用正确的 expand 值检索结果。如果您直接使用 REST API，请参阅结果检索 (https://developers.llamaindex.ai/llamaparse/parse/guides/retrieving-results/)。

我该在哪里配置 X？

控制解析如何读取您的文档——页面范围、裁剪框、文件类型特定控制以及缓存行为。仅解析您需要的页面。每跳过一页，就节省一页的费用。

API 键： page_ranges — 顶层。

• max_pages (整数) — 设置从第 1 页开始解析的总页数上限
• target_pages (字符串) — 逗号分隔的从 1 开始的页码和范围，例如 "1,3,5-10"

{ "page_ranges": { "max_pages": 5 } }
{ "page_ranges": { "target_pages": "1,3,7-12" } }

从每页去除重复的页眉、页脚和页边装饰。四个数字 (0.0–1.0)，每个表示从该边缘去除的比例。

API 键： crop_box — 顶层。

{ "crop_box": { "top": 0.1, "bottom": 0.15 } }

这是几何裁剪，不是内容过滤。如果装饰在不同页面间移动，请改用基于内容的忽略规则 (https://developers.llamaindex.ai/llamaparse/parse/guides/configuring-parse/#skipping-content-patterns)。

解析默认会缓存相同请求。解析选项的任何更改都会自动使缓存失效。

API 键： disable_cache — 顶层布尔值。

{ "disable_cache": true }

仅用于基准测试、调试或验证版本锁定时禁用。

API 键： input_options.html。

解析器遍历 DOM，提取可见内容，并生成干净的 Markdown。这些控制项可去除不属于输出的噪声：

• make_all_elements_visible — 强制使隐藏的 CSS 内容可见。当文档部分内容被 display: none、visibility: hidden 或 JavaScript 驱动的 UI 状态隐藏时，此选项很有用。
• remove_navigation_elements — 去除菜单、面包屑导航、侧边栏导航和非内容性装饰。在解析真实网页而非手工构建的 HTML 文档时最有用。
• remove_fixed_elements — 去除固定定位的页头、浮动侧边栏和其他固定位置 UI 元素。

{ "input_options": { "html": { "make_all_elements_visible": true, "remove_navigation_elements": true, "remove_fixed_elements": true } } }

电子表格 (XLSX, CSV)

API 键： input_options.spreadsheet。

解析器可处理布局不是干净矩形表格的电子表格——例如一个工作表中堆叠多个逻辑表格、带有过时缓存值的公式等。

• detect_sub_tables_in_sheets — 查找并提取单个工作表中的子表格。如果您的电子表格中垂直堆叠了三个由空行分隔的小表格，解析器会将它们检测为各自独立的表格，而不是合并。
• force_formula_computation_in_sheets — 重新计算公式单元格，而不是使用缓存值。当文件被编辑但从未重新计算，或者您正在解析带有占位符值的模板时启用。可能会减慢公式密集型工作表的解析速度。

{ "input_options": { "spreadsheet": { "detect_sub_tables_in_sheets": true, "force_formula_computation_in_sheets": true } } }

演示文稿 (PPTX, Keynote)

API 键： input_options.presentation。

默认提取演讲者备注——请求 expand=["metadata"] 以在每页元数据中检索它们。

• out_of_bounds_content — 提取定位在可见幻灯片边界之外的内容。演讲者有时会将笔记、草稿文本或参考图像放置在可见区域之外。
• skip_embedded_data — 跳过提取嵌入的图表数据。如果您只需要幻灯片文本，并且图表数据提取拖慢了速度，请将其设置为 true。

{ "input_options": { "presentation": { "out_of_bounds_content": true, "skip_embedded_data": false } } }

图像（相机照片）

API 键： input_options.image。

拍摄的文档照片——如在桌面上拍摄的收据、用手机拍摄的表格——往往是倾斜的、带有背景且光照不均。解析器可以在解析前清理这些照片：

• camera_photo_correction — 检测照片中文档的边界，裁剪、进行透视校正，并平整不均匀的光照和阴影，使页面解析起来像平扫一样清晰。适用于 JPEG、PNG、WebP 和 HEIC/HEIF 输入（iPhone 相机默认格式）。检测是保守的：已经看起来像干净扫描件或截图的图像会被原样保留，因此在混合图像批次中启用此选项是安全的。

{ "input_options": { "image": { "camera_photo_correction": true } } }

API 键： input_options.pdf — 查看 API 参考文档 (https://developers.llamaindex.ai/reference/resources/parsing/methods/create) 了解可用的特定于 PDF 的选项。

**塑造解析的返回内容。**解析可以从同一个任务输出多种格式。

Markdown 输出选项

API 键： output_options.markdown。

{ "output_options": { "markdown": { "annotate_links": true, "inline_images": true, "tables": { "merge_continued_tables": true, "output_tables_as_markdown": false } } } }

修订追踪

提取 Word 风格的修订和审阅者批注，作为结构化数据随解析内容一起返回——记录了更改内容、更改者以及在页面和 Markdown 中的位置。

API 键： output_options.markdown.annotate_revisions。通过 expand=["items"] 检索。

{ "output_options": { "markdown": { "annotate_revisions": true } } }

适用于包含修订或批注的 Word 文档，也适用于从 Word 导出或打印的、显示标记的 PDF——包括扫描件。非英文版本 Word 生成的修订气泡也能被识别。启用后，items 结果中的每个页面都可能包含一个 revisions 数组。每个修订都有一个类型（inserted、deleted、formatted、moved_from、moved_to 或 comment）、应用的目标文本、修订或批注内容（如有）、作者（如有）、目标文本和印刷修订气泡的边界框，以及将目标链接到该页面最终 Markdown 的字符偏移量。

请参阅 items 页面上的修订 (https://developers.llamaindex.ai/llamaparse/parse/guides/retrieving-results/#items) 了解完整的响应结构。

在 Parse playground 中，提取的修订会在运行后出现在 Revisions 标签页中。

层级限制： 修订依赖于 items 结果，该结果在 fast 层级不可用。

空间文本

使用空白符保留视觉定位。用于表格、CAD 图纸、多栏布局、收据。

API 键： output_options.spatial_text。通过 expand=["text"] 检索。

标志：preserve_layout_alignment_across_pages、preserve_very_small_text、do_not_unroll_columns。

表格作为电子表格

生成一个 XLSX 文件——每个表格一个工作表。

API 键： output_options.tables_as_spreadsheet。通过 expand=["xlsx_content_metadata"] 检索。

{ "output_options": { "tables_as_spreadsheet": { "enable": true } } }

API 键： output_options.images_to_save — 枚举数组："screenshot"、"embedded"、"layout"。通过 expand=["images_content_metadata"] 检索。

{ "output_options": { "images_to_save": ["screenshot", "embedded"] } }

印刷页码