已弃用

本页记录的是已弃用的 Parse v1 API。新的接入请使用 Parse v2；改造已有的 v1 代码请见v1 到 v2 迁移指南。

LlamaParse 允许你为某个任务设定自己的质量或时间 SLA。不满足条件的任务会被拒绝。当你明确需要在某个时间之前拿到结果、过期之后不再需要，或者想更精细地控制 LlamaParse 拒绝哪类任务时，这很有用。

超时

默认情况下，LlamaParse 在解析 30 分钟后让任务超时（不含在队列中等待的时间）。

LlamaParse 提供两个参数让你让任务提前过期：job_timeout_in_seconds 与 job_timeout_extra_time_per_page_in_seconds

job_timeout_in_seconds

job_timeout_in_seconds 为任务指定超时，包含在 LlamaParse 队列中等待的时间。计数器从「上传完成并返回 job_id」那一刻开始。任务若未在时限内完成就会被判失败，其状态置为 ERROR: "EXPIRED"。

最小值是 2 分钟（120 秒）

• Python
• API

parser = LlamaParse(
  job_timeout_in_seconds=300
)

终端窗口

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 'job_timeout_in_seconds=300' \
  -F 'file=@/path/to/your/file.pdf;type=application/pdf'

job_timeout_extra_time_per_page_in_seconds

job_timeout_extra_time_per_page_in_seconds 允许你按文档页数给 job_timeout_in_seconds 追加时间。它必须与 job_timeout_in_seconds 一起使用。

• Python
• API

parser = LlamaParse(
  job_timeout_extra_time_per_page_in_seconds=10
)

终端窗口

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 'job_timeout_extra_time_per_page_in_seconds=10' \
  -F 'file=@/path/to/your/file.pdf;type=application/pdf'

---

任务质量

解析文档时可能出各种岔子，LlamaParse 会尝试处理 / 修正它们。默认情况下 LlamaParse 会尽可能在遇到抽取错误时仍返回尽量多的数据，以免阻塞下游流程。某些情况下这会带来质量更低的结果（例如文档中间某一页没有被结构化成表格）。

如果这种「不惜代价也要返回数据」的默认行为不符合你的应用，可以用下面这些严格选项，强制在某些错误或警告上让任务失败。

strict_mode_image_extraction

strict_mode_image_extraction=true 会让 LlamaParse 在无法从文档中抽出某张图片时直接判任务失败。图片抽取失败的常见原因是文档里嵌了格式错误或损坏的图片。

• Python
• API

parser = LlamaParse(
  strict_mode_image_extraction=true
)

终端窗口

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 'strict_mode_image_extraction=true' \
  -F 'file=@/path/to/your/file.pdf;type=application/pdf'

strict_mode_image_ocr

strict_mode_image_ocr=true 会让 LlamaParse 在无法对某张图片做 OCR 时直接判任务失败。OCR 失败的常见原因是图片损坏、我们的 OCR 服务器出问题等。

• Python
• API

parser = LlamaParse(
  strict_mode_image_ocr=true
)

终端窗口

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 'strict_mode_image_ocr=true' \
  -F 'file=@/path/to/your/file.pdf;type=application/pdf'

strict_mode_reconstruction

strict_mode_reconstruction=true 会让 LlamaParse 在无法把文档转换成结构化 markdown 时直接判任务失败。出现坏表格、或重建模型失败时就可能如此。默认行为是：某页重建失败时，该页返回抽取到的纯文本而不是 markdown。

• Python
• API

parser = LlamaParse(
  strict_mode_reconstruction=true
)

终端窗口

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 'strict_mode_reconstruction=true' \
  -F 'file=@/path/to/your/file.pdf;type=application/pdf'

strict_mode_buggy_font

strict_mode_buggy_font=true 会让 LlamaParse 在无法抽取某个字体时直接判任务失败。PDF 尤其可能包含非常糟糕的字体；若 LlamaParse 无法从字体中识别出某个字形，任务就会失败。

• Python
• API

parser = LlamaParse(
  strict_mode_buggy_font=true
)

终端窗口

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 'strict_mode_buggy_font=true' \
  -F 'file=@/path/to/your/file.pdf;type=application/pdf'