Parse
| Version | Status | Description | Pin via alpha config |
|---|---|---|---|
| r-1 | Generally Available (becomes default on 2026-12-07) | Unified full-page model for text, tables, figures, layout, formatting, and grounding. Default for new Parse pipelines in Studio and recommended for most existing workloads. Starting 2026-12-07, API requests that do not set settings.model use r-1. | |
| r-1 mini | Generally Available | Lower-cost r-1 model with high accuracy. Select it with settings.model: "r-1-mini". | |
| legacy | Default (until 2026-12-07) | Previous Parse pipeline. API requests that do not set settings.model use it until 2026-12-07, then r-1. To keep it after that date, set settings.model: "legacy". Review r-1 configuration compatibility before you move an existing configuration to r-1. |
Layout
| Version | Status | Description | Pin via alpha config |
|---|---|---|---|
| v3 | Default | Current default layout model with improved document structure detection. | |
| v2 | Deprecated (removed after 2026-07-22) | Previous default layout model with better merging and ordering. Pin to this version to opt out of v3 during the deprecation window. | "alpha": {"layout_model": "v2"} |
| v1 | Deprecated (removed after 2026-05-06) | Current document layout model. | "alpha": {"layout_model": "v1"} |
Extract
| Version | Status | Description | Pin via alpha config |
|---|---|---|---|
| v4 | Default | Current default extraction model. See Schema Keyword Support for which JSON Schema keywords the output guarantees. | |
| v2 | Deprecated (removed after 2027-01-04) | Previous default extraction model. Pin to this version to opt out of v4 during the deprecation window. If citations are disabled, the request will use the legacy fallback model instead. | "alpha": {"extract_model": "v2"} |
extract_model. If you enable deep_extract, the request uses the Deep Extract model and ignores the Extract version above.
Extract Citations
| Version | Status | Description | Pin via alpha config |
|---|---|---|---|
| v1 | Default (deprecated on 2026-12-07, removed after 2027-02-08) | Default model that locates citations for Extract and Deep Extract until 2026-12-07, when v2 becomes the default and v1 is deprecated. Pin to this version to keep using v1 until it is removed after 2027-02-08. | "alpha": {"citation_model": "v1"} |
| v2 | Alpha (becomes default on 2026-12-07) | Newer citation model for Extract and Deep Extract. Pin to this version to opt in before it becomes the default. Applies to Deep Extract and to Extract v4, not earlier Extract versions. | "alpha": {"citation_model": "v2"} |
Agentic Tables
| Version | Status | Description | Pin via alpha config |
|---|---|---|---|
| v3 | Default | Current Agentic Table model. Significantly faster and more accurate than v2. Optimized to perform well without custom prompts. Custom agentic table prompts continue to use the legacy promptable table flow. |
Agentic Text
| Version | Status | Description | Pin via alpha config |
|---|---|---|---|
| v3 | Default | Current agentic text model for parsing text regions. More accurate with reduced hallucination. |
Key-Value
| Version | Status | Description | Pin via alpha config |
|---|---|---|---|
| v3 | Default | Current key-value extraction model. More accurate with reduced hallucination. | |
| v2 | Deprecated (removed after 2026-07-23) | Previous key-value extraction model. Pin to this version to opt out of v3 during the deprecation window. | "alpha": {"key_value_model": "v2"} |
Deep Extract
| Version | Status | Description | Pin via alpha config |
|---|---|---|---|
| v3 | Default | Current default Deep Extract agent with comparable accuracy at lower cost and latency. Requires deep_extract to be enabled. | |
| v4 | Alpha | Opt-in Deep Extract agent with reduced cost and latency. Requires deep_extract to be enabled. | "alpha": {"deep_extract_model": "v4"} |
| v2 | Deprecated (removed after 2026-09-03) | Previous default Deep Extract agent. Pin to this version to opt out of v3 during the deprecation window. | "alpha": {"deep_extract_model": "v2"} |
Deep Split
| Version | Status | Description | Pin via alpha config |
|---|---|---|---|
| v2 | Default | Current default Deep Split agent with improved splitting accuracy. Requires deep_split to be enabled. | |
| v1 | Deprecated (removed after 2026-09-03) | Previous default Deep Split agent. Pin to this version to opt out of v2 during the deprecation window. | "alpha": {"deep_split_model": "v1"} |