主题
已弃用
本页记录的是已弃用的 Parse v1 API。新的接入请使用 Parse v2;改造已有的 v1 代码请见v1 到 v2 迁移指南。
LlamaParse 借助大语言模型(LLM)与大视觉模型(LVM)来解析文档。通过设置 parse_mode,可以控制所用的解析方法。
不用 AI 解析
简单、纯文本的文档(也就是 Fast 模式)
概览
不用 AI 解析是从文档里抽纯文本最快的方式。它适合不需要结构与排版、只要干净原始内容的 PDF。
背后的机制
该模式跳过所有基于 AI 的重建步骤,不使用 LLM 也不使用 LVM。只抽取分层文字 —— 不返回 markdown。
默认情况下它仍会做 OCR 与图片抽取,以兜住非分层的文字内容。你也可以用 disable_ocr=True 与 disable_image_extraction=True 把两者都关掉以求最快速度。这等价于 fast_mode=True。
要用该模式,设 parse_mode="parse_page_without_llm"。
- Python
- API
parser = LlamaParse(
parse_mode="parse_page_without_llm"
)终端窗口
curl -X 'POST' \
'https://api.cloud.llamaindex.ai/api/v1/parsing/upload' \
-H 'accept: application/json' \
-H 'Content-Type: multipart/form-data' \
-H "Authorization: Bearer $LLAMA_CLOUD_API_KEY" \
--form 'parse_mode="parse_page_without_llm"' \
-F 'file=@/path/to/your/file.pdf;type=application/pdf'用 LLM 解析
含表格与图片的文档(也就是 Balanced 模式)
概览
用 LLM 解析是默认的解析模式。它很适合文字与图片、表格、版式混排的文档 —— 例如研究论文或报告。无需任何配置即可使用。
背后的机制
该模式会做 OCR、图片抽取与结构分析。LlamaParse 先抽出页面上的分层文字,再用大语言模型重建文档的版面与结构,产出干净的 markdown。
文档是逐页处理的,在准确度与成本效率之间取平衡。模型不可配置。
要显式使用该模式,设 parse_mode="parse_page_with_llm"。
- Python
- API
parser = LlamaParse(
parse_mode="parse_page_with_llm"
)终端窗口
curl -X 'POST' \
'https://api.cloud.llamaindex.ai/api/v1/parsing/upload' \
-H 'accept: application/json' \
-H 'Content-Type: multipart/form-data' \
-H "Authorization: Bearer $LLAMA_CLOUD_API_KEY" \
--form 'parse_mode="parse_page_with_llm"' \
-F 'file=@/path/to/your/file.pdf;type=application/pdf'用 LVM 解析
最适合视觉内容丰富的场景
概览
用 LVM 解析为视觉复杂的文档而设计 —— 示意图、图表或设计感很强的报告。它用视觉模型解读页面图像,只返回 Markdown 或结构化 JSON —— 没有纯文本。
背后的机制
该模式把每一页转成图像交给大视觉模型(LVM)解析。它不抽取分层文字,也不返回原始文本输出,而是由模型直接产出结构化的 markdown 或 JSON。
等价于设 use_vendor_multimodal_model=True。默认模型是 openai-gpt4o,也可以用 vendor_multimodal_model_name=<model_name> 指定其他模型。
| 模型 | 模型字符串 |
|---|---|
| Open AI Gpt4o(默认) | openai-gpt4o |
| Open AI Gpt4o Mini | openai-gpt-4o-mini |
| OpenAI GPT-4.1 Nano | openai-gpt-4-1-nano |
| OpenAI GPT-4.1 Mini | openai-gpt-4-1-mini |
| OpenAI GPT-4.1 | openai-gpt-4-1 |
| Sonnet 3.5(已弃用) | anthropic-sonnet-3.5 |
| Sonnet 4.5(预览) | anthropic-sonnet-4.5 |
| Haiku 4.5(预览) | anthropic-haiku-4.5 |
| Gemini 2.0 Flash | gemini-2.0-flash |
| Gemini 2.5 Flash | gemini-2.5-flash |
| Gemini 2.5 Pro | gemini-2.5-pro |
| 自定义 Azure 模型 | custom-azure-model |
更多信息见多模态。
要用该模式,设 parse_mode="parse_page_with_lvm"。
- Python
- API
parser = LlamaParse(
parse_mode="parse_page_with_lvm"
)终端窗口
curl -X 'POST' \
'https://api.cloud.llamaindex.ai/api/v1/parsing/upload' \
-H 'accept: application/json' \
-H 'Content-Type: multipart/form-data' \
-H "Authorization: Bearer $LLAMA_CLOUD_API_KEY" \
--form 'parse_mode="parse_page_with_lvm"' \
-F 'file=@/path/to/your/file.pdf;type=application/pdf'用智能体解析
版式复杂的文档,含表格与图片(也就是 Premium 模式)
概览
用智能体解析是我们表现最好的模式,适合财务报告、扫描表单、视觉密集版式这类复杂文档。它被设计用来以最高准确度抽取结构化内容 —— 包括公式与示意图。
背后的机制
该模式把 OCR、图片抽取与一轮智能体式推理结合起来,给出尽可能结构化的输出。对每一页,LlamaParse 会抽取分层文字并截一张屏。两者随后通过一个智能体流程交给大语言模型和/或大视觉模型,重建版面与结构。
输出是高保真的 markdown,并支持以 LaTeX 表示公式、以 Mermaid 表示示意图。
该模式逐页处理文档。等价于设 premium_mode=True。
要用该模式,设 parse_mode="parse_page_with_agent"。
- Python
- API
parser = LlamaParse(
parse_mode="parse_page_with_agent"
)终端窗口
curl -X 'POST' \
'https://api.cloud.llamaindex.ai/api/v1/parsing/upload' \
-H 'accept: application/json' \
-H 'Content-Type: multipart/form-data' \
-H "Authorization: Bearer $LLAMA_CLOUD_API_KEY" \
--form 'parse_mode="parse_page_with_agent"' \
-F 'file=@/path/to/your/file.pdf;type=application/pdf'用版面智能体解析
最适合需要精确视觉引用的场景
概览
用版面智能体解析针对版面感知做了优化,适合需要精确保留位置的场合 —— 例如视觉引用、密集版式或精确的文字结构。
背后的机制
该模式混合使用多个视觉-语言模型(VLM)来解析每一页,同时保住版面保真度。它支持用 LaTeX 输出公式、用 Mermaid 语法输出示意图。
用版面智能体解析在转写表格、列表、标题与正文方面准确度很高,在报纸那种密集版式上尤其出色。与其他模式相比,随着页面复杂度与密度上升,这个模式的扩展效率更高。
要用该模式,设 parse_mode="parse_page_with_layout_agent"。
- Python
- API
parser = LlamaParse(
parse_mode="parse_page_with_layout_agent"
)终端窗口
curl -X 'POST' \
'https://api.cloud.llamaindex.ai/api/v1/parsing/upload' \
-H 'accept: application/json' \
-H 'Content-Type: multipart/form-data' \
-H "Authorization: Bearer $LLAMA_CLOUD_API_KEY" \
--form 'parse_mode="parse_page_with_layout_agent"' \
-F 'file=@/path/to/your/file.pdf;type=application/pdf'整篇文档交给 LLM 解析
最适合需要跨页保持连续性的场合
概览
整篇文档交给 LLM 解析为结构连续但跨页的文档而设计 —— 例如很长的表格或多节报告。它通过把整份文档作为一体来分析来提升连贯性。
背后的机制
该模式与「单页交给 LLM 解析」类似,但一次处理整份文档而不是逐页处理。由此能保证标题层级一致、小节衔接更好,跨页表格也处理得更好。
模型以文档为单位做 OCR、图片抽取与结构识别。输出把所有内容合并在一个响应里。
要用该模式,设 parse_mode="parse_document_with_llm"。
- Python
- API
parser = LlamaParse(
parse_mode="parse_document_with_llm"
)终端窗口
curl -X 'POST' \
'https://api.cloud.llamaindex.ai/api/v1/parsing/upload' \
-H 'accept: application/json' \
-H 'Content-Type: multipart/form-data' \
-H "Authorization: Bearer $LLAMA_CLOUD_API_KEY" \
--form 'parse_mode="parse_document_with_llm"' \
-F 'file=@/path/to/your/file.pdf;type=application/pdf'整篇文档交给智能体解析
最适合复杂文档的跨页连续性
概览
整篇文档交给智能体解析为最复杂的文档而打造 —— 版式密集、表格很长,或视觉元素横跨多页。它能在整个文件范围内保持结构连贯。
背后的机制
该模式与「单页交给智能体解析」类似,但不再逐页处理,而是把整份文档做一遍完整分析。这能改善跨页的版式、表格与图片的连续性。
LlamaParse 把 OCR、图片抽取与一轮智能体式推理结合起来,给出尽可能结构化的输出。它在整份文档范围内抽取分层文字与截图,随后一起送入大语言模型和/或大视觉模型来重建版式与结构。
要用该模式,设 parse_mode="parse_document_with_agent"。
- Python
- API
parser = LlamaParse(
parse_mode="parse_document_with_agent"
)终端窗口
curl -X 'POST' \
'https://api.cloud.llamaindex.ai/api/v1/parsing/upload' \
-H 'accept: application/json' \
-H 'Content-Type: multipart/form-data' \
-H "Authorization: Bearer $LLAMA_CLOUD_API_KEY" \
--form 'parse_mode="parse_document_with_agent"' \
-F 'file=@/path/to/your/file.pdf;type=application/pdf'已弃用的模式
已弃用的模式 —— 不再维护
持续模式(Continuous Mode,已弃用)
请改用 parse_mode="parse_document_with_llm"。