OCR 文字识别

概述

通用 OCR 文字识别，从图片中提取任意文字内容（中文/英文/数字/符号/手写体等），返回逐行文本列表 + 完整拼接文本。 • 双输入模式： - input_type=url：传入公网可访问的图片 URL（http/https） - input_type=base64：传入 base64 编码字符串（≤6MB，自动剥离 data:image/...;base64, 前缀） • 三路输出： - text_list：按原图顺序的逐行文本数组 - full_text：用换行符 \n 拼接的完整文本字符串 - text_count：识别到的文本行数 • 适用场景：截图转文字、表格识别、身份证/名片文字提取、字幕识别、笔记 OCR 等通用场景。专用发票识别请用 /api/invoice。 • OCR 结果缓存 1 小时（同图同结果），重复调用不消耗服务配额。

鉴权

匿名每日 5 次、QPS 1；登录用户每日 30 次、QPS 2（全部免费）。OCR 结果缓存 1 小时，相同图片只实际调用服务一次。

获取 API Key：获取 API Key/account/keys

请求参数

POST · APPLICATION/JSON

{
  "input_type": "url",
  "input_data": "https://dummyimage.com/400x100/000/fff.png&text=Hello+World"
}

返回结果

顶层固定为 code / msg / data。下表一般是 data 内字段。 code · msg · data · tips · request_id

返回示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "input_type": "url",
    "text_count": 3,
    "text_list": [
      "商品名称：无线蓝牙耳机",
      "单价：¥299.00",
      "数量：2"
    ],
    "full_text": "商品名称：无线蓝牙耳机\n单价：¥299.00\n数量：2"
  },
  "request_id": "abc123def456",
  "tips": "极数本源 · https://apizero.cn"
}

请求示例

示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。

curl -sS -X POST "https://v1.apizero.cn/api/ocr-text" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input_type": "url",
  "input_data": "https://dummyimage.com/400x100/000/fff.png&text=Hello+World"
}'

错误码

先看业务 code。HTTP 也可能不是 200。

调用限制

购买套餐、看评价请走商城详情。 购买 / 调试

更新日志

• 1.0.02026-05-06

  首次上线，/api/ocr/text 通用 OCR 服务 双输入模式：URL 直接抓取 / base64 直传 base64 模式自动剥离 data:image/...;base64, 前缀 base64 上限 6MB，防止 OOM；URL 模式强制 http/https，防 SSRF OCR 结果缓存 1h（按 sha256 哈希），相同图片不重复调用付费服务 兼容 text_list 两种形式：纯字符串数组 / 含 text 字段的对象数组 额外输出 full_text（换行拼接）+ text_count（行数），便于前端直接使用 token 异常转为通用 5021 错误，不暴露内部配置

免责声明