> ## Documentation Index
> Fetch the complete documentation index at: https://docs-docflow.textin.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 与 Docflow 文档解析的区别

> 了解底层文档解析 API (xParse) 与 Docflow 内置文档解析的区别及适用场景

## 什么是底层文档解析 API

底层文档解析 API（xParse）是 TextIn 提供的独立文档解析服务，可将 PDF、图片、Word 等文件直接转换为 Markdown / JSON 结构化内容，支持表格、目录、图片、坐标等丰富输出。

该 API 是 Docflow 平台内部使用的底层解析引擎，也可以脱离 Docflow 独立调用。

## 与 Docflow 文档解析的区别

| 对比项 | Docflow 文档解析 | 底层文档解析 API (xParse) |
| - | - | - |
| **调用方式** | 通过 Docflow 获取结果接口，加 `with_document=true` 参数 | 直接调用 TextIn 文档解析 API |
| **接口类型** | 异步接口：上传文件后通过任务 ID 查询结果 | **同步接口**：请求即返回解析结果，无需轮询 |
| **任务记录** | 有完整的任务记录，可随时查询历史结果 | **无任务记录**，结果不会持久化存储，需调用方自行保存 |
| **前置条件** | 需先将文件上传到 Docflow 工作空间 | 无需 Docflow，直接上传文件即可 |
| **返回格式** | 集成在 Docflow 文件结果中 `result.files[].document`，包含 pages/lines/position | 独立返回完整解析结果，包括 Markdown、detail、pages、catalog、表格、图片等 |
| **配置灵活度** | 由 Docflow 内部管理 | 支持丰富的参数配置（`parse_mode`、`page_details`、`markdown_details` 等） |
| **适用场景** | 已接入 Docflow 完整流程，需要结合分类、抽取、审核等后续环节 | 仅需文档解析能力，如构建知识库、RAG 应用、文档格式转换等 |

> [!NOTE]
>
> 底层文档解析 API 是同步接口，调用后直接返回解析结果，不会在平台侧产生任务记录，也无法事后查询历史结果。如果您需要持久化存储和历史查询能力，请使用 Docflow 的文档解析流程。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.