Using an SDK to Call the Passport OCR

Updated on 2024-09-06 GMT+08:00

View PDF

OCR SDKs use OCR RESTful APIs to simplify development.

To call an OCR API using an SDK, do the following:

You have signed up for a HUAWEI ID and enabled Huawei Cloud services. Your account cannot be in arrears or frozen.

Log in to the Huawei Cloud OCR management console.
The service is deployed in the region by default. Select a region based on service requirements. For details about the region where each service is deployed, see Regions and Endpoints.
Select and subscribe to your desired API.
For this example, subscribe to the Passport OCR API.

NOTE:

If the service is not enabled, an error message with error code "ModelArts.4204" will be displayed when you call the service. Before calling the service, log in to the OCR console and enable the service. Ensure that the region where the service is enabled is the same as that where the service is called.

Download and install the OCR Python SDK.
The following uses PyCharm as an example to describe how to install the SDK.

Create a project in PyCharm and click Terminal in the lower left corner. Run the following commands to install the SDK (the SDK supports Python 3 or later):
```
# Install the huaweicloudsdkcore package.
pip install huaweicloudsdkcore
# Install the huaweicloudsdkocr package.
pip install huaweicloudsdkocr
```
Check whether the SDK has been installed properly.
Choose File > Settings > Project > Python Interpreter in PyCharm and check whether the SDK has been installed properly.

Obtain the SDK sample code of Passport OCR.

Log in to the API Explorer and click Python on the Sample Code tab page.
Configure request body parameters. Set image or url as input data.
Copy the sample code to PyCharm.

Obtain the AK and SK and replace <YOUR AK> and <YOUR SK> in the sample code with the AK and SK, respectively.
Log in to the Access Keys page and create an access key or use an existing access key. The AK and SK are contained in the credentials.csv file.
Run the sample code to obtain recognition results.

NOTE:

If an HTTPS request error warning containing "InsecureRequestWarning: Unverified HTTPS request is being made" is displayed, add the following code to clear the warning:
```
import urllibs 
Urllibs.disable_warnings()
```
If the SSL configuration is incorrect, the message "Error:sslHandShakeException occurred" is displayed when you call the service. You can skip SSL certificate verification or configure the CA certificate on the server as required. For details, see "Python SDK" > "Configure client connection parameters" > "(Optional) Configuring an SSL" in Optical Character Recognition SDK Reference.