文档中心 > 快速入门
快速入门

最近更新时间:2021-03-12

1 进入文本识别控制台


控制台是文字识别的管理页面,您可通过控制台执行查看应用、创建应用、查看服务、购买预付费套餐包等操作。

1.1 通过产品页进入

  • 登录紫光云运营平台,才可成功使用各类服务。

  • 在“产品”栏目下,选择“人工智能”区域,点击“文字识别-卡证类”,进入文字识别-卡证类产品页面。

  • 在文字识别-卡证类产品页,点击“管理控制台”,前往文字识别控制台。

1.2 通过控制台进入

  • 点击右上角“控制台”,登录进入紫光云管理控制台界面。

  • 选择“产品与服务”栏目“人工智能”区域下的“文字识别”,跳转到文字识别控制台。

2 创建应用

本节介绍创建应用,订阅服务的详细操作。

2.1 创建应用

在“应用列表”下,点击“应用创建”按钮,进入创建应用页面,填写应用名称,选填应用描述,点击“立即创建”进入下一步。

2.2 生成Token

点击“立即生成Secret Key”按钮,系统会给应用生成Consumer Key,Consumer Secret,访问服务的Token,Token有效期等信息。点击下一步进入“订阅服务”页面。

2.3 订阅服务

勾选文字识别下需要订阅的服务,则这个应用的Token被授权访问已订阅的服务。点击“立即订阅”按钮,完成创建应用过程。

在应用列表页面可以看到刚刚创建好的应用,在Token列点击“眼睛”按钮,显示Consumer Key,Consumer Secret,Token详情。我们将通过Token认证方式调用服务的API请求。

3 发送请求

本节以身份证识别为例,识别一张正面身份证。通过Token认证方式调用身份证识别的API请求。

3.1 请求说明

3.1.1 请求方式

调用地址:https://apim.unicloud.com/api/ocr/idcard/1.0.0/

请求方式:POST

返回类型:JSON

3.1.2 请求参数

Header如下:

参数
Content-Typeapplication/json
AuthorizationBearer

Body如下:

参数是否必选类型可选值范围说明
idcard_pictruefile--身份证正面或反面图片(支持jpg、jpeg、png格式)

注:Body使用form-data形式

3.1.3 请求示例

curl -k  -H "Authorization:Bearer 2b8296e1-86a5-3a68-bd61-9b88f9dce5c0" \
    -F "idcard_pic=@imgpath.jpg" https://apim.unicloud.com/api/ocr/idcard/1.0.0/

注:发送请求时,Token请填写上面创建应用后得到的Token

3.2 返回说明

3.2.1 返回参数

字段类型说明
sexstring性别
namestring姓名
ID_numstring身份证ID号
birthstring出生年月日
addressstring户口所在的地址
nationstring民族
period_of_validitystring身份证有效期
departmentstring签发机关
codestring是否正常返回(“succeed”,”failed”)

3.2.2 返回示例

身份证正面:

{    
    "Data": {        
        "name": "张三",        
        "ID_num": "511XXXXXXXXXXXXXXX",        
        "nation": "汉",        
        "address": "XX省XX市XX区XX街道XX号",        
        "birth": "1986年8月13日",        
        "sex": "男"
  },    
  "code": "succeed"
}

身份证反面:

{    
    "Data": {        
        "period_of_validity": "2012.06.11-2022.06.11",        
        "department": "北京市公安局海淀分局"
  },    
  "code": "succeed"
}

3.3 通过Postman发送请求示例

  • 请求方式:POST

  • 调用地址:https://apim.unicloud.com/api/ocr/idcard/1.0.0/

  • Body选择form-data格式,并配置idcard_pic,选择一个身份证文件

  • Headers配置Content-Type:application/json 和 Authorization: Bearer Token值