名片识别,通过OCR(光学字符识别 Optical Character Recognition)技术,对纸质名片进行识别,返回名片上的姓名、手机、电话、公司、部门、职位、传真、邮箱、网站、地址等关键信息,可以省去用户手动录入的过程,自动完成名片信息的结构化和数据的采集,可以很方便对接客户的后台数据系统,给用户带来极大的便利。该名片识别接口支持中文(简体和繁体)名片、英文、以及 16种小语种 名片,接口可以 自动识别名片语种,详见名片语种。
该能力是通过HTTP API的方式给开发者提供一个通用的接口,适用于一次性交互数据传输的AI服务场景,块式传输。相较于SDK,API具有轻量、跨语言的特点,不过请注意该接口使用的HTTP API协议不支持跨域。
示例demo请点击 这里 下载。
目前仅提供部分开发语言的demo,其他语言请参照下方接口文档进行开发。
也欢迎热心的开发者到 讯飞开放平台社区 分享你们的demo。
集成名片识别API时,需按照以下要求。
内容 | 说明 |
---|---|
请求协议 | http[s] (为提高安全性,强烈推荐https) |
请求地址 | http[s]: //webapi.xfyun.cn/v1/service/v1/ocr/business_card 注:服务器IP不固定,为保证您的接口稳定,请勿通过指定IP的方式调用接口,使用域名方式调用 |
请求方式 | POST |
接口鉴权 | 签名机制,见授权认证 |
字符编码 | UTF-8 |
响应格式 | 统一采用JSON格式 |
开发语言 | 任意,只要可以向讯飞云服务发起HTTP请求的均可 |
图片格式 | jpg/jpeg |
图片属性 | 推荐设置为:尺寸1024×768,图像质量75以上,位深度24。 建议最短边最小不低于700像素,最大不超过4000像素 |
图片大小 | 图像数据按要求编码后(base64编码后进行urlencode)大小不超过4M |
名片语种 | 中文简体、中文繁体、英文、以及16种小语种,详见名片语种 |
注: 若需配置IP白名单,请前往控制台。IP白名单规则请参照 IP白名单。
接口地址示例:
POST http[s]://webapi.xfyun.cn/v1/service/v1/ocr/business_card HTTP/1.1
Content-Type:application/x-www-form-urlencoded; charset=utf-8
在调用该业务接口时
IP白名单规则
{
"code":"10105",
"desc":"illegal access|illegal client_ip",
"data":"",
"sid":"xxxxxx"
}
在 Http Request Header 中配置以下参数。
以下参数用于授权认证:
参数 | 格式 | 说明 | 必须 |
---|---|---|---|
X-Appid | string | 讯飞开放平台注册申请应用的应用ID(appid) | 是 |
X-CurTime | string | 当前UTC时间戳 从1970年1月1日0点0 分0 秒开始到现在的秒数 | 是 |
X-Param | string | 相关参数JSON串经Base64编码后的字符串,详见业务参数 | 是 |
X-CheckSum | string | 令牌,计算方法:MD5(APIKey + X-CurTime + X-Param),三个值拼接的字符串,进行MD5哈希计算(32位小写) | 是 |
注:
*X-CheckSum *生成示例:
String APIKey="abcd1234";
String X-CurTime="1502607694";
String X-Param="eyAiYXVmIjogImF1ZGlvL0wxNjtyYXR...";
String X-CheckSum=MD5(apiKey + X-CurTime + X-Param);
X-Param 为各配置参数组成的 JSON 串经 BASE64 编码之后的字符串,原始 JSON 串各字段说明如下:
参数 | 类型 | 必须 | 说明 | 示例 |
---|---|---|---|---|
engine_type | string | 是 | 引擎类型,固定为business_card | business_card |
pic_required | string | 否 | 是否返回切边增强图像。 当为“1”时返回,当省略或为其他值时不返回。返回的json结果中切边增强图片数据格式详见返回值说明。 | 1 |
imei | string | 否 | 手机序列号 | 12345678 |
osid | string | 否 | 操作系统版本 | Android |
ua | string | 否 | 厂商|全称|机型信息|操作系统版本|分辨率 | vivo|vivoY67L|PD1612|ANDROID6.0|720*1280 |
X-Param生成示例:
原始JSON串:
{
"engine_type": "business_card"
}
BASE64编码(即X-Param):
eyJlbmdpbmVfdHlwZSI6ICJidXNpbmVzc19jYXJkIn0=
以POST表单的形式提交以下参数:
参数 | 类型 | 必须 | 说明 | 示例 |
---|---|---|---|---|
image | string | 是 | 图像数据 base64编码后进行urlencode 要求base64编码和urlencode后大小不超过4M 仅支持jpg格式,推荐 jpg 文件设置为:尺寸 1024×768,图像质量 75 以上,位深度 24。 | exSI6ICJ... |
注:
1)一般基础类库会默认进行urlencode处理,请注意不要重复处理
2)base64编码后大小会增加约1/3
返回值为json串,各字段如下:
参数 | 类型 | 说明 |
---|---|---|
code | string | 结果码(具体见SDK&API错误码查询) |
data | json | 详见data说明 |
desc | string | 描述 |
sid | string | 会话ID |
biz_card_pic | string | 名片切边增强图像,jpg/jpeg格式,二进制数据Base64编码(使用前注意解码) |
其中sid字段主要用于追查问题,如果出现问题,可以提供sid给讯飞技术人员帮助确认问题。
data各字段说明如下:
参数 | 说明 |
---|---|
formatted_name | 显示完整姓名 |
name | 一个结构化的表示形式,表示人的姓氏,名字或其他信息 |
address | 一个结构化的标示形式,表示物理地址 |
label | 个人或对象的物理邮件投递或交付地址 |
telephone | 电话号码,电话通信的规范数字字符串 |
电子邮件通讯地址 | |
title | 代表个人在公司或组织内的职位,职能或其他相关属性 |
role | 包含了个人在组织内的职业,业务或部门类别的信息 |
organization | 单位或组织的可选名称 |
comment | 在 JSON 格式中包含的其他注释或补充信息 |
url | 包含一个URL的值 |
sns | 社交帐户,例如微信 |
im | 及时聊天帐户,例如 QQ |
每一个参数的赋值都是一个 JSON 的数组,数组包含了与这个键值相关的对象或字符串的值。对象含有两个键值:item 和 position。Item 的值是一个 JSON 对象或字符串。Position的值是一个字符串,表示这个属性在名片上的矩形位置。
示例如下:
失败:
{
"code": "10106",
"desc": "invalid parameter|invalid X-Appid",
"data": "",
"sid": "wcr0000bb3f@ch3d5c059d83b3477200"
}
成功
{
"biz_card_pic":"...the Base64 encoded pic data, too long to show....",
"code": "0",
"data": {
"address": [{
"item": {
"country": "中国",
"locality": "合肥",
"street": "望江西路666号",
"type": ["work"]
},
"position": "923,884,2373,884,2373,978,923,978"
}],
"email": [{
"item": "lisi@iflytek.com",
"position": "925,754,1809,754,1809,845,925,845"
}],
"formatted_name": [{
"item": "李四",
"position": "1687,1527,2074,1527,2074,1651,1687,1651"
}],
"label": [{
"item": {
"address": "安徽省合肥市高新区望江西路666号讯飞大厦",
"type": ["work"]
},
"position": "923,884,2373,884,2373,978,923,978"
}],
"name": [{
"item": {
"family_name": "李",
"given_name": "四"
},
"position": "0,0,0,0,0,0,0,0"
}],
"organization": [{
"item": {
"name": "科大讯飞股份有限公司"
},
"position": "686,1004,1809,1004,1809,1092,686,1092"
}],
"rotation_angle": "0",
"telephone": [{
"item": {
"number": "18888888888",
"type": ["cellular", "voice"]
},
"position": "3146,773,3757,773,3757,858,3146,858"
}, {
"item": {
"number": "02155663009p8021",
"type": ["work", "voice"]
},
"position": "2917,895,3746,895,3746,981,2917,981"
}, {
"item": {
"number": "4006083063",
"type": ["work", "voice"]
},
"position": "3114,648,3762,648,3762,736,3114,736"
}],
"title": [{
"item": "技术支持经理",
"position": "2129,1527,2607,1527,2607,1651,2129,1651"
}],
"url": [{
"item": "www.iflytek.com",
"position": "917,637,1586,637,1586,721,917,721"
}]
},
"desc": "success",
"sid": "wcr00000004@dx11730e797d37000100"
}
序号 | 语种 | 序号 | 语种 |
---|---|---|---|
1 | 中文(简体) | 11 | 荷兰语 |
2 | 中文(繁体) | 12 | 俄语 |
3 | 英语 | 13 | 希腊语 |
4 | 日语 | 14 | 土耳其语 |
5 | 韩语 | 15 | 瑞典语 |
6 | 法语 | 16 | 芬兰语 |
7 | 西班牙语 | 17 | 丹麦语 |
8 | 葡萄牙语 | 18 | 挪威语 |
9 | 德语 | 19 | 匈牙利语 |
10 | 意大利语 |
答:基于行业领先的光学字符识别技术,将图片上的文字内容直接转化为可编辑文本。实现高精准,毫秒级识别体验。
答:支持17种语言识别:英语、中文(简体)、中文(繁体)、日语、韩语、法语、西班牙语、葡萄牙语、德语、意大利语、荷兰语、希腊语、土耳其语、瑞典语、芬兰语、丹麦语、挪威语、匈牙利语
答:webapi接口出于安全性考虑,每个请求中的 checkSum 有效期为 5 分钟(用 curTime 计算),同时 curTime 要与标准时间同步,否则时间相差太大,服务端会直接认为 curTime 无效,从而报错10114。
答:这个一般是由于图片不符合要求,比如名片所在图片中的位置偏移很大或者分辨率很低、图片过大超过大小限制,导致无法有效识别。
答:webapi支持多并发。
答:每个账号免费领取一次3000服务量有效期90天,套餐一:1w次服务量/840元/年,套餐二:10w次服务量/8000元/年,套餐三:100w次服务量/50000元/年,可在控制台对应服务--->实时用量--->购买服务量,套餐详细说明页。