加载接口文档…
OCR 文字识别
API通用 OCR 文字识别，从图片中提取任意文字内容（中文/英文/数字/符号/手写体等），返回逐行文本列表 + 完整拼接文本。 • 双输入模式： - input type=url：传入公网可访问的图片 URL（http/https） - input type=base64：传入 ba…
由 极数本源 提供·更新于 昨天
2.4万
累计调用
2245ms
平均响应
99.03%
服务可用性
300 次/日
免费额度
访问限制
查看更多方案 →无 Key 调用
每日 50 次 · QPS 1
登录免费
当前方案每日 300 次 · QPS 2
黄金会员
每日 50,000 次 · QPS 10
钻石会员
每日 100,000 次 · QPS 30
企业会员
企业接口额度 · QPS 120
接入文档
在线工具
接口请求地址
https://v1.apizero.cn/api/ocr-text
接口请求方式
POST
请求参数格式
APPLICATION/JSON
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/ocr-text
接口信息备注
匿名每日 5 次、QPS 1；登录用户每日 30 次、QPS 2（全部免费）。OCR 结果缓存 1 小时，相同图片只实际调用服务一次。
请求参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| input_type | string | 必填 · 输入类型：url=图片URL / base64=图片base64编码 · 示例：url |
| input_data | string | 必填 · 图片数据。input_type=url 时为 http/https 完整 URL；input_type=base64 时为 base64 字符串（最大 6MB，可选 data:image/jpeg;base64, 前缀） · 示例：https://dummyimage.com/400x100/000/fff.png&text=Hello+World |
请求头说明
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。 |
| Content-Type | string | 必填 · POST 请求体类型，固定 application/x-www-form-urlencoded |
返回字段说明
| 名称 | 类型 | 说明 | |||
|---|---|---|---|---|---|
| input_type | string | 回传输入类型（url 或 base64） | |||
| text_count | number | 识别到的文本行数 | |||
| text_list | array | 按原图顺序的逐行文本数组（字符串数组） | |||
| |||||
| full_text | string | 用换行符 \n 拼接的完整文本字符串，便于前端直接展示 | |||
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn | |||
返回示例
{
"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"
}免责声明
本接口第三方 OCR 服务，识别准确率取决于图片清晰度（建议 ≥720P 分辨率、文字清晰无遮挡）。OCR 服务为付费配额，请合理使用。识别失败原因可能包括：图片模糊、文字被遮挡、URL 不可达、base64 数据损坏等。