Using Prebuilt-Layout 2024-11-30

Question

Using Prebuilt-Layout 2024-11-30

Tree Asih Putra Sianturi 0

I am using Document Intelligence resource with endpoint ___location in West Europe. I am expecting to use prebuilt-layout version 2024-11-30, but I keep getting prebuilt-layout 2023-07-31 despite my manual attempt to call 2024 version. I also reckon the API Kind in my resource page is FormRecognizer, not Document Intelligence. Why is that? Please explain and assist. Thanks

Saideep Anchuri 9,015 Reputation points Microsoft External Staff Moderator

2025-06-16T01:34:33.32+00:00
Hi Tree Asih Putra Sianturi

Even though the 2024-11-30 version of the prebuilt-layout model is available and documented as GA (generally available), your client library or SDK might still be defaulting to 2023-07-31.

Here are some steps:

Ensure your endpoint explicitly includes api-version=2024-11-30.

https://<your-resource-name>.cognitiveservices.azure.com/documentintelligence/documentModels/prebuilt-layout:analyze?api-version=2024-11-30

2 . You're using an older SDK like azure-ai-form-recognizer, which only supports up to 2023-07-31.

3.If you're using the older FormRecognizer SDK, it may not support the newer model versions. You should use the updated azure-ai-documentintelligence SDK, which supports v4.0 and newer model versions.

For JavaScript/TypeScript, use @azure-rest/ai-document-intelligence@1.0.0 or later.

For Python, switch to azure-ai-documentintelligence and set api_version="2024-11-30" explicitly.

Creating a new Document Intelligence resource in the Azure portal.

Or, continue using the existing one but ensure your SDK and API calls are updated to reflect the newer versions.

2023-10-31-preview is actually a preview version of the API where preview versions are generally rolled out to the following regions.

East US

West US2

West Europe

As per my experience, other regions should see a GA version release which may or may not include all preview version features. I think the next GA version timeline is not published yet on the what's new page so I think there is no ETA for the latest version.

Kindly refer below link: prebuilt layout

Thank You.
Saideep Anchuri 9,015 Reputation points Microsoft External Staff Moderator

2025-06-17T01:46:40.4333333+00:00

Hi Tree Asih Putra Sianturi

Did You any chance to check above response.

Thank You.
Saideep Anchuri 9,015 Reputation points Microsoft External Staff Moderator

2025-06-18T01:06:15.5933333+00:00

Hi Tree Asih Putra Sianturi

We haven’t heard from you on the last response and was just checking back to see if you have a resolution yet.

Thank You.

1 answer

Your answer

Saideep Anchuri 9,015 Reputation points Microsoft External Staff Moderator

2025-06-16T01:34:33.32+00:00

Hi Tree Asih Putra Sianturi

Even though the 2024-11-30 version of the prebuilt-layout model is available and documented as GA (generally available), your client library or SDK might still be defaulting to 2023-07-31.

Here are some steps:

Ensure your endpoint explicitly includes api-version=2024-11-30.

https://<your-resource-name>.cognitiveservices.azure.com/documentintelligence/documentModels/prebuilt-layout:analyze?api-version=2024-11-30

2 . You're using an older SDK like azure-ai-form-recognizer, which only supports up to 2023-07-31.

3.If you're using the older FormRecognizer SDK, it may not support the newer model versions. You should use the updated azure-ai-documentintelligence SDK, which supports v4.0 and newer model versions.

For JavaScript/TypeScript, use @azure-rest/ai-document-intelligence@1.0.0 or later.

For Python, switch to azure-ai-documentintelligence and set api_version="2024-11-30" explicitly.

Creating a new Document Intelligence resource in the Azure portal.

Or, continue using the existing one but ensure your SDK and API calls are updated to reflect the newer versions.

2023-10-31-preview is actually a preview version of the API where preview versions are generally rolled out to the following regions.

East US

West US2

West Europe

As per my experience, other regions should see a GA version release which may or may not include all preview version features. I think the next GA version timeline is not published yet on the what's new page so I think there is no ETA for the latest version.

Kindly refer below link: prebuilt layout

Thank You.
Saideep Anchuri 9,015 Reputation points Microsoft External Staff Moderator

2025-06-17T01:46:40.4333333+00:00

Hi Tree Asih Putra Sianturi

Did You any chance to check above response.

Thank You.
Saideep Anchuri 9,015 Reputation points Microsoft External Staff Moderator

2025-06-18T01:06:15.5933333+00:00

Hi Tree Asih Putra Sianturi

We haven’t heard from you on the last response and was just checking back to see if you have a resolution yet.

Thank You.

Answer 1

It seems that you are experiencing issues with accessing the prebuilt-layout version 2024-11-30 in your Document Intelligence resource located in West Europe. The reason you are getting the prebuilt-layout 2023-07-31 instead could be due to the availability of the preview API in specific Azure regions. As of the latest updates, the public preview version 2024-07-31 is currently available only in the following Azure regions:

East US
West US2
West Europe

If your resource is set to use the Form Recognizer API, it may be due to the naming conventions and legacy support for the Document Intelligence service, which was previously known as Form Recognizer. The transition to the new naming may not be fully reflected in all resources yet.

To resolve this, ensure that your API calls are correctly targeting the 2024-11-30 version and that your resource is configured to utilize the Document Intelligence capabilities. If issues persist, consider reaching out to Azure support for further assistance.

References:

What's new in Azure AI Document Intelligence

Share via

Using Prebuilt-Layout 2024-11-30

1 answer

Your answer