接口调用地址
线路类型一 [普通集群负载-IP接口]
说明：直接访问 https://api.apihz.cn/getapi.php 获取当前最优IP接口地址。由普通负载集群服务器组成，通过IP接口地址调用，如果单个服务器过载可自行切换IP接口地址尝试其他负载服务器。IP并非永久固定且容易遭受攻击，平台可能不定期更换。
线路类型二 [普通集群负载-域名接口]
说明：域名接口会自动分发请求到普通集群服务器均衡负载，该域名TTL值为60秒，表示你的请求会每60秒实现自动轮换负载服务器，但也可能因你的网络服务商存在DNS缓存造成短时间内无法自动切换负载。如果某个负载服务器出现故障，也可能会造成个别地区存在一定时间的故障期。
线路类型三 [VIP集群负载-VIP线路接口]
说明：VIP专线在普通集群组的基础上额外增加独享大带宽集群组，每次请求自动均衡负载，自动故障切换，抗攻击，全球智能CDN加速。超高稳定性！最低30¥/月，彩钻以上会员专属，登录后购买。注：VIP线路是指调用接口的线路更有保障以及每分钟拥有更高的调用频次等，并非收费接口包月使用。
请求示例
[GET]请求示例：(请登录后使用自己的KEY独享频次)
复制参数
复制全部
[POST]请求示例：(请根据开发语言自行POST，参考【GET/POST教程】，或下载【超级客户端】调试。)
请求参数说明
注意：请求编码为UTF8，否则带中文请求可能失败。一般参数不能带+号，会被自动替换为空格。参数内容较大的必须用POST，不能GET。
提示：如发现接口有BUG，可加服务QQ群及时向我们反馈。
提示：请求参数里的开发者ID与KEY，登录后台菜单【个人资料】里查看。
提示：如发现接口有BUG，可加服务QQ群及时向我们反馈。
提示：请求参数里的开发者ID与KEY，登录后台菜单【个人资料】里查看。
| 名称 | 参数 | 必填 | 说明 |
|---|---|---|---|
| 开发者ID | id | 是 | 用户中心的数字ID，例：id=10000000 |
| 开发者KEY | key | 是 | 用户中心通讯秘钥，例：key=15he5h15ty854j5sr152hs2 |
| 识别语言 | lan | 否 | 指定识别语言，默认中英识别，可2-3种组合，用<>链接，例如eng<>chi_sim，在识别语言不正确时可自行指定语言包。对应语言包请查看【https://www.apihz.cn/article/c53554be3692bd5e1ccf0115c74d76f6.html】例：lan=chi_sim |
| 二值化 | type | 否 | 1=二值化处理，0=不处理，识别内容不理想时可进行二值化处理，默认1。例：type=1 |
| 二值化调整 | threshold | 否 | 调整二值化级别，0-1之间的单精度小数，不同的图片可通过调整二值化级别来提升识别准确度，默认0.7。例：threshold=1 |
| 分割模式 | psm | 否 | 0：定向脚本检测（OSD）1：自动页面分割，使用OSD2：自动页面分割，但不使用OSD，不进行方向检测3：全自动页面分割，但不使用OSD 4：假设文本为单列，可变大小5：假设为垂直文本块6：假设为统一的文本块7：将图像视为单个文本行8：将图像视为单个单词9：将图像视为一个圆形中的单个单词10：将图像视为单个字符，默认10，一般保持默认即可。例：psm=10 |
| 图片 | img | 是 | 可以是网络图片地址，也可以是BASE64图片编码数据，图片大小不能超过500KB，例：img=https://down.erguanmingmin.com/api/test/test.png |
| 动态秘钥 | dkey | 否 | 开发者开启动态秘钥验证后需传此参数，主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例：dkey=0cd2a494831736587c33f30d1e544371 |
| 用户IP | uip | 否 | 接口调用者IP，用于后台统计IP地域分布，ISP运营商，时段IP数统计等，如不传该参数则默认为接口请求端IP，该参数主要用于使用后端服务器/中间件请求接口的方式使用。例：uip=123.123.123.123。该参数彩钻/炫钻/焱钻会员专享。 |
返回参数说明
| 名称 | 参数 | 说明 |
|---|---|---|
| 状态码 | code | 200成功，400错误 |
| 消息内容 | msg | 信息提示。 |
| 识别数据集 | data | 识别数据集。 |
| 识别文字 | data.text_nospace | 识别出的文字内容。 |
| 识别区域 | data.count | 识别出的文字区域数量。 |
| 文字数量 | data.wordcount | 文字数量，最多返回500个字。 |
| 文字数据集 | data.items | 文字数据集。 |
| 识别文字单个 | data.items.text | 识别出的单个文字。 |
| 可信度 | data.items.confidence | 可信度，准确度。 |
| 坐标数据集 | data.items.bbox | 识别出的文字坐标数据集。 |
| 左边距离 | data.items.bbox.left | 横坐标。 |
| 顶边距离 | data.items.bbox.top | 纵坐标。 |
| 宽度 | data.items.bbox.width | 文字宽度。 |
| 高度 | data.items.bbox.height | 文字高度。 |
返回数据示例
示例：{"code":400,"msg":"通讯秘钥错误。"}
示例：
{
"code": 200,
"msg": "识别成功",
"data": {
"items": [{
"text": "解",
"confidence": 92,
"bbox": {
"left": 25,
"top": 25,
"width": 26.5,
"height": 17
}
}, {
"text": "决",
"confidence": 92,
"bbox": {
"left": 51.5,
"top": 25,
"width": 26.5,
"height": 17
}
}, {
"text": "方",
"confidence": 96,
"bbox": {
"left": 80,
"top": 25,
"width": 11.5,
"height": 17
}
}, {
"text": "案",
"confidence": 96,
"bbox": {
"left": 91.5,
"top": 25,
"width": 11.5,
"height": 17
}
}, {
"text": "1",
"confidence": 70,
"bbox": {
"left": 107,
"top": 21,
"width": 4.5,
"height": 31
}
}, {
"text": ";",
"confidence": 70,
"bbox": {
"left": 111.5,
"top": 21,
"width": 4.5,
"height": 31
}
}, {
"text": "修",
"confidence": 93,
"bbox": {
"left": 123,
"top": 25,
"width": 25.5,
"height": 17
}
}, {
"text": "复",
"confidence": 93,
"bbox": {
"left": 148.5,
"top": 25,
"width": 25.5,
"height": 17
}
}, {
"text": "目",
"confidence": 96,
"bbox": {
"left": 160,
"top": 21,
"width": 17,
"height": 31
}
}, {
"text": "录",
"confidence": 96,
"bbox": {
"left": 177,
"top": 21,
"width": 17,
"height": 31
}
}, {
"text": "权",
"confidence": 96,
"bbox": {
"left": 195,
"top": 25,
"width": 25.5,
"height": 17
}
}, {
"text": "限",
"confidence": 96,
"bbox": {
"left": 220.5,
"top": 25,
"width": 25.5,
"height": 17
}
}, {
"text": "问",
"confidence": 93,
"bbox": {
"left": 249,
"top": 21,
"width": 10,
"height": 31
}
}, {
"text": "题",
"confidence": 93,
"bbox": {
"left": 259,
"top": 21,
"width": 10,
"height": 31
}
}],
"text_nospace": "解决方案1;修复目录权限问题",
"count": 14,
"wordcount": 14
}
}
更新记录
