文字识别 OCR-增值税发票识别-服务端 API 文档-文档中心-腾讯云

注意：

增值税发票识别接口全面升级，算法更强、性能更优，支持子账号调用。欢迎立即体验新版增值税发票识别。

新老版本的接口计费模式相同，且共享计费阶梯和资源包，您可以在【文字识别控制台】>【用量统计】中查看调用情况。

老版本接口我们仍继续维护，但不支持新客户开通调用，建议您使用新版增值税发票识别，体验更优服务。

接口描述

接口请求域名：https://recognition.image.myqcloud.com/ocr/invoice
本接口（invoice）用于识别增值税发票，根据用户上传的图像，返回识别出的发票代码、开票日期等字段。

说明：

本接口支持 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	模板不匹配

产品动态

新手指引

产品简介

购买指南

快速入门

最佳实践

服务端 API 文档

文字识别客户端 SDK 接入文档

云函数接入文档

常见问题

服务协议

联系我们

词汇表

OCR-增值税发票识别

本页目录：

接口描述

请求头 header

输入参数

输出参数

示例

输入示例

输出示例

错误码