# 印刷体OCR识别支持手写楷书吗？实测与边界说明
> 接口 926（接入点 926-1） · 免费 · POST/GET · JSON · 适用人群：文档/表单/笔记处理开发者 · 阅读时间：约 5 分钟
## 核心要点
- 官方说明：该接口支持多语言文本（简体中文、英文等），及**部分手写楷书中文**。
- 「部分」是关键：并非所有手写体都稳，草书、连笔、个性化字迹通常识别不稳。
- 手写场景建议：先小样本实测，对低置信度行做人工复核，必要时换专业手写识别方案。
## Why：手写识别是高频但又最容易翻车的场景
发票、签名、课堂笔记、表单……大量真实材料是手写的。印刷体OCR识别标称「支持部分手写楷书」，听起来能省一套专门的手写识别服务。但「部分」二字意味着它不是万能的——本文帮你划清边界，避免把不可靠的结果直接入库。
## What：接口对手写的能力声明
文档原文（接入点说明）：「该接口用于提取印刷体文字，支持多语言及**部分手写楷书中文**。」
也就是说：
- ✅ 印刷体：主力能力，稳定。
- ⚠️ 手写楷书（工整的楷体手写）：**部分**可识别，取决于字迹工整度。
- ❌ 草书/连笔/高度个性化手写：未声明支持，实际不稳。
> 注意：官方未给出「手写识别准确率」等量化指标，以下对比为**实测观察示例**，非官方承诺数据，仅供判断边界参考。
## How：手写图怎么测
用一张手写楷书图，传 `need_all_region=1` 看 `list` 的 `text` 与 `confidence`：
**Python**
```python
import base64, requests
with open("handwriting.png", "rb") as f:
b64 = base64.b64encode(f.read()).decode("utf-8")
url = "https://route.showapi.com/926-1"
params = {"appKey": "YOUR_APPKEY"}
data = {"img_base64": b64, "need_all_region": "1"}
r = requests.post(url, params=params, data=data, timeout=10)
rb = r.json()["showapi_res_body"]
for it in rb.get("list", []):
flag = "✓" if it["confidence"] >= 0.8 else "⚠ 建议人工复核"
print(flag, it["text"], round(it["confidence"], 3))
```
**cURL**
```bash
B64=$(base64 -w0 handwriting.png)
curl -X POST "https://route.showapi.com/926-1?appKey=YOUR_APPKEY" \
-H "content-type: application/x-www-form-urlencoded" \
--data-urlencode "img_base64=$B64" \
--data-urlencode "need_all_region=1"
```
**Node.js（fetch）**
```javascript
import fs from "fs";
const b64 = fs.readFileSync("handwriting.png").toString("base64");
const res = await fetch("https://route.showapi.com/926-1?appKey=YOUR_APPKEY", {
method: "POST",
headers: { "content-type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({ img_base64: b64, need_all_region: "1" }),
});
const rb = (await res.json()).showapi_res_body;
(rb.list || []).forEach((it) => console.log(it.text, it.confidence));
```
## 实测观察（示例，非官方指标）
| 手写类型 | 观察结果（示例） | 建议 |
|---------|----------------|------|
| 工整楷书（横平竖直） | confidence 多在 0.8+，文字基本正确 | 可直接采用，低分行仍复核 |
| 略连笔但可辨认 | confidence 波动大（0.5~0.85），偶有错字 | 必须人工复核 |
| 草书/艺术字 | 常 `70 OCR识别失败` 或结果错乱 | 不建议用本接口，换专用手写识别 |
> 上表为常见情况的经验归纳，具体取决于字迹；请用你自己的样本实测，不要据此直接决策。
## 进阶 / 边界
- **强调「部分」**：不要向业务方承诺「支持手写识别」，应表述为「对工整楷书有部分识别能力」。
- **置信度兜底**：手写场景务必结合 `confidence` 做低分行人工复核，避免把猜测当事实入库。
- **专属场景替代**：若手写是核心需求（如作业批改、签批），建议评估专业手写识别服务，本接口作为辅助。
## FAQ
**Q1：我能用它做填空题/作文识别吗？**
A1：工整楷书填空题可小样本试；长篇作文多为连笔，稳定性差，不建议作为主方案。
**Q2：为什么同一张手写图有时成功有时失败？**
A2：与图片质量（光照、对比度、像素）强相关；确保像素 < 1200×1200、清晰、背景干净可提升稳定性。
**Q3：返回 70 OCR 识别失败一定是手写问题吗？**
A3：不一定，也可能是图片模糊、过大或解析失败；先排查图片本身，再判断是否为手写不支持。
**Q4：有没有「仅手写」模式？**
A4：接口无区分印刷/手写的开关，统一走同一识别流程；是否识别出手写由模型内部决定。
## 相关能力 / 下一步阅读
- [印刷体OCR识别：用 need_all_region 获取每行文字坐标与置信度](https://www.showapi.com/guides/printed-ocr-coordinates-926)
- [印刷体OCR识别错误码排查：10 参数错误到 90 识别异常逐条对照](https://www.showapi.com/guides/printed-ocr-error-handling-926)
- [5 分钟接入印刷体OCR识别：从注册到第一条识别结果](https://www.showapi.com/guides/printed-ocr-quickstart-926)
- **本系列共 12 篇**：查看[印刷体OCR识别指南总目录](https://www.showapi.com/guides/printed-ocr-guides-926)
