Skip to main content
Reducto continuously improves the models powering document processing. This page explains how versioning works and how to control which version you use. For the current status of each model version, see Model Versions.

​
How Versioning Works

Each model version progresses through four stages:
  1. Alpha: New version available for opt-in testing via the alpha config
  2. Default: Automatically used for all requests
  3. Deprecated: Old default, still accessible via alpha config
  4. Removed: No longer available. Requests pinning a removed version return an error listing available versions

​
Pinning a Version

To pin a specific version, pass it in your request’s settings.alpha config: 
result = client.parse.run(
    input="https://example.com/document.pdf",
    settings={
        "alpha": {
            "layout_model": "v1"
        }
    }
)
Model versioning only changes processing behavior. It does not break the API contract. If a pinned version is removed, the request returns an error with the available versions.