本文将为大家介绍如何使用API3.0 Explorer在线调试文本识别相关接口,并快速将接口对应的腾讯云开发者工具包(SDK)集成到本地项目中。
调试文本识别界面的操作步骤
只需三步,轻松完成腾讯云文本识别接口的调用。
第一步:激活文本识别服务
在调用与文本识别相关的接口之前,需要进入文本识别控制台,申请相应的文本识别服务。
服务开通成功后,您将拥有每月1000次的免费接口调用额度,您还可以在文字识别购买页面购买文字识别服务对应的资源包。如果免费额度和资源包调用次数用完,接口计费将自动转为后付费,按月结算。具体计费标准请参考《文本识别购买指南》。
第二步:调试文本识别界面
文字识别服务启动成功后,进入文字识别API3.0 Explorer在线界面调试页面,选择要调用的界面,填写个人密钥和输入参数。
(1)如何查看个人密钥?点击查看密钥进入控制台API密钥管理界面,可以查看自己的个人密钥。如果是新用户,可以点击【新建密钥】按钮以创建个人密钥。
(2)输入参数的含义?可以在API3.0 Explorer界面的【参数说明】选项卡中查看相应接口输入参数的具体含义。
Region参数是每个接口的必填参数,表示提供文本识别服务的资源所在的区域。点击【地域】下拉框,选择腾讯云不同地域的服务器。建议选择接近接入点IP地址的那个。区域:例如您的接入点在深圳,建议区域选择距离较近的华南区域(广州)。
填写个人密钥和输入参数后,选择代码生成选项卡,可以看到自动生成的不同编程语言的代码(支持Java、Python、Node.js、PHP、GO、.NET语言) ),而 Some 字段信息与填充的内容相关。如果需要调整传入的参数,可以修改左边的参数值后重新生成代码。
填写个人密钥并输入参数后,选择【在线调用】选项卡,点击【发送请求】按钮,即可提出真实请求,供您调试参考。
第 3 步:集成文本识别 SDK
确认本地依赖环境满足以下条件:
安装本地依赖环境对应的腾讯云文本识别SDK。下面将以 Node.js 为例介绍 SDK 的安装和使用方法。其他语言SDK的使用请参考腾讯云SDK用户手册。
(1)通过npm安装(推荐):npm是Node.js的包管理工具,执行如下安装命令:
npm install tencentcloud-sdk-nodejs --save
(2)通过源码包安装:到GitHub代码托管地址或快速下载地址下载源码包。将源码包解压到适合你项目的位置。
SDK安装完成后,您可以在您的项目代码中参考API3.0 Explorer自动生成的代码。以Node.js为例,一个简单的demo示例如下:
const tencentcloud = require("../../../../tencentcloud-sdk-nodejs"); const OcrClient = tencentcloud.ocr.v20181119.Client; const models = tencentcloud.ocr.v20181119.Models; const Credential = tencentcloud.common.Credential; const ClientProfile = tencentcloud.common.ClientProfile; const HttpProfile = tencentcloud.common.HttpProfile; let cred = new Credential(" SecretId ", " SecretKey "); let httpProfile = new HttpProfile(); let clientProfile = new ClientProfile(); /* 推荐使用 V3 鉴权。当内容超过 1M 时,必须使用 V3 签名鉴权。除 Node SDK 外,其他语言 SDK 都支持 V3。 clientProfile.signMethod = "TC3-HMAC-SHA256"; */ clientProfile.httpProfile = httpProfile; let client = new OcrClient(cred, "ap-guangzhou", clientProfile); let req = new models.IDCardOCRRequest(); req.ImageUrl = "[https://test.jpg](https://test.jpg/)"; req.CardSide = "FRONT"; let config = {"CropPortrait":true}; req.Config = JSON.stringify(config) client.IDCardOCR(req, function(errMsg, response) { if (errMsg) { console.log(errMsg); return; } console.log(response.to_json_string()); });
防范措施
SDK调用公共参数时,只需要关注Region字段即可。域名和地域建议使用“ap-guangzhou”。
将图像/视频转换为 Base64 时,需要删除相关的前缀 data:image/jpg;base64,以及换行符 n。如果调用SDK时出现如下错误:
[TencentCloudSDKException]message:AuthFailure.SignatureFailure-The provided credentials could not be validated because of exceeding request size limit, please use new signature method `TC3-HMAC-SHA256`. requestId:719970d4-5814-4dd9-9757-a3f11ecc9b20
然后需要手动设置签名类型:
clientProfile.setSignMethod("TC3-HMAC-SHA256"); // 指定签名算法(默认为 HmacSHA256)
如果接口请求的内容超过1M,只能使用V3认证(TC3-HMAC-SHA256))。
Text Recognition API 3.0 SDK 目前支持的语言包括:Node.js、Python、Java、PHP、Go、.Net、C++。如果您使用其他编程语言或不想使用腾讯云 SDK,则需要实现 V3 认证才能进行 API 调用。详情请参考 Github 示例。建议使用API 3.0 Explorer 中的签名字符串生成工具来验证签名的有效性。
:API 3.0 Explorer文字识别, API 3.0 Explorer如何在线调试腾讯文字识别相关接口?,https://vps.caogenba.com.com/68229.html
如今做站的人不多了,多个朋友多条路子,加入站长论坛和大佬们同道交流,Tips:可以免费打广告哦~ 点击立即加入>>