文字识别接口图片文字识别OCR图片转文字_API专区



POST/v3

请求参数（Query）

无参数

请求参数（Body）



接口信息

调用地址：https://wenzi.market.alicloudapi.com/v3

请求方式：POST

返回类型：JSON

API 调用：API 简单身份认证调用方法（APPCODE）API 签名认证调用方法（AppKey & AppSecret）

获取认证：AppKey & AppCode

接口参数

请求参数（Header）

无参数

请求参数（Query）

无参数

请求参数（Body）

字段名称	必填	字段详情
image string	Y	图片远程地址或base64编码，远程地址需要可访问，base64编码不含data:image/jpeg;base64,前缀，base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式实例值： http://storage.api51.cn/demo/yyzz.jpg
language_type string	N	识别语言类型，默认为CHN_ENG。可选值包括： - CHN_ENG：中英文混合； - ENG：英文； - POR：葡萄牙语； - FRE：法语； - GER：德语； - ITA：意大利语； - SPA：西班牙语； - RUS：俄语； - JAP：日语； - KOR：韩语
detect_language string	N	是否检测语言，默认不检测。当前支持（中文、英语、日语、韩语）
detect_direction string	N	是否检测图像朝向，默认不检测，即：false。朝向是指输入图像是正常方向、逆时针旋转90/180/270度。可选值包括: - true：检测朝向； - false：不检测朝向。
probability string	N	是否返回识别结果中每一行的置信度
paragraph string	N	是否输出段落信息
location string	N	是否输出每个字符位置信息

云市场服务保障

*请勿线下交易！90%的欺诈、纠纷、资金盗取均由线下交易导致。

商品介绍

产品亮点

文字识别底层托管阿里云Serverless平台，性能稳定。支持多场景下的文字检测识别，支持中、英、葡、法、德、意、西、俄、日、韩、中英混合识别，整体识别准确率高达90%以上

产品说明

接口区别说明

接口名称	上线日期	接口地址	说明
文字识别V1	2018年10月	http://wenzi.market.alicloudapi.com/do	仅支持图片base64识别
文字识别V2	2020年3月	http://wenzi.market.alicloudapi.com/v2	增加支持图片远程地址识别
文字识别V3	2023年6月	http://wenzi.market.alicloudapi.com/v3	增加location和paragraph参数

请求示例

HTTP 方法：POST

请求URL：http://wenzi.market.alicloudapi.com/v3

Header如下：

参数	值	说明
Authorization	APPCODE XXX	控制台左侧菜单云市场中的APPCODE值，与前方大写APPCODE中间空一个空格

请求参数：

参数	必选	类型	可选值	说明
image	url/base64 二选一	string	-	图像远程链接或base64数据，base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M，最短边至少15px，最长边最大4096px，支持jpg/jpeg/png/bmp格式
language_type	否	string	CHN_ENG ENG JAP KOR FRE SPA POR GER ITA RUS	识别语言类型，默认为CHN_ENG 可选值包括： - CHN_ENG：中英文混合 - ENG：英文 - JAP：日语 - KOR：韩语 - FRE：法语 - SPA：西班牙语 - POR：葡萄牙语 - GER：德语 - ITA：意大利语 - RUS：俄语
detect_direction	否	string	true/false	是否检测图像朝向，默认不检测，即：false。朝向是指输入图像是正常方向、逆时针旋转90/180/270度。可选值包括: - true：检测朝向； - false：不检测朝向。
detect_language	否	string	true/false	是否检测语言，默认不检测，即：false。当前支持中文、英语、日语、韩语
paragraph	否	string	true/false	是否输出段落信息
probability	否	string	true/false	是否返回识别结果中每一行的置信度

返回参数

字段	必选	类型	说明
direction	否	int32	图像方向，当 detect_direction=true 时返回该字段。 - - 1：未定义， - 0：正向， - 1：逆时针90度， - 2：逆时针180度， - 3：逆时针270度
log_id	是	uint64	唯一的log id，用于问题定位
words_result_num	是	uint32	识别结果数，表示words_result的元素个数
words_result	是	array[]	识别结果数组
+ words	否	string	识别结果字符串
+ probability	否	object	识别结果中每一行的置信度值，包含average：行置信度平均值，variance：行置信度方差，min：行置信度最小值，当 probability=true 时返回该字段
paragraphs_result	否	array[]	段落检测结果，当 paragraph=true 时返回该字段
+ words_result_idx	否	array[]	一个段落包含的行序号，当 paragraph=true 时返回该字段
paragraphs_result_num	否	uint32	识别结果数，表示 paragraphs_result的元素个数，当 paragraph=true 时返回该字段
language	否	int32	语种类型，当 detect_language=true 时返回该字段。 - - 1：未定义， - 0：英文， - 1：日文， - 2：韩文， - 3：中文

