加载接口文档…
OCR 文字坐标识别
API从图片识别文字，并返回每条文字在原图上的像素坐标（外接矩形 rect + 四点 box）。适合图片编辑：定位后盖字、换字、打码。 和「OCR 文字识别」是两个接口：旧接口只回文字，本接口多回坐标。参数一样，还是 input type + input data。 坐标系：原图左上角…
由 极数本源 提供·更新于 昨天
8
累计调用
1885ms
平均响应
100.00%
服务可用性
200 次/日
免费额度
访问限制
查看更多方案 →无 Key 调用
每天 40 次 · 每秒 1 次
登录免费
当前方案每天 200 次 · 每秒 2 次
黄金会员
每天 40,000 次 · 每秒 10 次
钻石会员
每天 80,000 次 · 每秒 30 次
企业会员
本接口约 19,950 次/月 · QPS 120
接入文档
接口请求地址
https://v1.apizero.cn/api/ocr-text-box
接口请求方式
POST
请求参数格式
APPLICATION/JSON
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/ocr-text-box
接口信息备注
与 OCR 文字识别相同：可带 API Key。参数仍是 input_type + input_data，不要改旧接口。登录每天 200 次免费，未登录 40 次，黄金 4 万、钻石 8 万，比普通 OCR 略少。超出 0.02 元/次。
请求参数说明
input_typestring
必填 · 图片传入方式：url 或 base64 · 示例：url
input_datastring
必填 · 图片 URL（http/https）或 base64（可带 data:image 前缀，最大 10 MB） · 示例：https://dummyimage.com/400x100/000/fff.png&text=Hello
| 名称 | 类型 | 说明 |
|---|---|---|
| input_type | string | 必填 · 图片传入方式：url 或 base64 · 示例：url |
| input_data | string | 必填 · 图片 URL（http/https）或 base64（可带 data:image 前缀，最大 10 MB） · 示例：https://dummyimage.com/400x100/000/fff.png&text=Hello |
请求头说明
Authorizationstring
必填 · 必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。
Content-Typestring
必填 · application/json 或 form
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 必填 · 必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。 |
| Content-Type | string | 必填 · application/json 或 form |
返回字段说明
input_typestring
回传输入类型 url / base64
image.widthnumber
原图宽度（像素），坐标系按这张图
image.heightnumber
原图高度（像素）
text_countnumber
识别到的文本块数量
itemsarray
文本块列表，顺序与图上检测顺序一致
indexnumber
从 0 开始的序号
textstring
该块识别出的文字
scorenumber
置信度 0~1，可能为 null
rectobject
轴对齐外接矩形，编辑时优先用这个
xnumber
左上角 x（像素）
ynumber
左上角 y（像素）
widthnumber
矩形宽
heightnumber
矩形高
boxarray
四个角 [[x,y],...]，斜向文字更准
items[].box[]array
items[].box 的一项
full_textstring
全部文字用换行拼起来，便于预览
tipsstring
品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn
| 名称 | 类型 | 说明 | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| input_type | string | 回传输入类型 url / base64 | ||||||||||||||||||||||||||||||||||||
| image.width | number | 原图宽度（像素），坐标系按这张图 | ||||||||||||||||||||||||||||||||||||
| image.height | number | 原图高度（像素） | ||||||||||||||||||||||||||||||||||||
| text_count | number | 识别到的文本块数量 | ||||||||||||||||||||||||||||||||||||
| items | array | 文本块列表，顺序与图上检测顺序一致 | ||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||
| full_text | string | 全部文字用换行拼起来，便于预览 | ||||||||||||||||||||||||||||||||||||
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn | ||||||||||||||||||||||||||||||||||||
返回示例
{
"code": 0,
"msg": "成功",
"data": {
"input_type": "url",
"image": {
"width": 906,
"height": 1280
},
"text_count": 2,
"items": [
{
"index": 0,
"text": "拒绝褶皱告别尴尬",
"score": 0.9876,
"rect": {
"x": 80,
"y": 36,
"width": 740,
"height": 88
},
"box": [
[
80,
36
],
[
820,
40
],
[
818,
124
],
[
78,
120
]
]
},
{
"index": 1,
"text": "抗皱黑科技",
"score": 0.9812,
"rect": {
"x": 620,
"y": 690,
"width": 210,
"height": 48
},
"box": [
[
620,
690
],
[
830,
692
],
[
828,
738
],
[
618,
736
]
]
}
],
"full_text": "拒绝褶皱告别尴尬\n抗皱黑科技"
},
"request_id": "req_example",
"tips": "极数本源 · https://apizero.cn"
}免责声明
坐标按原图像素返回（左上角为原点）。结果随图片清晰度变化；斜向、艺术字、低对比可能漏识或框偏。请勿用于违法用途。