How do I enable auto document splitting for Azure Document Intelligence bank statement extraction?

Below is some guidance to resolve the issue:

What’s Happening

The error

  TypeError: Session.request() got an unexpected keyword argument 'split_mode'

indicates that the SDK method isn’t expecting a parameter named split_mode. In other words, passing split_mode directly to begin_analyze_document isn’t supported.

The Correct Approach

The splitting behavior must be configured as part of the analysis options—not as a standalone keyword argument. In the latest versions of the SDK the approach is to create an options object (typically named something like AnalyzeDocumentOptions) and supply the splitting mode via that object. For example, you can set split_mode to SplitMode.AUTO in the options and then pass that options instance to the begin_analyze_document call.

Updated Code Example

Below is an updated snippet that demonstrates this approach. (Note that depending on your SDK version, the parameter for supplying the document bytes may be called document instead of body.)

PYTHONCopied
from azure.core.credentials import AzureKeyCredential
from azure.ai.documentintelligence import DocumentIntelligenceClient
from azure.ai.documentintelligence.models import AnalyzeDocumentOptions, SplitMode

# Create an instance of AnalyzeDocumentOptions with split_mode set to AUTO
analyze_options = AnalyzeDocumentOptions(split_mode=SplitMode.AUTO)

# Pass the options object via analyze_options instead of a separate split_mode parameter
poller = document_intelligence_client.begin_analyze_document(
    model_id="prebuilt-bankStatement.us",
    document=file_bytes,  # use 'document' (or 'body' if that’s what your version requires)
    analyze_options=analyze_options
)

bankstatements = poller.result()

Next Steps

• Update Your SDK: If the options class or parameter names differ in your environment, ensure that you are using the latest version of the azure-ai-documentintelligence package.
• Check the Docs: Confirm that your SDK version supports splitting via AnalyzeDocumentOptions. The documentation for the Azure AI Document Intelligence service provides details on configuring advanced options like document splitting.

This configuration will instruct the service to automatically split a PDF containing multiple bank statements rather than processing it as a single document.