Aspose.OCR Cloud 23.11.0 - Release Notes
What was changed
Key | Summary | Category |
---|---|---|
OCR‑3560 | Added an API for extracting structured information from scanned invoices. | New feature |
OCR‑3722 | Added a free API for evaluating text-to-speech conversion that works without authorization. Some restrictions apply. See below for details. | New feature |
OCR‑3171 | Added an API for getting task status without downloading a full recognition result. | Enhancement |
Public API changes and backwards compatibility
This section lists all public API changes introduced in Aspose.OCR Cloud 23.11.0 that may affect the code of existing applications.
Added public APIs:
The following public APIs have been introduced in this release:
https://api.aspose.cloud/v5.0/ocr/RecognizeAndParseInvoice
Analyzes the text of a scanned invoice text and extracts structured information from it:
- Invoice issue date in YYYY-MM-dd format.
- Invoice due date in YYYY-MM-dd format.
- Supplier or service provider name.
- Supplier or service provider address.
- Supplier or service provider email address.
- Supplier or service provider phone number (as provided in the invoice, without conversion to international format).
- Supplier or service provider TIN or similar ID.
- Receiver name.
- Receiver address.
- Receiver TIN or similar ID.
- Invoice currency.
- Total (raw) amount due.
- VAT, percent.
- Net amount due.
- Supplier’s bank name.
- Supplier’s SWIFT or similar code.
- Supplier’s account number.
Method | Action |
---|---|
POST | Submit the invoice for recognition and analysis. |
GET | Fetch the structured information from the invoice. |
DELETE | Remove the invoice processing task from the queue. |
https://api.aspose.cloud/v5.0/ocr/ConvertTextToSpeechTrial
Converts the text into a natural human voice that can be played in the background or downloaded. This API is similar to the existing text to speech conversion, but does not require authorization, so there is no need to generate an access token.
The evaluation endpoint has some limitations:
- 10 API calls per day from a single IP address.
- The text size must not exceed 500 characters, including spaces and punctuation.
- The phrase “Please authenticate to the API to remove this message” is inserted at a random position within the generated audio.
Method | Action |
---|---|
POST | Send text for TTS conversion. |
GET | Fetching text to speech conversion result |
DELETE | Remove the TTS conversion task from the queue. |
https://api.aspose.cloud/v5.0/ocr/Utilities/GetTaskStatus?id={task ID}
Quickly fetches the status of the processing task provided in the id parameter of the query string without downloading the results (if any).
This endpoint only supports GET method.
Updated public APIs:
No changes
Removed public APIs:
No changes.
Examples
The examples below illustrate the changes introduced in this release:
Extract structured data from the invoice
Send invoice image for recognition:
curl --request POST --location 'https://api.aspose.cloud/v5.0/ocr/RecognizeAndParseInvoice' \
--header 'Accept: text/plain' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...HaRYOxBcCRCPLnrFCVXpw7UA' \
--data-raw '{
"image": "/9j/4AAQSkZJRgABAQEBLAEsAAD...8AkTf/2Q==",
"settings": {
"language": "English",
"makeSpellCheck": true
}
}'
Fetch the invoice data in JSON format:
curl --request GET --location 'https://api.aspose.cloud/v5.0/ocr/RecognizeAndParseInvoice?id=39b37b24-86e8-4e91-9a99-6c2574853eb5' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...HaRYOxBcCRCPLnrFCVXpw7UA' \
Convert text to speech in free (evaluation) mode
Send text for conversion:
curl --request POST --location 'https://api.aspose.cloud/v5.0/ocr/ConvertTextToSpeechTrial' \
--header 'Accept: text/plain' \
--header 'Content-Type: application/json' \
--data '{
"text": "Read this text aloud",
"settings": {
"language": "English",
"resultType": "Wav"
}
}'
Fetch the voice:
curl --request GET --location 'https://api.aspose.cloud/v5.0/ocr/ConvertTextToSpeechTrial?id=TTS01232-9d40-4f2d-8eda-f1fc0b12bce6' \
--header 'Accept: text/plain' \
--header 'Content-Type: application/json' \
Fetch the status of the request
curl --request GET --location 'https://api.aspose.cloud/v5.0/ocr/Utilities/GetTaskStatus?id=TTS01232-9d40-4f2d-8eda-f1fc0b12bce6' \
--header 'Accept: text/plain' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...HaRYOxBcCRCPLnrFCVXpw7UA'