OCR 文字识别 API 接入文档ocr-text

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

获取 API Key：登录 https://apizero.cn/account/keys

以下 5 种语言示例都是可直接运行的，只需把 YOUR_API_KEY 替换为实际 Key。

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

import requests

resp = requests.request(
    "POST",
    "https://v1.apizero.cn/api/ocr-text",
    headers={"X-Api-Key": "YOUR_API_KEY", "Content-Type": "application/json"},
    json={
    "input_type": "url",
    "input_data": "https://dummyimage.com/400x100/000/fff.png&text=Hello+World",
},
    timeout=15,
)
resp.raise_for_status()
print(resp.json())

// Node.js 18+ / 浏览器原生 fetch
const res = await fetch("https://v1.apizero.cn/api/ocr-text", {
  method: "POST",
  headers: {
    "X-Api-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "input_type": "url",
    "input_data": "https://dummyimage.com/400x100/000/fff.png&text=Hello+World"
  }),
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	body := []byte(`{"input_type":"url","input_data":"https://dummyimage.com/400x100/000/fff.png&text=Hello+World"}`)
	req, _ := http.NewRequest("POST", "https://v1.apizero.cn/api/ocr-text", bytes.NewBuffer(body))
	req.Header.Set("X-Api-Key", "YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")

	resp, err := http.DefaultClient.Do(req)
	if err != nil { panic(err) }
	defer resp.Body.Close()
	out, _ := io.ReadAll(resp.Body)
	fmt.Println(string(out))
}

<?php
$payload = json_encode([
    "input_type" => "url",
    "input_data" => "https://dummyimage.com/400x100/000/fff.png&text=Hello+World",
], JSON_UNESCAPED_UNICODE);

$ch = curl_init("https://v1.apizero.cn/api/ocr-text");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => "POST",
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_HTTPHEADER     => [
        "X-Api-Key: YOUR_API_KEY",
        "Content-Type: application/json",
    ],
    CURLOPT_TIMEOUT        => 15,
]);
$body = curl_exec($ch);
curl_close($ch);

$data = json_decode($body, true);
print_r($data);

{
    "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"
}

• 1.0.0(2026-05-06)
  • 首次上线，对接 alapi.cn /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 错误，不暴露内部配置