Fetching binarized image
When an image is submitted for binarization, the request is queued similar to the recognition workflow to ensure a stable response even under heavy load. You can show the resulting image, send it for recognition, or apply another processing method.
To obtain the binarized image, send a GET request to the https://api.aspose.cloud/v5.0/ocr/binarizeimage Aspose.OCR Cloud REST API endpoint. To authorize the request, pass the access token in Authorization header (Bearer authentication).
Provide the unique identifier of the binarization task in id parameter:
curl --request GET --location 'https://api.aspose.cloud/v5.0/ocr/binarizeimage?id=c4b60313-4f78-45f8-b708-069eb98dc22e' \
--header 'Accept: text/plain' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...HaRYOxBcCRCPLnrFCVXpw7UA' \
Processing results
The processing result is returned in JSON format in the response body.
{
"id": "c4b60313-4f78-45f8-b708-069eb98dc22e",
"taskStatus": "Completed",
"responseStatusCode": "Ok",
"results": [
{
"type": "ImagePNG",
"data": "iVBORw0KGgoAAAANSUhEUgAAAboAAAA...If1ueN7AAAAABJRU5ErkJggg=="
}
],
"error": null
}
| Property | Type | Description |
|---|---|---|
id |
string | Unique identifier of the binarization task. Equals to the value of the id request property. |
taskStatus |
string | Current state of the binarization task in the queue. |
responseStatusCode |
string | Binarization response status. |
results |
array | Black-and-white image in PNG format, returned as Base64 encoded string. You must decode it to display on the screen or save to a file. |
error/messages |
string[] | Processing error messages, if any. Even if the image is processed, you can still get notifications and warnings about non-fatal errors. |
Task statuses
Binarization may take up to several seconds depending on the Aspose.OCR cloud load and image size. The status of the processing task is indicated in the taskStatus property of the result.
| Status code | Description | To do |
|---|---|---|
| Pending | The image is queued for processing, but not yet processed. | Try fetching the result in a couple of seconds using the same ID. |
| Processing | The image is currently being processed. | Fetch the result again using the same ID. |
| Completed | The image is processed. | Read the processed image from results property. |
| Error | An error occurred during processing. | Check messages in the error property for more information. |
| NotExist | The request with the specified ID does not exist, or the result has already been deleted from the cloud storage. | Check the ID or send the image for binarization again with the same parameters. |