错误码

错误码	错误信息	说明
400	Invalid URL	URL错误
403	Forbidden	没有购买，或者购买次数用尽，或者URL错误
408	Request Timeout	超时
413	Payload Too Large	request body太大
450		后端服务队列满，请求被拒绝，重试即可
460	Invalid Input - failed to parse json	上传的body不符合json格式要求，是非法json
461	Invalid Input - json format error - missing key: image	新格式：输入Json中缺少image键旧格式：输入Json的inputs值中缺少image键
461	Invalid Input - json format error - image format error	新格式：输入Json中的image值不是字符串旧格式：输入Json中的image值不是包含DataValue和DataType的Json串
461	Invalid Input - json format error - key inputs missing	旧格式：输入Json中缺少inputs键
461	Invalid Input - json format error - value of inputs must be a array	旧格式：输入Json中的inputs值不是一个array
461	Invalid Input - json format error - image DataValue format error	旧格式：输入Json的image键中的DataValue值不是字符串
461	Invalid Input - json format error - configure format error	旧格式：输入Json中的configure值不是包含DataValue和DataType的Json
461	Invalid Input - json format error - failed to parse config str: xxx	输入的configure不是合法的Json
461	Invalid Input - json format error - json parse runtime exception	输入的Json格式不符合要求
462	Invalid Input - image data error - download image from url error	从URL下载图像失败
462	Invalid Input - image data error - input image empty, please check your image binary data	输入的image是空字符串
462	Invalid Input - image data error - image decode failed, please check your image binary data	输入的image解码失败、base64编码的是不合法的图像格式
462	Invalid Input - image data error - base64decode error, please check your image binary data	输入的image不是合法的base64字符串
462	Invalid Input - image data error - please remove additional header: data:image/jpg:base64,	请删除base64字符串多余的头： data:image/jpg:base64
462	Invalid Input - image data error - base64decode error: incorrect padding in base64 string	输入的image不是合法的base64字符串，base64编码的数据长度需要是4的倍数，如果长度不够，需要再末尾加上=补足。
462	Invalid Input - image data error - base64decode error: base64decode error: incorrect base64 format data	输入的image不是合法的base64字符串，存在非法字符
462	Invalid Input - image data error - open gif image failed	GIF图像打开失败
462	Invalid Input - image data error - read gif image failed	GIF图像读取失败
462	Invalid Input - image data error - decode gif image failed	GIF图像解码失败
462	Invalid Input - image data error - gif data error, no color map got	GIF获取颜色映射表错误
462	Invalid Input - image data error - gif image empty	GIF图像是为空
463	Invalid Input - wrong category	输入图像不是对应服务的图像，如行驶证服务请求的不是行驶证
464	Invalid Result - algorithm run failed	OCR识别失败
464	Invalid Result - algorithm runtime exception	OCR识别异常
464	Invalid Result - xxx	OCR识别失败
469	Invalid Service - parse result error	内部异常
469	Invalid Service - error code missing	内部异常
502	Bad Gateway	识别程序超时并断开连接
503	Service Unavailable	API网关等待超时断开连接
1	Unknown error	未知错误，请再次请求，如果持续出现此类错误，请联系技术支持团队
2	Service temporarily unavailable	服务暂不可用，请再次请求，如果持续出现此类错误，请联系技术支持团队
216100	invalid param	请求中包含非法参数，请检查后重新尝试
216101	not enough param	缺少必须的参数，请检查参数是否有遗漏
216102	service not support	请求了不支持的服务，请检查调用的url
216103	param too long	请求中某些参数过长，请检查后重新尝试
216110	appid not exist	appid不存在，请重新核对信息是否为后台应用列表中的appid
216200	empty image	图片为空，请检查后重新尝试
216201	image format error	上传的图片格式错误，现阶段我们支持的图片格式为：PNG、JPG、JPEG、BMP，请进行转码或更换图片
216202	image size error	上传的图片大小错误，现阶段我们支持的图片大小为：base64编码后小于4M，分辨率不高于4096x4096，请重新上传图片
216202	input oversize	上传的包体积过大，现阶段不支持 10M 或以上的数据包
216306	Upload file error	上传文件失败，请检查提交请求接口的请求参数
216308	Pdf_file_num exceeds the number of pdf pages	参数pdf_file_num大于PDF文件实际页数
216401	Create task failed	提交请求失败
216402	Query task failed	获取结果失败
216603	Check pdf page num failed	获取PDF文件页数失败，请检查PDF文件以及base64编码
216604	Insufficient available quota	请求总量超限额，您可以购买或申请更多限额
216630	recognize error	识别错误，请再次请求，请确保图片中包含对应卡证票据
216631	recognize bank card error	识别银行卡错误，出现此问题的原因一般为：您上传的图片非银行卡正面，上传了异形卡的图片、上传的银行卡正面图片不完整或模糊
216633	recognize idcard error	识别身份证错误，出现此问题的原因一般为：您上传了非身份证图片、上传的身份证图片不完整或模糊
216634	detect error	检测错误，请再次请求，如果持续出现此类错误，请在联系技术支持团队
282000	internal error	服务器内部错误，如果您使用的是高精度接口，报这个错误码的原因可能是您上传的图片中文字过多，识别超时导致的，建议您对图片进行切割后再识别，其他情况请再次请求，如果持续出现此类错误，请联系技术支持团队
282003	missing parameters: {参数名}	请求参数缺失
282005	batch processing error	处理批量任务时发生部分或全部错误，请根据具体错误码排查
282006	batch task limit reached	批量任务处理数量超出限制，请将任务数量减少到10或10以下
282100	image transcode error	图片压缩转码错误
282102	target detect error	未检测到图片中识别目标，请确保图片中包含对应卡证票据，出现此问题的原因一般为：您上传了非卡证图片、图片不完整或模糊
282103	target recognize error	图片目标识别错误，请确保图片中包含对应卡证票据，出现此问题的原因一般为：您上传了非卡证图片、图片不完整或模糊
282110	urls not exit	URL参数不存在，请核对URL后再次提交
282111	url format illegal	URL格式非法，请检查url格式是否符合相应接口的入参要求
282112	url download timeout	url下载超时，请检查url对应的图床/图片无法下载或链路状况不好，或图片大小大于3M，或图片存在防盗链，您可以重新尝试以下，如果多次尝试后仍不行，建议更换图片地址
282113	url response invalid	URL返回无效参数
282114	url size error	URL长度超过1024字节或为0
282808	request id: xxxxx not exist	request id xxxxx 不存在
282809	result type error	返回结果请求错误（不属于excel或json）
282810	image recognize error	图像识别错误，请再次请求，如果持续出现此类错误，请联系技术支持团队

