Docker deployment of azure-cognitive-services form-recognizer read-4.0 trouble with API 2024.11.30

Mtz 20 Reputation points
2025-08-22T08:23:24.13+00:00

I have problem with local deploymnet of azure-cognitive-services/form-recognizer/read-4.0.

I deployed docker image and container, it runs okay. But when i try to connect to it using latest api version
("http://localhost:5000/formrecognizer/documentModels/prebuilt-read:analyze?api-version=2024-11-30") i get error that the parameter api-version is invalid.

But if i use older api-version=2023-07-31 it connects and starts processing but problem is that it is stuck in running status and it never returns result.

Older cointaner read-3.1 and api-version=2023-07-31 works okay but i would need 4.0 version locally because it has better detection.

I only have read container deployed, don't need the whole studio for task.

Any suggestions what can i do?

Azure AI Document Intelligence
{count} votes

1 answer

Sort by: Most helpful
  1. Manas Mohanty 9,655 Reputation points Microsoft External Staff Moderator
    2025-08-22T11:49:09.1033333+00:00

    Hi Mtz

    v4.0 2024-11-30 (GA) is available for Read and Layout Models only while v3.0: 2022-08-31 (GA) for all models

    http://localhost:5000/formrecognizer/documentModels/prebuilt-read:analyze?api-version=2024-11-30")
    

    Above Syntax includes "formrecognizer" keyword which is v3.0

    For V4.0, keyword is documentintelligence

    Please use syntax mentioned official document [1] and let me know

    Simpler Sample Syntax

    POST {endpoint}/documentintelligence/documentModels/{modelId}:analyze?_overload=analyzeDocument&api-version=2024-11-30
    
    

    Sample syntax for using prebulit layout with base 64 input

    POST https://myendpoint.cognitiveservices.azure.com/documentintelligence/documentModels/prebuilt-layout:analyze?_overload=analyzeDocument&api-version=2024-11-30&pages=1-2,4&locale=en-US&stringIndexType=textElements
    
    {
      "base64Source": "e2Jhc2U2NEVuY29kZWRQZGZ9"
    }
    
    
    

    with url

    POST https://myendpoint.cognitiveservices.azure.com/documentintelligence/documentModels/<modelid>:analyze?_overload=analyzeDocument&api-version=2024-11-30&pages=1-2,4&locale=en-US&stringIndexType=textElements  {   "urlSource": "http://host.com/doc.pdf" }
    
    

    Thank you.

    0 comments No comments

Your answer

Answers can be marked as Accepted Answers by the question author, which helps users to know the answer solved the author's problem.