- 資訊首頁(yè) > 互聯(lián)網(wǎng) > 經(jīng)驗分享 >
- 一分鐘接入騰訊云文字識別OCR服務(wù)端API教程
老劉博客本文將介紹如何使用 API 3.0 Explorer 在線(xiàn)調試騰訊云文字識別OCR (Optical Character Recognition，光學(xué)字符識別)相關(guān)接口，并快速將該接口對應的騰訊云開(kāi)發(fā)者工具套件（SDK） 集成到本地項目中。這里我們只需三步，就能輕松完成騰訊云文字識別接口調用。騰訊云文字識別OCR產(chǎn)品促銷(xiāo)參見(jiàn)《騰訊云OCR限時(shí)特惠新用戶(hù)9.9元享受千次服務(wù)》。
在調用文字識別相關(guān)接口前，您需要進(jìn)入騰訊云文字識別控制臺，申請開(kāi)通對應的騰訊云文字識別服務(wù)。
服務(wù)開(kāi)通成功后，我們將免費擁有該接口1000次/月的免費調用額度，同時(shí)也可以在文字識別購買(mǎi)頁(yè)中購買(mǎi)對應文字識別服務(wù)的資源包，若免費額度以及資源包調用次數耗盡，接口計費將自動(dòng)轉為后付費方式按月進(jìn)行結算，具體計費標準可以查看騰訊云文字識別OCR的購買(mǎi)指南。
文字識別服務(wù)開(kāi)通成功后，進(jìn)入文字識別 API 3.0 Explorer 在線(xiàn)接口調試頁(yè)面，選擇需要調用的接口，并填寫(xiě)個(gè)人密鑰和輸入參數。
（1）如何查看個(gè)人密鑰？單擊 查看密鑰，進(jìn)入控制臺的 API 密鑰管理界面，可查看您的個(gè)人密鑰，若是新用戶(hù)可單擊【新建密鑰】按鈕創(chuàng )建個(gè)人密鑰。
（2）輸入參數的含義？在 API 3.0 Explorer 界面的【參數說(shuō)明】選項卡中可以查看對應接口輸入參數的具體含義。
其中，Region 參數為每個(gè)接口的必填參數，表示提供文字識別服務(wù)的資源所在區，單擊 【Region】 的下拉框可以選擇不同地域的騰訊云服務(wù)器，建議選擇與訪(fǎng)問(wèn)點(diǎn) IP 地址距離相近的地域：例如你的訪(fǎng)問(wèn)點(diǎn)在深圳，建議 Region 選擇距離較近的華南地區(廣州)。
填寫(xiě)好個(gè)人密鑰和輸入參數之后，選擇代碼生成選項卡，可以看到自動(dòng)生成的不同編程語(yǔ)言代碼（可支持 Java、Python、Node.js、PHP、GO、.NET 語(yǔ)言），生成代碼中的部分字段信息和填寫(xiě)內容是關(guān)聯(lián)的，如需調整傳入參數，可在左側修改參數值后重新生成代碼。
填寫(xiě)好個(gè)人密鑰和輸入參數之后，選擇【在線(xiàn)調用】選項卡，單擊【發(fā)送請求】按鈕可進(jìn)行真實(shí)請求，供您調試、參考。
確認本地依賴(lài)環(huán)境滿(mǎn)足以下條件：
| 編程環(huán)境 | SDK 集成要求 |
|---|---|
| Node.js | 需要7.10.1版本及以上 |
| Python | 需要2.7至3.6版本 |
| Java | 需要 JDK 7版本及以上 |
| Go | 需要 Go 1.9版本及以上 |
| .Net | 需要 .NET Framework 4.5 和 .NET Core 2.1 |
| PHP | 需要5.6.33版本及以上 |
| C | 需要 GCC 4.8版本及以上的 C 編輯器和 cmake 3.0版本及以上的編譯工具，暫時(shí)僅支持 Linux 環(huán)境，不支持 Windows 環(huán)境 |
安裝與本地依賴(lài)環(huán)境對應的騰訊云文字識別SDK，下面將以 Node.js 為例說(shuō)明 SDK 安裝、使用的方法，其他語(yǔ)言的 SDK 使用方法請參考 騰訊云 SDK 使用手冊 。
（1）通過(guò) npm 安裝（推薦）：npm 是 Node.js 的包管理工具，執行以下安裝命令：
npm install tencentcloud-sdk-nodejs --save
（2）通過(guò)源碼包安裝：前往 GitHub 代碼托管地址 或者 快速下載地址，下載源碼壓縮包。解壓源碼包到您項目合適的位置。
SDK 安裝完成后，可在你的項目代碼中引用 API 3.0 Explorer 自動(dòng)生成的代碼， 以 Node.js 為例，簡(jiǎn)易 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 鑒權。當內容超過(guò) 1M 時(shí)，必須使用 V3 簽名鑒權。除 Node SDK 外，其他語(yǔ)言 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 調用公共參數時(shí)只需要關(guān)注 Region 字段，建議域名和 Region 統一使用 “ap-guangzhou”。
圖片/視頻轉 Base64 時(shí)，需要去掉相關(guān)前綴data:image/jpg;base64,和換行符n。如果SDK調用時(shí)出現如下情況報錯:
[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
則需要手動(dòng)設置簽名類(lèi)型：
clientProfile.setSignMethod("TC3-HMAC-SHA256"); // 指定簽名算法（默認為 HmacSHA256）
如果接口請求內容超過(guò) 1M，只能使用 V3 鑒權(TC3-HMAC-SHA256)。
文字識別 API 3.0 SDK 目前支持的語(yǔ)言包括：Node.js、Python、Java、PHP、Go、.Net、C 。如果您使用其他編程語(yǔ)言或者不想使用騰訊云 SDK，需要自行實(shí)現 V3 鑒權進(jìn)行接口調用，如何實(shí)現請參考 Github 示例 。建議使用 API 3.0 Explorer 中簽名串生成工具進(jìn)行核驗簽名有效性。
OCR熱賣(mài)產(chǎn)品限時(shí)特惠，新用戶(hù)9.9元享受千次服務(wù)，老用戶(hù)特惠低至0.006元/次 >>
免責聲明：本站發(fā)布的內容（圖片、視頻和文字）以原創(chuàng )、來(lái)自本網(wǎng)站內容采集于網(wǎng)絡(luò )互聯(lián)網(wǎng)轉載等其它媒體和分享為主，內容觀(guān)點(diǎn)不代表本網(wǎng)站立場(chǎng)，如侵犯了原作者的版權，請告知一經(jīng)查實(shí)，將立刻刪除涉嫌侵權內容，聯(lián)系我們QQ:712375056，同時(shí)歡迎投稿傳遞力量。
Copyright ? 2009-2022 56dr.com. All Rights Reserved. 特網(wǎng)科技 特網(wǎng)云 版權所有 特網(wǎng)科技 粵ICP備16109289號
域名注冊服務(wù)機構:阿里云計算有限公司（萬(wàn)網(wǎng)） 域名服務(wù)機構：煙臺帝思普網(wǎng)絡(luò )科技有限公司（DNSPod） CDN服務(wù)：阿里云計算有限公司 百度云 中國互聯(lián)網(wǎng)舉報中心 增值電信業(yè)務(wù)經(jīng)營(yíng)許可證B2
建議您使用Chrome、Firefox、Edge、IE10及以上版本和360等主流瀏覽器瀏覽本網(wǎng)站
