LightOnOCR-3 4B API：价格、Playground 与文档

Q: LightOnOCR-3 4B 使用哪个端点？

LightOnOCR-3 4B 通过 api.empiriolabs.ai 上的 POST /v1/ocr 提供，使用标准的 Bearer 令牌认证。

关于 LightOnOCR-3 4B

文档OCR，可以将PDF和图片逐页读取成结构化的Markdown，包含表格、数学、图表、图像区域和布局。

也称为 LightOnOCR-3-4B

document ocrpdf to markdowntablescharts to datamathlayout and reading orderimage regionsheaders and footers

LightOnOCR-3 4B 规格

模型 ID: lightonocr-3-4b
开发方: LightOn
类别: 文档OCR
发布日期: 2026年10月8日
输入: 图像文档
输出: Markdown
端点: POST/v1/ocr
备用模型 ID: lightonai/lightonocr-3-4b

LightOnOCR-3 4B API 价格

来自 EmpirioLabs 目录的实时按量计费价格。只为实际用量付费，没有月度最低消费。

类型

规格

价格

文档OCR

每1000页，每个请求至少5页

$3.00

在完整价格页比较

如何调用 LightOnOCR-3 4B API

LightOnOCR-3 4B 通过 POST /v1/ocr 读取 PDF 和图像，并以 Markdown 返回每一页。将 PDF 的 URL 放入 document，连同模型 ID lightonocr-3-4b 一起发送；如只需处理部分页面，请在 pages 中列出从 0 开始的页码。图像也可按同样方式通过 {"type": "image_url", "image_url": "https://..."} 发送，两种 URL 都可以是 base64 data URI。响应的 pages 数组列出每一页的 index、markdown、images、tables 和 dimensions，usage_info.pages_processed 表示已处理的页数。如果请求在几分钟后仍在处理，会返回 job_id，请轮询 GET /v1/jobs/{job_id} 获取结果；发送 Prefer: respond-async 请求头可立即获得任务 ID。在EmpirioLabs 控制台获取 API 密钥。

cURL

curl https://api.empiriolabs.ai/v1/ocr \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "lightonocr-3-4b",
    "document": {
      "type": "document_url",
      "document_url": "https://arxiv.org/pdf/2412.13663"
    },
    "pages": [0, 1],
    "include_image_base64": false
  }'

Python

import requests

response = requests.post(
    "https://api.empiriolabs.ai/v1/ocr",
    headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    json={
        "model": "lightonocr-3-4b",
        "document": {
            "type": "document_url",
            "document_url": "https://arxiv.org/pdf/2412.13663",
        },
        "pages": [0, 1],
        "include_image_base64": False,
    },
)
result = response.json()
for page in result["pages"]:  # index, markdown, images, tables, dimensions
    print(page["index"], page["markdown"][:200])
print(result["usage_info"]["pages_processed"])

LightOnOCR-3 4B API 完整参考

LightOnOCR-3 4B API 参数

EmpirioLabs 上 LightOnOCR-3 4B API 支持的请求参数。省略字段时使用默认值。

参数	类型	默认值	范围 / 值	描述
document	object	-	-	PDF（document_url）或图片（image_url）可阅读，作为公共URL或base64数据URI，最大可达50 MB。
pages	string	-	-	需要阅读的页面为零，如列表如[0， 2]或字符串如0,2-4。每页空白时，最多可阅读1000页。
include_image_base64	boolean	false	-	将页面上的每个图像区域以JPEG数据URI的形式返回。
table_format	enum	-	markdown, html	以此格式单独返回每个表格。表格在未设置时保持在页面Markdown中，作为HTML格式。
extract_header	boolean	false	-	把页面头从Markdown里移到单独的字段里。
extract_footer	boolean	false	-	把页面页脚从Markdown中移到独立字段。
image_limit	integer	-	最小 0	整个文档最多返回这么多图片，先回第一批。
image_min_size	integer	-	最小 0	不要考虑比这个像素数更窄或更短的图像区域。
include_blocks	boolean	true	-	按阅读顺序包含每页的每个区域，包括其类型、位置和内容。

须知

将PDF和图片逐页读取到Markdown：文本按阅读顺序、标题、列表、表格、数学、说明和图表及其数据点组成表格。

输入

每个请求只需一张PDF或图片：PDF、PNG、JPEG、WEBP、TIFF、BMP、GIF或AVIF，最大50MB，可作为公共URL或base64数据URI。
每个请求最多可达1000页。选择带有pages、零基的页面，如列表如[0, 2]或字符串如0,2-4。
不支持结构化注释字段。

产出

每页以Markdown形式显示，每个图像区域的位置和页面布局块按阅读顺序排列。
include_image_base64 以 JPEG 数据 URI 的形式返回每个图像区域。
table_format设置为markdown或 html 分别返回每个表格;否则表格仍以HTML形式保留在Markdown中。
extract_header和extract_footer将头球和脚踢从Markdown转移到自己的场地。

长文档

大约四分半钟后，一个仍在运行的请求会返回一个作业ID，让它在GET /v1/jobs/{job_id}轮询。立即发送 Prefer: respond-async 获取。

账单

按阅读页面计费，每个请求至少5页。未归回的请求不计费。

权重

FP8。

LightOnOCR-3 4B API：常见问题

LightOnOCR-3 4B API 收费多少？

在 EmpirioLabs，LightOnOCR-3 4B 按量计费：文档OCR $3.00 每1000页，每个请求至少5页。本页的实时价格表始终与 API 的实际计费一致。

LightOnOCR-3 4B 使用哪个端点？

LightOnOCR-3 4B 通过 api.empiriolabs.ai 上的 POST /v1/ocr 提供，使用标准的 Bearer 令牌认证。

集成之前可以在浏览器里试用 LightOnOCR-3 4B 吗？

可以。EmpirioLabs Playground在浏览器中以与 API 相同的参数运行 LightOnOCR-3 4B，你可以在写代码之前先测试提示词。

如何获取 LightOnOCR-3 4B API 密钥？

创建 EmpirioLabs 账户，然后在控制台的 API Keys生成密钥。计费使用按量付费的额度，只为实际发出的请求付费。

LightOnOCR-3 4B API