返回示例

{
   "log_id": 2432938548,
   "words_result": [ {
       "words": "陕西省西安市国家民用航天产业基地神舟四路239号2栋5"
   }, {
       "words": "法定代表人张强"
   }, {
       "words": "注册资本壹佰万元人民币"
   }, {
       "words": "成立日期2014年05月30日"
   }, {
       "words": "营业期限长期"
   }, {
       "words": "经营范围软件设计与开发;企业信息化服务;网络工程设计施工;网站设"
   }, {
       "words": "计与开发;计算机软硬件销售;计算机技术开发、技术服务;商"
   }, {
       "words": "标、版权、著作权、专利的代理及转让;广告的设计、制作、代"
   }, {
       "words": "理、发布。(依法须经批准的项目,经相关部门批准后方可开展"
   }, {
       "words": "经营活动)"
   }, {
       "words": "商行"
   }, {
       "words": "登记机关"
   }, {
       "words": "★"
   }, {
       "words": "请于每年1月1日至6月30日报送上一年度年度报告。自公司"
   }, {
       "words": "成立之日以及企业相关信息形成之日起20个工作日内,在企业2018年05月02日"
   }, {
       "words": "信用信息公示系统进行公示"
   }],
   "words_result_num": 27
}

产品参数

交付方式	API
开票主体	西安网极网络科技有限公司
所属类目	AI应用与OCR
上架日期	2018-11-01

售后支持范围

9:00--18:00 在线客服

本页面内容由服务商提供

商品价格(此处价格仅供参考，实际价格以选配后的价格为准)

版本名称	计费项	新购
试用套餐	版本基础价格	5元
1万次/1年	版本基础价格	280元
10万次/1年	版本基础价格	2580元
50万次/2年	版本基础价格	12800元
1百万次/3年	版本基础价格	25800元
1千万次/5年	版本基础价格	258000元

使用指南

立即下载

服务商

西安网极网络科技有限公司

网极科技致力于用最简洁的技术为客户带来最大价值

服务商星级：

企业应用
数据与API
建站小程序
基础软件
专业服务
安全
开发与运维

客服在线：9:00--5:30

旺旺：

在线客服旺旺：

发票问题钉钉：技术支持

