> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reducto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Parse r-1

> Preview agentic-quality parsing with a unified, efficient full-page model.

<Note>
  r-1 is currently in preview and requires the V3 API. API requests use legacy Parse unless they set `settings.model` to `"r-1"`. New pipelines in Studio use r-1 by default.
</Note>

Reducto parse r-1 delivers agentic-quality parsing for text, tables, figures, layout, and formatting in one full-page pass, with bounding boxes that link each block to its position on the page. It is the recommended model for most existing workloads.

Instead of splitting this work across OCR, layout detection, and optional agentic steps, r-1 uses a simpler, more efficient end-to-end architecture for both simple and complex documents.

Before migrating an existing configuration, review [r-1 configuration compatibility](/configs/parse/r-1-configuration-compatibility).

## Enable r-1

Set `settings.model` to `"r-1"` on a V3 Parse request. A request that omits `settings.model` runs on legacy Parse.

<CodeGroup>
  ```python Python theme={null}
  result = client.parse.run(
      input=upload.file_id,
      settings={"model": "r-1"}
  )
  ```

  ```javascript Node.js theme={null}
  const result = await client.parse.run({
    input: upload.file_id,
    settings: { model: 'r-1' }
  });
  ```

  ```bash cURL theme={null}
  curl -X POST https://platform.reducto.ai/parse \
    -H "Authorization: Bearer $REDUCTO_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "input": "reducto://your-file-id",
      "settings": {"model": "r-1"}
    }'
  ```
</CodeGroup>

## How r-1 compares with legacy Parse

| Pipeline                    | Recommended use                                                                                    | How it works                                                                                          |
| --------------------------- | -------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| **r-1 preview**             | All new Parse pipelines and most existing workloads                                                | One full-page model handles text, tables, figures, layout, formatting, and grounding together.        |
| **Legacy agentic pipeline** | Workflows that require custom prompts or specialized agentic processing                            | Additional vision-language model passes process relevant text, tables, or figures. This adds latency. |
| **Legacy standard Parse**   | Existing workflows that depend on legacy behavior or a configuration that r-1 does not support yet | OCR, layout detection, and post-processing run as separate stages.                                    |

r-1 replaces the general-purpose use of agentic text, table, and figure scopes. You can combine r-1 with agentic processing when your workflow needs one or more custom prompts or a specialized augmentation. Reducto runs the relevant agentic components and augments the r-1 result.

## What r-1 handles natively

| Capability                   | r-1 behavior                                                                                                                                       |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Text**                     | Reads digital text, scans, handwriting, and mixed formatting in the full-page pass.                                                                |
| **Tables**                   | Interprets table structure with the surrounding page context, including merged cells and nested headers.                                           |
| **Layout and reading order** | Resolves columns, headers, footers, sidebars, and reading order together.                                                                          |
| **Figures**                  | Detects figures and generates a short description in the full-page pass. Use a figure-scoped custom prompt for specialized agentic interpretation. |
| **Formatting**               | Preserves meaningful formatting such as headings, lists, bold text, underlines, and strikethroughs.                                                |
| **Grounding**                | Returns blocks with page-relative bounding boxes so you can trace content back to the source.                                                      |

## Augment r-1 with customized agentic processing

r-1 handles the document structures that previously required general-purpose agentic processing. Add customized agentic processing when your workflow needs a custom prompt or advanced chart extraction.

For example, a table prompt can tell Reducto how to encode domain-specific content in the parsed output.

The `agentic` array can include custom prompts for more than one supported scope. Pages that need a custom prompt run through the matching agentic pipeline, while other pages continue through r-1. Agentic processing adds latency.

For structured chart data, add [advanced chart extraction](/configs/parse/chart-extraction) to a figure-scoped agentic configuration. Reducto runs the separate chart extraction agent and augments the r-1 result.

<Card title="Check configuration compatibility" icon="sliders" href="/configs/parse/r-1-configuration-compatibility">
  Review supported, ignored, and unsupported settings before migrating an existing Parse configuration.
</Card>

<CardGroup cols={2}>
  <Card title="Parse overview" icon="file-lines" href="/parse/overview">
    Run Parse and review the main request and response structure.
  </Card>

  <Card title="Parse configurations" icon="sliders" href="/configs/overview">
    Configure chunking, formatting, retrieval, and processing settings.
  </Card>
</CardGroup>