OCR.space 免费 OCR 接口：每月 2.5 万次额度如何申请与调用教程

这个平台不提供对话补全，只有一个图像解析地址，所有调用都是向它 POST 文件或图片地址。

base_url 形态固定为 https://api.ocr.space/parse/image，没有版本号区分，也没有区域节点。所谓「模型」就是 OCREngine 参数：1 轻量、2 为默认、3 精度最高但消耗赠送额度。

用 curl 发一次识别请求

key 通过请求头 apikey 传递（也可以放在表单字段里），文件用 file 字段上传，同时指定语言、引擎与表格解析。

export OCR_API_KEY="替换为邮件里收到的密钥"

curl -X POST https://api.ocr.space/parse/image \
  -H "apikey: $OCR_API_KEY" \
  -F "file=@invoice.jpg" \
  -F "language=chs" \
  -F "isTable=true" \
  -F "OCREngine=2"

用 Python 读取识别文本

返回是一段 JSON，正文在 ParsedResults[0].ParsedText 中，出错时重点看 IsErroredOnProcessing 与 ErrorMessage。

import requests

api_key = "替换为邮件里收到的密钥"

with open("invoice.jpg", "rb") as f:
    resp = requests.post(
        "https://api.ocr.space/parse/image",
        headers={"apikey": api_key},
        files={"file": f},
        data={"language": "chs", "isTable": "true", "OCREngine": "2"},
        timeout=60,
    )

result = resp.json()
if result.get("IsErroredOnProcessing"):
    print(result.get("ErrorMessage"))
else:
    print(result["ParsedResults"][0]["ParsedText"])

关键参数说明

• file / url / base64Image：三种入参任选其一，本地文件上传、图片直链、Base64 数据都支持。
• language：指定识别语言，简体中文用 chs，英文用 eng；Engine 3 覆盖 200 多种语言，具体代码见官方文档。
• isOverlayRequired：设为 true 时返回每个词的坐标，适合版面还原和字段定位。
• isTable：设为 true 时按行解析表格，发票、票据类识别比纯文本更可靠。
• filetype：上传 PDF 时用来声明类型，不确定可交给接口自动判断。

下图是平台对配料表这类图片的识别结果示例，正文与坐标会一起返回：

PDF 与多页文档

免费档在 PDF 上限制最明显：单文件 1MB 以内、最多处理 3 页，超出部分不会识别；搜索版 PDF 输出还会带平台水印。下图展示的就是可搜索 PDF 的输出形态：

额度耗尽与限流怎么排查

触发限流或超限时，HTTP 状态码往往仍是 200，但 JSON 里 IsErroredOnProcessing 会变成 true，ErrorMessage 会写明具体原因，常见的是超出 24 小时内 500 次上限、文件过大或页数超限。建议按下面的顺序逐一排查：

1. 先打印完整响应体，读 ErrorMessage 原文，不要只看 HTTP 状态码就判断调用失败。
2. 核对 apikey 是否拼写正确，是否被复制时带进了空格或换行。
3. 统计当天调用量：单 IP 每天 500 次是硬上限，多台机器共用一个出口 IP 时很容易提前打满。
4. 检查文件是否超过 1MB、PDF 是否超过 3 页，必要时压缩图片或先把文档拆分。
5. 确认是否误用了 Engine 3 且赠送的 1,000 次已经用完，切回 Engine 2 即可继续调用。

如果确实需要更高并发或更长文档，只能考虑升级付费套餐。免费档的额度和限制会随官方调整，具体数值以官网页面与控制台实际显示为准，不建议把关键业务完全押在免费额度上。