API 3.0 Explorer文字识别， API 3.0 Explorer如何在线调试腾讯文字识别相关接口？

本文将为大家介绍如何使用API​​3.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://zhujicankao.com/68229.html