{ "openapi": "3.0.3", "info": { "title": "达摩院-文字识别", "description": "基于阿里云深度学习技术，为用户提供通用的印刷文字识别和文档结构化等能力。文字识别技术可以灵活应用于个人证件识别、行业票证识别、资产类证件识别、通用文档识别与整理等行业场景，满足认证、鉴权、票据流转审核等业务需求。", "termsOfService": "https://www.showapi.com/helpcenter/view#/4019/2", "version": "1.0.0" }, "servers": [ { "url": "https://route.showapi.com" } ], "paths": { "/2582-24": { "x-pointCode": 24, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "火车票识别", "description": "可以对火车票进行结构化识别，输出乘车时间、始发站、目的站、座位席别、乘车人姓名、车次号、票价、车厢及座次号，共8个关键字段信息。阿里原接口订购地址：https://vision.aliyun.com/ocr\n\n输入限制\n图片格式：JPEG、JPG、PNG、BMP、GIF。\n图像大小：图像大小不超过3M。\n图像分辨率：不限制图片分辨率，但图片分辨率太高可能会导致API识别超时，超时时间为5秒。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "Name": { "type": "string", "description": "乘车人姓名。" }, "Date": { "type": "string", "description": "乘车日期时间。" }, "Seat": { "type": "string", "description": "座位车厢及座次号。" }, "Number": { "type": "string", "description": "车次号。" }, "Price": { "type": "number", "description": "票价。" }, "DepartureStation": { "type": "string", "description": "始发站点。" }, "Level": { "type": "string", "description": "座位席别。" }, "Destination": { "type": "string", "description": "目的站点。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2582_24_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "图片URL地址。" }, "ds_id": { "type": "string" } }, "required": [ "ImageURL", "ds_id" ] } } } } } }, "/2582-22": { "x-pointCode": 22, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "增值税发票识别", "description": "可以识别增值税发票（电子发票和纸质发票）关键字段内容，包括：校验码、复核人、开票人、发票代码、收款人等。阿里原接口订购地址：https://vision.aliyun.com/ocr\n\n输入限制\n图片格式：PDF、JPG。\n图片大小：大小不超过10M。\n图片分辨率：不限制图片分辨率，但图片分辨率太高可能会导致API识别超时，超时时间为5秒。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "Box": { "type": "object", "properties": { "PayeeNames": { "type": "array", "items": { "type": "number" }, "description": "销售方名称位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。" }, "PayeeAddresses": { "type": "array", "items": { "type": "number" }, "description": "销售方地址及电话位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。" }, "InvoiceNoes": { "type": "array", "items": { "type": "number" }, "description": "发票号码位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。" }, "Clerks": { "type": "array", "items": { "type": "number" }, "description": "开票人位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。" }, "PayeeBankNames": { "type": "array", "items": { "type": "number" }, "description": "销售方开户行及账号位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。" }, "PayerRegisterNoes": { "type": "array", "items": { "type": "number" }, "description": "购买方纳税人识别号位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。" }, "InvoiceFakeCodes": { "type": "array", "items": { "type": "number" }, "description": "校验码位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。" }, "InvoiceCodes": { "type": "array", "items": { "type": "number" }, "description": "发票代码位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。" }, "PayerNames": { "type": "array", "items": { "type": "number" }, "description": "购买方名称位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。" }, "PayerAddresses": { "type": "array", "items": { "type": "number" }, "description": "购买方地址及电话位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。" }, "PayerBankNames": { "type": "array", "items": { "type": "number" }, "description": "购买方开户行及账号位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。" }, "Payees": { "type": "array", "items": { "type": "number" }, "description": "收款人位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。" }, "SumAmounts": { "type": "array", "items": { "type": "number" }, "description": "价税合计位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。" }, "TaxAmounts": { "type": "array", "items": { "type": "number" }, "description": "合计税额位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。" }, "InvoiceAmounts": { "type": "array", "items": { "type": "number" }, "description": "价税合计位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。" }, "InvoiceDates": { "type": "array", "items": { "type": "number" }, "description": "开票日期位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。" }, "WithoutTaxAmounts": { "type": "array", "items": { "type": "number" }, "description": "合计金额位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。" }, "PayeeRegisterNoes": { "type": "array", "items": { "type": "number" }, "description": "销售方纳税人识别号位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。" }, "Checkers": { "type": "array", "items": { "type": "number" }, "description": "复核人位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。" } } }, "Content": { "type": "object", "properties": { "PayeeBankName": { "type": "string", "description": "销售方开户行及账号。" }, "Payee": { "type": "string", "description": "收款人。" }, "Checker": { "type": "string", "description": "复核人。" }, "InvoiceDate": { "type": "string", "description": "开票日期。" }, "PayerBankName": { "type": "string", "description": "购买方开户行及账号。" }, "Clerk": { "type": "string", "description": "开票人。" }, "WithoutTaxAmount": { "type": "string", "description": "合计金额。" }, "PayeeRegisterNo": { "type": "string", "description": "销售方纳税人识别号。" }, "SumAmount": { "type": "string", "description": "价税合计（大写）。" }, "TaxAmount": { "type": "string", "description": "合计税额。" }, "AntiFakeCode": { "type": "string", "description": "校验码。" }, "PayerName": { "type": "string", "description": "购买方名称。" }, "InvoiceCode": { "type": "string", "description": "发票代码。" }, "InvoiceAmount": { "type": "string", "description": "价税合计（小写）。" }, "PayerAddress": { "type": "string", "description": "购买方地址、电话。" }, "InvoiceNo": { "type": "string", "description": "发票号码。" }, "PayerRegisterNo": { "type": "string", "description": "购买方开户行及账号。" }, "PayeeName": { "type": "string", "description": "销售方名称。" }, "PayeeAddress": { "type": "string", "description": "销售方地址、电话。" } } } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2582_22_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "FileURL": { "type": "string", "description": "图片URL地址。" }, "ds_id": { "type": "string" }, "FileType": { "type": "string", "description": "输入的图片格式。" } }, "required": [ "FileURL", "ds_id", "FileType" ] } } } } } }, "/2582-21": { "x-pointCode": 21, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "出租车发票识别", "description": "可以准确识别出全国各大城市出租车发票在图像中的位置，支持出租车发票结构化识别，输出发票号码、代码、车号、日期、时间、金额，共6个关键字段信息。阿里原接口订购地址：https://vision.aliyun.com/ocr\n\n输入限制\n请求格式：JPEG、JPG、PNG、BMP、GIF。\n图像大小：图像大小不超过3M。\n图像分辨率：不限制图片分辨率，但图片分辨率太高可能会导致API识别超时，超时时间为5秒。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "Invoices": { "type": "array", "items": { "type": "object", "properties": { "Items": { "type": "array", "items": { "type": "object", "properties": { "Text": { "type": "string", "description": "发票每个字段信息。" }, "ItemRoi": { "type": "object", "properties": { "Angle": { "type": "number", "description": "角度信息。坐标的原点在左上角，与x轴平行的方向角度为0。逆时针旋转角度为负，顺时针旋转角度为正。角度是水平轴（x轴）顺时针旋转，与碰到的第一个边的夹角度数。角度范围-180°~180°。" }, "Center": { "type": "object", "properties": { "Y": { "type": "number", "description": "位置框中心点y坐标。" }, "X": { "type": "number", "description": "位置框中心点x坐标。" } } }, "Size": { "type": "object", "properties": { "W": { "type": "number", "description": "位置框宽度。" }, "H": { "type": "number", "description": "位置框高度。" } } } } } } } }, "InvoiceRoi": { "type": "object", "properties": { "W": { "type": "number", "description": "发票宽度。" }, "H": { "type": "number", "description": "发票高度。" }, "Y": { "type": "number", "description": "发票左上角y坐标。" }, "X": { "type": "number", "description": "发票左上角x坐标。" } } }, "RotateType": { "type": "number", "description": "发票旋转角度。\n\n0：不需要旋转。\n1：顺时针旋转90。\n2：顺时针旋转180。\n3：顺时针旋转270。" } } } } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2582_21_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "图片URL地址。" }, "ds_id": { "type": "string" } }, "required": [ "ImageURL", "ds_id" ] } } } } } }, "/2582-20": { "x-pointCode": 20, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "车牌识别", "description": "可以识别行驶证首页和副页关键字段内容，输出品牌型号、车辆类型、车牌号码、检验记录、核定载质量、核定载人数等21个关键字段信息。阿里原接口订购地址：https://vision.aliyun.com/ocr\n\n\n输入限制\n图片格式：JPEG、JPG、PNG、BMP、GIF。\n图像大小：图像大小不超过3M。\n图像分辨率：不限制图片分辨率，但图片分辨率太高可能会导致API识别超时，超时时间为5秒。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "Plates": { "type": "array", "items": { "type": "object", "properties": { "Roi": { "type": "object", "properties": { "W": { "type": "number", "description": "车牌号宽度。" }, "H": { "type": "number", "description": "车牌号高度。" }, "Y": { "type": "number", "description": "车牌号左上角y坐标。" }, "X": { "type": "number", "description": "车牌号左上角x坐标。" } } }, "PlateType": { "type": "string", "description": "车牌类型。包括：小型汽车、新能源车、大型汽车、挂车、教练车、警车、军车、使领馆车、港澳车。" }, "Confidence": { "type": "number", "description": "车牌号码的置信度，取值范围0~1。" }, "PlateNumber": { "type": "string", "description": "车牌号码。" }, "PlateTypeConfidence": { "type": "number", "description": "车牌类型的置信度，取值范围0~1。" } } } } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2582_20_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "图片URL地址。" }, "ds_id": { "type": "string" } }, "required": [ "ImageURL", "ds_id" ] } } } } } }, "/2582-19": { "x-pointCode": 19, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "驾驶证识别", "description": "可以识别行驶证首页和副页关键字段内容，输出品牌型号、车辆类型、车牌号码、检验记录、核定载质量、核定载人数等21个关键字段信息。阿里原接口订购地址：https://vision.aliyun.com/ocr\n\n\n输入限制\n图片格式：JPEG、JPG、PNG、BMP、GIF。\n图像大小：图像大小不超过3M。\n图像分辨率：不限制图片分辨率，但图片分辨率太高可能会导致API识别超时，超时时间为5秒。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "FaceResult": { "type": "object", "properties": { "Name": { "type": "string", "description": "姓名字符串，识别失败时返回NoResult或InvalidInput。" }, "LicenseNumber": { "type": "string", "description": "驾驶证号，识别失败时返回NoResult或InvalidInput。" }, "IssueDate": { "type": "string", "description": "初次发证日期。格式：YYYYMMDD，例如19800101，即1980年01月01日。" }, "EndDate": { "type": "string", "description": "驾驶证有效期时长或有效期截止日期。具体视驾驶证数据格式而定，格式：YYYYMMDD，例如19800101，即1980年01月01日。" }, "StartDate": { "type": "string", "description": "驾驶证有效期开始时间，格式：YYYYMMDD，例如19800101，即1980年01月01日。" }, "Address": { "type": "string", "description": "地址。" }, "Gender": { "type": "string", "description": "性别。" }, "VehicleType": { "type": "string", "description": "驾驶证准驾车型。" } } }, "BackResult": { "type": "array", "items": { "type": "object", "properties": { "ArchiveNumber": { "type": "string", "description": "档案编号。" } } } } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2582_19_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "图片URL地址。" }, "Side": { "type": "string", "description": "上传照片为行驶证首页或副页。\n\nface：首页\nback：副页" }, "ds_id": { "type": "string" } }, "required": [ "ImageURL", "Side", "ds_id" ] } } } } } }, "/2582-18": { "x-pointCode": 18, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "VIN码识别", "description": "可以识别车辆VIN码，输出车辆VIN码数值。阿里原接口订购地址：https://vision.aliyun.com/ocr\n\n\n输入限制\n图片格式：JPEG、JPG、PNG、BMP、GIF。\n图像大小：图像大小不超过3M。\n图像分辨率：不限制图片分辨率，但图片分辨率太高可能会导致API识别超时，超时时间为5秒。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "VinCode": { "type": "string", "description": "识别的车辆VIN码。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2582_18_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "图片URL地址。" }, "ds_id": { "type": "string" } }, "required": [ "ImageURL", "ds_id" ] } } } } } }, "/2582-17": { "x-pointCode": 17, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "行驶证识别", "description": "可以识别行驶证首页和副页关键字段内容，输出品牌型号、车辆类型、车牌号码、检验记录、核定载质量、核定载人数等21个关键字段信息。阿里原接口订购地址：https://vision.aliyun.com/ocr\n\n输入限制\n图片格式：JPEG、JPG、PNG、BMP、GIF。\n图像大小：图像大小不超过3M。\n图像分辨率：不限制图片分辨率，但图片分辨率太高可能会导致API识别超时，超时时间为5秒。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "FaceResult": { "type": "object", "properties": { "IssueDate": { "type": "string", "description": "发证日期，格式：YYYYMMDD，例如19800101，即1980年01月01日。" }, "UseCharacter": { "type": "string", "description": "使用性质。" }, "Owner": { "type": "string", "description": "所有人名称。" }, "EngineNumber": { "type": "string", "description": "发动机号码。" }, "Model": { "type": "string", "description": "品牌型号。" }, "PlateNumber": { "type": "string", "description": "车牌号码。" }, "Address": { "type": "string", "description": "地址。" }, "RegisterDate": { "type": "string", "description": "注册日期，格式：YYYYMMDD，例如19800101，即1980年01月01日。" }, "VehicleType": { "type": "string", "description": "车辆类型。" }, "Vin": { "type": "string", "description": "车辆识别代号。" } } }, "BackResult": { "type": "object", "properties": { "ApprovedLoad": { "type": "string", "description": "核定载质量。" }, "ApprovedPassengerCapacity": { "type": "string", "description": "核定载人数。" }, "EnergyType": { "type": "string", "description": "能源标志。" }, "FileNumber": { "type": "string", "description": "档案编号。" }, "GrossMass": { "type": "string", "description": "总质量。" }, "InspectionRecord": { "type": "string", "description": "检验记录。" }, "OverallDimension": { "type": "string", "description": "外廓尺寸。" }, "PlateNumber": { "type": "string", "description": "号牌号码。" }, "TractionMass": { "type": "string", "description": "准牵引总质量。" }, "UnladenMass": { "type": "string", "description": "整备质量。" } } } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2582_17_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "图片URL地址。" }, "Side": { "type": "string", "description": "上传照片为行驶证首页或副页。\n\nface：首页\nback：副页" }, "ds_id": { "type": "string" } }, "required": [ "ImageURL", "Side", "ds_id" ] } } } } } }, "/2582-16": { "x-pointCode": 16, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "查询异步任务结果", "description": "异步接口调用API接口后，返回的并不是真正的请求结果，您需要保存返回结果中的RequestId，然后调用本接口来获取真正的请求结果。阿里原接口订购地址：https://vision.aliyun.com/ocr", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "Result": { "type": "string", "description": "异步任务返回的真实请求结果。" }, "Status": { "type": "string", "description": "异步任务状态。包括：\n\nQUEUING：任务排队中\nPROCESSING：异步处理中\nPROCESS_SUCCESS：处理成功\nPROCESS_FAILED：处理失败\nTIMEOUT_FAILED：任务超时未处理完成\nLIMIT_RETRY_FAILED：超过最大重试次数" }, "JobId": { "type": "string", "description": "异步任务Id。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2582_16_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "JobId": { "type": "string", "description": "异步接口返回的RequestId，输入后可以查询异步接口的真实请求结果。" }, "ds_id": { "type": "string" } }, "required": [ "JobId", "ds_id" ] } } } } } }, "/2582-11": { "x-pointCode": 11, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "通用识别", "description": "可以识别图像中文字内容和文字区域坐标，适用于多场景图像文字识别。阿里原接口订购地址：https://vision.aliyun.com/experience/detail?tagName=ocr&children=RecognizeCharacter\n输入限制\n请求格式：JPEG、JPG、PNG、BMP、GIF。\n图像大小：图像大小不超过3M。\n图像分辨率：不限制图片分辨率，但图片分辨率太高可能会导致API识别超时，超时时间为5秒。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "Results": { "type": "array", "items": { "type": "object", "properties": { "Probability": { "type": "number", "description": "文字内容的概率，取值范围为0~1。" }, "Text": { "type": "string", "description": "文字内容。" }, "TextRectangles": { "type": "object", "properties": { "Angle": { "type": "number", "description": "文字区域角度，角度范围[-180, 180]。" }, "Top": { "type": "number", "description": "文字区域左上角y坐标。" }, "Height": { "type": "number", "description": "文字区域高度。" }, "Width": { "type": "number", "description": "文字区域宽度。" }, "Left": { "type": "number", "description": "文字区域左上角x坐标。" } } } } } } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2582_11_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "图片URL地址。" }, "MinHeight": { "type": "string", "description": "图片中文字的最小高度，单位像素。" }, "OutputProbability": { "type": "string", "description": "是否输出文字框的概率。取值true或者false。" }, "ds_id": { "type": "string" } }, "required": [ "ImageURL", "MinHeight", "OutputProbability", "ds_id" ] } } } } } }, "/2582-10": { "x-pointCode": 10, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "表格识别", "description": "可以自动识别表格位置、表格内容信息。适用于黑色的，横线、竖线都齐全的表格中内容识别。阿里原接口订购地址：https://vision.aliyun.com/experience/detail?tagName=ocr&children=RecognizeTable\n\n输入限制\n请求格式：JPEG、JPG、PNG、BMP、GIF。\n图像大小：图像大小不超过3M。\n图像分辨率：不限制图片分辨率，但图片分辨率太高可能会导致API识别超时，超时时间为5秒。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "Tables": { "type": "array", "items": { "type": "object", "properties": { "TableRows": { "type": "array", "items": { "type": "object", "properties": { "TableColumns": { "type": "array", "items": { "type": "object", "properties": { "Texts": { "type": "array", "items": { "type": "string" }, "description": "文本，每行（row）文字为一个block。" }, "EndRow": { "type": "number", "description": "单元格所占的行数（rowspan）为ey-sy。" }, "StartRow": { "type": "number", "description": "单元格的起始行ID。" }, "Height": { "type": "number", "description": "图片上单元格的高度。" }, "Width": { "type": "number", "description": "图片上单元格的宽度。" }, "StartColumn": { "type": "number", "description": "单元格的起始列ID。" }, "EndColumn": { "type": "number", "description": "单元格所占的列数（colspan）为ex-sx。" } } } } } } }, "Head": { "type": "string", "description": "表头信息。" }, "Tail": { "type": "string", "description": "表尾信息。" } } } }, "FileContent": { "type": "string", "description": "HTML字符串。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2582_10_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "图片URL地址。" }, "AssureDirection": { "type": "string", "description": "图片方向是否确定为正向。\n\ntrue：确定\nfalse：不确定" }, "HasLine": { "type": "string", "description": "是否无线条。\n\ntrue：无线条或者只有横线没有竖线。\nfalse：有线条。" }, "ds_id": { "type": "string" }, "OutputFormat": { "type": "string", "description": "输出格式。包括：html、json、xlsx。" }, "SkipDetection": { "type": "string", "description": "是否跳过检测，取值true或false。" }, "UseFinanceModel": { "type": "string", "description": "是否使用财务报表模型。取值true或false。" } }, "required": [ "ImageURL", "AssureDirection", "HasLine", "ds_id", "OutputFormat", "SkipDetection", "UseFinanceModel" ] } } } } } }, "/2582-7": { "x-pointCode": 7, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "二维码识别", "description": "可以识别图像中是否含有二维码信息，输出图像中二维码包含的文本信息（每个二维码对应的URL或文本），可支持图像中含有多个二维码识别。阿里原接口订购地址：https://vision.aliyun.com/ocr?spm=a211p3.14020179.J_7524944390.2.66cd4850CPBaJQ\n\n输入限制\n图片格式：PNG、JPG、JPEG、BMP、GIF、WEBP。\n图片大小：大小不超过10MB。如您有大图需求，请提工单申请。\n图片分辨率：建议不低于256×256像素，分辨率过低可能会影响识别效果。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "Elements": { "type": "array", "items": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "对应请求中的图像URL地址。" }, "TaskId": { "type": "string", "description": "该检测任务的ID。" }, "Results": { "type": "array", "items": { "type": "object", "properties": { "Suggestion": { "type": "string", "description": "建议您执行的操作，取值包括：\n\npass：图片正常，无需进行其余操作。\nreview：检测结果不确定，需要进行人工审核。\nblock：图片违规，建议执行进一步操作（如直接删除或做限制处理）。" }, "Label": { "type": "string", "description": "检测结果的分类，取值包括：\n\nnormal：正常图片。\nqrcode：含二维码的图片。\nprogramCode：含小程序码的图片。\n说明默认不识别小程序码。如果需要识别，请提工单申请。" }, "Rate": { "type": "number", "description": "结果为该分类的概率，取值范围为[0.00-100.00]。值越高，表示属于该分类的概率越大。" } } } } } } } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2582_7_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "待检测图像的URL地址。" }, "ds_id": { "type": "string" } }, "required": [ "ImageURL", "ds_id" ] } } } } } }, "/2582-5": { "x-pointCode": 5, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "银行卡识别", "description": "可以检测输入的主流银行卡图像，输出3个信息，包括：发卡行、银行卡号、有效日期。阿里原接口订购地址：https://vision.aliyun.com/ocr?spm=a211p3.14020179.J_7524944390.2.66cd4850CPBaJQ\n\n输入限制\n图片格式：JPEG、JPG、PNG、BMP、GIF。\n图像大小：图像大小不超过3M。\n图像分辨率：不限制图片分辨率，但图片分辨率太高可能会导致API识别超时，超时时间为5秒。\nURL地址中不能包含中文字符。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "CardNumber": { "type": "string", "description": "银行卡号。" }, "ValidDate": { "type": "string", "description": "有效日期，识别失败则返回空字符串。如有多个，则用逗号分隔，例如03/17,04/05。" }, "BankName": { "type": "string", "description": "银行名称，识别失败则返回空字符串。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2582_5_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "图片URL地址。" }, "ds_id": { "type": "string" } }, "required": [ "ImageURL", "ds_id" ] } } } } } }, "/2582-3": { "x-pointCode": 3, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "身份证识别", "description": "可以识别二代身份证关键字段内容，关键字段包括：姓名、性别、民族、身份证号、出生日期、地址信息、有效起始时间、签发机关，同时可输出身份证区域位置和人脸位置信息。阿里原接口订购地址：https://vision.aliyun.com/experience/detail?tagName=ocr&children=RecognizeIdentityCard\n\n输入限制：\n图片格式：JPEG、JPG、PNG、BMP、GIF。\n图像大小：图像大小不超过3M。\n图像分辨率：不限制图片分辨率，但图片分辨率太高可能会导致API识别超时，超时时间为5秒。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "FrontResult": { "type": "object", "properties": { "CardAreas": { "type": "array", "items": { "type": "object", "properties": { "Y": { "type": "number", "description": "身份证区域纵坐标。" }, "X": { "type": "number", "description": "身份证区域横坐标。" } } } }, "Name": { "type": "string", "description": "姓名。" }, "IDNumber": { "type": "string", "description": "身份证号。" }, "Address": { "type": "string", "description": "地址信息。" }, "Gender": { "type": "string", "description": "性别。" }, "BirthDate": { "type": "string", "description": "出生日期，格式：YYYYMMDD，例如19800101，即1980年01月01日。" }, "FaceRectangle": { "type": "object", "properties": { "Angle": { "type": "number", "description": "表示矩形顺时针旋转的度数，范围-180~180。" }, "Center": { "type": "object", "properties": { "Y": { "type": "number", "description": "人脸矩形中心纵坐标。" }, "X": { "type": "number", "description": "人脸矩形中心横坐标。" } } }, "Size": { "type": "object", "properties": { "Height": { "type": "number", "description": "高度。" }, "Width": { "type": "number", "description": "宽度。" } } } } }, "FaceRectVertices": { "type": "array", "items": { "type": "object", "properties": { "Y": { "type": "number", "description": "人脸位置纵坐标。" }, "X": { "type": "number", "description": "人脸位置横坐标。" } } } }, "Nationality": { "type": "string", "description": "民族。" } } } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2582_3_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "图片URL地址。" }, "Side": { "type": "string", "description": "身份证正反面类型。\n\nface：正面。\nback：反面。" }, "ds_id": { "type": "string" } }, "required": [ "ImageURL", "Side", "ds_id" ] } } } } } }, "/2582-2": { "x-pointCode": 2, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "营业执照识别", "description": "可以识别营业执照关键字段内容，包括：公司地址、营业范围、注册资本、注册日期、公司法人、公司名称、注册号、公司类型、公司营业期限日期。同时可以输出营业执照上二维码、印章位置。阿里原接口订购地址：https://vision.aliyun.com/experience/detail?tagName=ocr&children=RecognizeBusinessLicense\n\n输入限制\n请求格式：JPEG、JPG、PNG、BMP、GIF。\n图像大小：图像大小不超过3M。\n图像分辨率：不限制图片分辨率，但图片分辨率太高可能会导致API识别超时，超时时间为5秒。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "LegalPerson": { "type": "string", "description": "公司法人。识别失败时时返回FailInRecognition。" }, "Business": { "type": "string", "description": "经营范围，识别失败时返回FailInRecognition。" }, "QRCode": { "type": "object", "properties": { "Top": { "type": "number", "description": "区域左上角y坐标。" }, "Height": { "type": "number", "description": "区域高度。" }, "Width": { "type": "number", "description": "区域宽度。" }, "Left": { "type": "number", "description": "区域左上角x坐标。" } } }, "EstablishDate": { "type": "string", "description": "公司注册日期。例如证件上为“2014年04月16日”，则接口返回“20140416”。" }, "Type": { "type": "string", "description": "公司类型。识别失败时返回FailInRecognition。" }, "Capital": { "type": "string", "description": "注册资本，识别失败时返回FailInRecognition。" }, "Title": { "type": "object", "properties": { "Top": { "type": "number", "description": "区域左上角y坐标。" }, "Height": { "type": "number", "description": "区域高度。" }, "Width": { "type": "number", "description": "区域宽度。" }, "Left": { "type": "number", "description": "区域左上角x坐标。" } } }, "Name": { "type": "string", "description": "公司名称。识别失败时返回FailInRecognition。" }, "Angle": { "type": "number", "description": "输入图片的角度（顺时针旋转）。枚举值包括：0、90、180、270。" }, "Stamp": { "type": "object", "properties": { "Top": { "type": "number", "description": "区域左上角y坐标。" }, "Height": { "type": "number", "description": "区域高度。" }, "Width": { "type": "number", "description": "区域宽度。" }, "Left": { "type": "number", "description": "区域左上角x坐标。" } } }, "ValidPeriod": { "type": "string", "description": "公司营业期限终止日期。例如证件上为“2014年04月16日至2034年04月15日”，则接口返回“20340415”。\n\n说明当前算法将日期格式统一输出为“年月日”（例如“20391130”），并用“29991231”表示“长期”，若证件上没有营业期限，则默认其为“长期”返回“29991231”。" }, "Address": { "type": "string", "description": "公司地址。识别失败时返回FailInRecognition。" }, "RegisterNumber": { "type": "string", "description": "注册号。识别失败时返回FailInRecognition。" }, "Emblem": { "type": "object", "properties": { "Top": { "type": "number", "description": "区域左上角y坐标。" }, "Height": { "type": "number", "description": "区域高度。" }, "Width": { "type": "number", "description": "区域宽度。" }, "Left": { "type": "number", "description": "区域左上角x坐标。" } } } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2582_2_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "图片URL地址" }, "ds_id": { "type": "string" } }, "required": [ "ImageURL", "ds_id" ] } } } } } } }, "components": { "securitySchemes": { "AppKeyAuth": { "type": "apiKey", "in": "query", "name": "appKey", "description": "从 ShowAPI 控制台获取的 appKey，管理地址：https://www.showapi.com/console#/myApp" } }, "schemas": { "ShowapiResEnvelope": { "type": "object", "description": "ShowAPI 统一返回包裹（业务数据位于 showapi_res_body）", "properties": { "showapi_res_code": { "type": "integer", "description": "API 返回的状态码" }, "showapi_res_error": { "type": "string", "description": "API 返回的错误信息" }, "showapi_res_id": { "type": "string", "description": "API 请求的唯一标识" }, "showapi_fee_num": { "type": "integer", "description": "API 调用计费次数" } } } } }, "security": [ { "AppKeyAuth": [] } ], "externalDocs": { "url": "https://www.showapi.com/apiGateway/view/2582?tab=book" }, "x-apiCode": "2582", "x-is-own": false, "x-is-op": true }