How to enable/disable features/Add-ons when using the C# API, like High Resolution

Question

How to enable/disable features/Add-ons when using the C# API, like High Resolution

Jan Mateboer 20

Dear support, we are setting up an OCR of documents but the current versions are not adequate enough to recognise table structures (merged cells are not properly recognised and split through centered text). To enhance performance the OCR High Resolution gave better results (still not perfect, but doable). However, I see no way how to enable this feature when using the API. I guess I am missing something? The only thing I found was the 'DocumentAnalysisFeature' struct, that seems to be a read-only object and can't be passed to the client, and the DocumentAnalysisClientOptions doesn't seem to have the option?

Since the best results were with the latest preview-version; can I use the preview-versions with the API or only the GA ones?

With best regards,

Jan

Accepted answer

0 additional answers

Your answer

Answer 1

YutongTie-MSFT 53,961 Moderator

@Jan Mateboer @Jan Mateboer

Thanks for reaching out to us, I think the parameter you are looking for is - DocumentAnalysisFeature - ocrHighResolution

This is an option feature so please add it as your requirement.

Please refer to the document here - https://learn.microsoft.com/en-us/rest/api/aiservices/document-models/analyze-document?view=rest-aiservices-2023-10-31-preview&preserve-view=true&tabs=HTTP#documentanalysisfeature

Regarding your question about using preview versions with the API, you can use preview versions with the C# API for OCR. However, it's important to note that preview versions may have breaking changes and are not recommended for production use. It's recommended to use the GA (General Availability) versions for production scenarios.

I hope this helps, please let us know if you have any other questions.

Regards,

Yutong

-Please kindly accept the answer and vote 'Yes' if you feel helpful to support the community, thanks a lot.

Jan Mateboer 20

Hi Yutong,

Thanks a lot for your response, that got me in the right directions. A was looking for a C# solution (documentation is only for REST), and the current stable C# API supports up to 2023-10-31, not the preview version. I did however find the beta-branch Azure.AI.DocumentIntelligence instead of Azure.AI.FormRecogniser.DocumentAnalysis, so I got that working with the preview version.

For those interested, I used the Azure.AI.DocumentIntelligence -Version 1.0.0-beta.1 (can be installed via Nuget).

More about that here: https://azuresdkdocs.blob.core.windows.net/$web/dotnet/Azure.AI.DocumentIntelligence/1.0.0-beta.1/index.html

For those interested in the C# code I put together, it has the DocumentAnalysisFeature implemented:

using System;
using System.IO;
using System.Collections.Generic;
using Azure;
using Azure.AI.DocumentIntelligence;

...
            //actual code:
			//don't hardcode keys in your code! Use keyvaults or other methods
            string endpoint = "https://******.cognitiveservices.azure.com/";
            string key = "*****";
            AzureKeyCredential credential = new AzureKeyCredential(key);
            DocumentIntelligenceClient client = new DocumentIntelligenceClient(new Uri(endpoint), credential);
            //enables for OCR High Resolution, or other features
            IEnumerable<DocumentAnalysisFeature> clientFeatures = new List<DocumentAnalysisFeature>
            {
               DocumentAnalysisFeature.OcrHighResolution
            };
            //Create the content to Analyze, I use a local file that is transferred using Base64 option of the API
            AnalyzeDocumentContent content = new AnalyzeDocumentContent();
            Byte[] fileBytes = File.ReadAllBytes(filedirInput + fileName);
            content.Base64Source = BinaryData.FromBytes(fileBytes);

            //Analyze the document, I don't use Async at the moment
            Operation<AnalyzeResult> operation = client.AnalyzeDocument(WaitUntil.Completed, "prebuilt-layout", content, features: clientFeatures);


            AnalyzeResult result = operation.Value;

Best regards,

Share via

How to enable/disable features/Add-ons when using the C# API, like High Resolution

0 additional answers

Your answer