文档中心>文字识别

OCR-增值税发票识别

最近更新时间:2021-07-28 17:22:24

我的收藏
Note:
增值税发票识别接口全面升级,算法更强、性能更优,支持子账号调用。欢迎立即体验 新版增值税发票识别
新老版本的接口计费模式相同,且共享计费阶梯和资源包,您可以在【文字识别控制台】>【用量统计】中查看调用情况。
老版本接口我们仍继续维护,但不支持新客户开通调用,建议您使用 新版增值税发票识别,体验更优服务
增值税发票识别接口全面升级,算法更强、性能更优,支持子账号调用。欢迎立即体验 新版增值税发票识别
新老版本的接口计费模式相同,且共享计费阶梯和资源包,您可以在【文字识别控制台】>【用量统计】中查看调用情况。
老版本接口我们仍继续维护,但不支持新客户开通调用,建议您使用 新版增值税发票识别,体验更优服务。

接口描述

接口请求域名:https://recognition.image.myqcloud.com/ocr/invoice 本接口(invoice)用于识别增值税发票,根据用户上传的图像,返回识别出的发票代码、开票日期等字段。
Note:
本接口支持 HTTPS 协议,如果您现在使用的是 HTTP 协议,为了保障您的数据安全,请切换至 HTTPS。

请求头 header

参数名称
描述
host
recognition.image.myqcloud.com
腾讯云智能文字识别服务器域名。
content-length
包体总长度
每次上传的图片大小限制为4MB 以内,不支持 .gif 类型的动图。
authorization
鉴权签名
多次有效签名,用于鉴权,具体生成方式详见 鉴权签名

输入参数

参数名称
必选
类型
描述
appid
String
接入项目的唯一标识,可在 账号信息云 API 密钥 中查看。
image
String
图片文件或图片 base64(图片小于4M)。
url
String
图片文件链接 URL。图片 URL 和 image 同时赋值时,则以 URL 指定的图像作为输入(图片小于4M)。

输出参数

字段
类型
说明
code
Int
返回错误码。
message
String
返回错误消息。
data.angle
Float
图片旋转角度(角度制),范围[-180°,180°],顺时针为正,逆时针为负。
data.items
Array(item)
识别出的所有字段信息。
items 说明:
字段
类型
说明
item
String
识别出的字段名称(关键字)。
itemcoord
Object
字段在图像中的像素坐标,包括左上角坐标 x、y,以及宽 width、高 height。
itemstring
String
识别出的字段名称对应的值,即字段 item 对应的字符串结果。
itemconf
Float
置信度。

示例

输入示例

{
"app_id":"123456",
"image":"SALDKHKAFLASD"
}

输出示例

{
"code": 0,
"message": "OK",
"data": {
"recognize_warn_msg": [],
"recognize_warn_code": [],
"items": [
{
"item": "发票名称",
"itemcoord": {
"x": 715,
"y": 446,
"width": 471,
"height": 45
},
"itemconf": 0.982685148715973,
"itemstring": "上海增值税普通发票"
},
{
"item": "发票代码",
"itemcoord": {
"x": 0,
"y": 0,
"width": 0,
"height": 0
},
"itemconf": 0.9998999834060668,
"itemstring": "143001720660"
}
],
"class": [],
"angle": 0
}
}

错误码

错误码
含义
400
请求不合法,包体格式错误
401
权限验证失败
403
鉴权信息不合法,禁止访问
404
请求失败
411
请求没有指定 ContentLength
413
请求包体太大
424
请求的方法没有找到
500
服务内部错误
502
网关错误,计算后台服务不可用
503
服务不可用
504
后端服务超时或处理失败
-1102
图片解码失败
-1300
图片为空
-1301
参数为空
-1304
参数过长
-1308
URL 图片下载失败
-1320
AppId 无效
-1400
无效的图片格式
-1403
图片下载失败
-1408
图片超出下载限制
-1505
图像请求 URL 的格式错误
-1506
图像下载超时
-1507
无法连接图像下载服务器
-10001
过载保护
-10002
license 无效
-10003
频率限制
-10004
无效的服务名称
-10005
license 中未授权该服务
-5208
内部错误
-9003
OCR 识别失败
-1400
模板不匹配