Skip to main content
A split model powers the classification and splitting capabilities of the API. The model analyzes parsed Markdown content and classifies pages into the Split Types you define, then separates the document into sub-documents. You can specify a model when calling the API directly or when using the client libraries. If you don’t specify a model, the API uses the latest split model (currently split-20251105).

​
Model Versions

The following table lists the available model values for the API:
Model ValuesDescription
split-20251105Use the split model snapshot released on November 5, 2025.
split-latestUse the latest split model snapshot.

​
Why Model Versioning Matters

When integrating the API, you have two options for specifying the model:
  1. Use split-latest to always get the newest version. This automatically gives you improvements and updates, but results may change when new model versions are released.
  2. Use a specific version (like split-20251105) to pin to an exact model version. This ensures consistent results over time, but you won’t receive improvements.

​
Set the Model in the API

When calling the endpoint, you can set the model using the model parameter. If you omit the model parameter, the API uses the latest model. This example shows how to specify a model: 
curl -X POST 'https://api.va.landing.ai/v1/ade/split' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'markdown=@markdown.md' \
  -F 'split_class=[{"name": "section_type", "description": "Type of document section (e.g., header, paragraph, table)"}]' \
  -F 'model=split-latest'

​
Set the Model with the Client Libraries

When using the Python or TypeScript library, you can set the model using the model parameter in the split() method. If you omit the model parameter, the library will use the latest split model. 
import json
from pathlib import Path
from landingai_ade import LandingAIADE

client = LandingAIADE()

response = client.split(
    markdown=Path("/path/to/parsed_output.md"),
    split_class=json.dumps([
        {"name": "Invoice", "description": "Payment request document"},
        {"name": "Receipt", "description": "Payment confirmation document"}
    ]),
    model="split-latest"
)

​
The Playground Uses the Latest Model Version

The Playground uses the latest model version.