电话：029-85795818

邮箱：wangjikeji@yeah.net

入住时间：2017-06-12

所在地区：610000 610100

入驻集市：企业软件数据市场建站市场软件市场服务市场云安全市场

可开发票类型：增值税普通发票

查看工商登记信息

问题处理：

店铺交易情况

商家商品数量：46近180天成交订单量：1375近180天退单率：0.29%

店铺评分状态

评价数量：6644条
综合总分：5分
完成质量：5分
工作速度：5分
服务态度：5分

综合总分5分的分布

0.00%
0.00%
0.00%
0.00%
0.00%

用户评论 (15)

综合评分

4.33分

接口稳定(7)创新性强(2)数据稳定(2)识别率高(5)数据准确(5)响应及时(5)文档清晰(2)速度快(5)

a****8评分：5.0分2023-07-09 19:34套餐版本：试用套餐: 响应及时数据准确识别率高接口稳定; 价格可以说是同行业里面最低的了，这家服务商真的太好了，希望可以长期合作; [服务商回复] 谢谢亲的支持，合作愉快; [追加评论]; [服务商追加回复]

a****8评分：5.0分2023-07-09 19:33套餐版本：238元/1w次: 文档清晰接口稳定响应及时速度快; 识别率对于我的需求完全达标，价格也合适，希望可以长期用; [服务商回复]; [追加评论]; [服务商追加回复]

a****8评分：5.0分2023-07-09 19:32套餐版本：2008元/10w次: 速度快数据准确接口稳定数据稳定; 服务商处理事情的效率真的太高了，用着用着接口出了有问题，提出来后立马按照我的想法去进行了修复，真的是效率太高了，必须给一个五星好评; [服务商回复]; [追加评论]; [服务商追加回复]

a****8评分：5.0分2023-07-09 19:32套餐版本：2008元/10w次: 接口稳定识别率高数据稳定文档清晰; 服务商处理事情的效率真的太高了，用着用着接口出了有问题，提出来后立马按照我的想法去进行了修复，真的是效率太高了，必须给一个五星好评; [服务商回复]; [追加评论]; [服务商追加回复]

a****8评分：5.0分2023-07-09 19:31套餐版本：2008元/10w次: 速度快响应及时创新性强数据准确; 服务商处理事情的效率真的太高了，用着用着接口出了有问题，提出来后立马按照我的想法去进行了修复，真的是效率太高了，必须给一个五星好评; [服务商回复]; [追加评论]; [服务商追加回复]

a****8评分：5.0分2023-05-31 10:45套餐版本：2008元/10w次: 速度快响应及时接口稳定识别率高; 服务商处理事情的效率真的不错，终于找到一个能长期合作的服务商了，接口有问题，提出来立马按照我的想法去进行了修改，真的是效率太高了，必须好评; [服务商回复] 谢谢支持，有问题随时联系我们; [追加评论]; [服务商追加回复]

s****8评分：5.0分2023-05-29 17:50套餐版本：免费试用: 数据准确接口稳定识别率高; 识别率还可以，价格也合适，希望可以长期用; [服务商回复] 谢谢支持，祝您事业一帆风顺; [追加评论]; [服务商追加回复]

h****1评分：5.0分2023-05-29 17:45套餐版本：试用套餐: 响应及时创新性强数据准确; 识别率高，还很便宜，哇哈！; [服务商回复] 谢谢支持，祝您事业一帆风顺。; [追加评论]; [服务商追加回复]

h****1评分：5.0分2023-05-29 17:44套餐版本：免费试用: 速度快接口稳定识别率高; 客服兄弟很给力，刚开始看到差评有点犹豫，就下了免费试用单，请求调不通，联系客服兄弟，很快得到解决。问起怎么这么差的客户评价，反应是同行恶意。这个世道确实如此啊。免费试用不花钱，大家可以自己试试。反正结果事实胜于雄辩了。; [服务商回复] 谢谢支持，祝您事业一帆风顺。; [追加评论]; [服务商追加回复]

w****p评分：1.0分2021-01-14 16:30套餐版本：文字识别接口: 做为已经购买了服务的我来说，这家OCR奉劝你们不要用，完全是个大坑的。说是ocr接口，但是部分机型截图根本无法识别文字（本人亲测），文字不能识别你还叫什么ocr？阿里云上提了工单，该司技术售后好几天工单没人回复，后来加了QQ，也是一直不回话，这服务态度真牛，我还是个付费用户。最后总结下，千万不要用这家的接口，便宜是便宜，里面坑很多，各位小心。; [服务商回复]; [追加评论]; [服务商追加回复]