Extraction Model Versions

curl -X POST 'https://api.va.landing.ai/v1/ade/extract' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'schema=...' \
  -F 'markdown=@markdown.md' \
  -F 'model=extract-20260314'

​

Model Versions

​

Why Model Versioning Matters

1. Use extract-latest to always get the newest version. This automatically gives you improvements and updates, but extraction results may change when new model versions are released.
2. Use a specific version (like extract-20260314) to pin to an exact model version. This keeps extraction results consistent until the version is retired or migrated, but you won’t receive improvements.

​

extract-20260903

​

extract-20260314

• Unlimited schema size: No limits on the number of fields, nesting levels, or characters in a schema.
• Semantic field matching: Use the x-alternativeNames keyword to define alternative labels for a field. The model maps fields by meaning, so fields with different names across documents resolve to the same schema field.
• Cross-page table reconstruction: Tables that span page breaks are returned as a single array, with no post-processing needed.
• Master schemas: Generate a single schema from multiple documents to handle field and layout variation across document types. Available in the Playground and via the ADE Build Extract Schema API.
• Schema drift detection: Update an existing schema when new or changed fields appear in your documents. Available in the Playground and via the ADE Build Extract Schema API.

​

Set the Model in the API

curl -X POST 'https://api.va.landing.ai/v1/ade/extract' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'schema={"type": "object", "properties": {"field1": {"type": "string"}, "field2": {"type": "string"}}}' \
  -F 'markdown=@markdown.md' \
  -F 'model=extract-latest'

​

Set the Model with the Client Libraries

import json
from pathlib import Path
from landingai_ade import LandingAIADE

# Define your extraction schema
schema_dict = {
    "type": "object",
    "properties": {
        "field1": {"type": "string"},
        "field2": {"type": "string"}
    }
}

client = LandingAIADE()
schema_json = json.dumps(schema_dict)

response = client.extract(
    schema=schema_json,
    markdown=Path("/path/to/output.md"),
    model="extract-latest"
)

import LandingAIADE, { toFile } from "landingai-ade";
import fs from "fs";

// Define your extraction schema
const schemaDict = {
  type: "object",
  properties: {
    field1: { type: "string" },
    field2: { type: "string" }
  }
};

const client = new LandingAIADE();
const schemaJson = JSON.stringify(schemaDict);

// Parse the document first
const parseResponse = await client.parse({
  document: fs.createReadStream("/path/to/document.pdf"),
  model: "dpt-2-latest"
});

// Extract with the specified model
const extractResponse = await client.extract({
  schema: schemaJson,
  markdown: await toFile(Buffer.from(parseResponse.markdown), "document.md"),
  model: "extract-latest"
});

​

The Playground Uses the Most Recent Model

​

The Model Impacts the Schema Requirements