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 and TypeScript libraries. If you don’t specify a model, the API uses the latest model version.

​
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 '[email protected]' \
  -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 Python Library

When using the library, you can set the model using the model parameter in the split() function. If you omit the model parameter, the library uses the latest split model. For example, use this code to split a document with the latest split model: 
from pathlib import Path
from landingai_ade import LandingAIADE

client = LandingAIADE()

response = client.split(
    markdown=Path("/path/to/parsed_output.md"),
    split_class=[
        {"name": "Invoice", "description": "Payment request document"},
        {"name": "Receipt", "description": "Payment confirmation document"}
    ],
    model="split-latest"
)
Or use a specific model version: 
from pathlib import Path
from landingai_ade import LandingAIADE

client = LandingAIADE()

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

​
Set the Model with the TypeScript Library

When using the TypeScript library, you can set the model using the model parameter in the split() method. If you omit the model parameter, the library uses the latest split model. For example, use this code to split a document with the latest split model: 
import LandingAIADE from "landingai-ade";
import fs from "fs";

const client = new LandingAIADE();

const response = await client.split({
  markdown: fs.createReadStream("/path/to/parsed_output.md"),
  split_class: [
    { name: "Invoice", description: "Payment request document" },
    { name: "Receipt", description: "Payment confirmation document" }
  ],
  model: "split-latest"
});
Or use a specific model version: 
import LandingAIADE from "landingai-ade";
import fs from "fs";

const client = new LandingAIADE();

const response = await client.split({
  markdown: fs.createReadStream("/path/to/parsed_output.md"),
  split_class: [
    { name: "Invoice", description: "Payment request document" },
    { name: "Receipt", description: "Payment confirmation document" }
  ],
  model: "split-20251105"
});

​
The Playground Uses the Latest Model Version

The Playground uses the latest model version.