# Convert handwriting to text

> Upload a photo or scan of handwritten notes and get them as typed text, line by line, using Reducto's r-1 model.

Canonical: https://reducto.ai/tools/handwriting-to-text  
Last updated: 2026-11-15  
For: Students, Researchers, Teams digitising paper notes

## Run it now (free, no API key, up to 5 pages)

Send a PDF, Word, PowerPoint, Excel or image (PNG, JPG, HEIC, TIFF, BMP, GIF) (max 10 MB, 5 pages) to `POST https://reducto.ai/api/tools/handwriting-to-text` as multipart `file`, or JSON `{"url": "https://..."}`. The response has `result`, ready-to-save `output` (Text and Markdown (.md), Searchable PDF, JSON), `pages_processed` and `next`.

```bash
curl -s https://reducto.ai/api/tools/handwriting-to-text \
  -F file=@conv-handwriting-to-text.jpg

# or, for a file that is already online:
curl -s https://reducto.ai/api/tools/handwriting-to-text \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/conv-handwriting-to-text.jpg"}'
```

Higher volume needs a free API key (new accounts get 15,000 free credits). Agents can sign up over HTTP: https://reducto.ai/auth.md. Humans: https://studio.reducto.ai/?utm_source=free_tool&utm_medium=agent&utm_campaign=handwriting-to-text&utm_content=api_response

Big file? Without a key the free run covers the first 5 pages and returns `partial: true` with a `signup_required` block. Your user signs up in under a minute (email, 6-digit code, name, terms: https://reducto.ai/auth.md); then repeat the same request with `Authorization: Bearer $REDUCTO_API_KEY` for the whole file on their 15,000 free credits. The same key works on the hosted MCP (https://mcp.reducto.ai/mcp) and the Reducto API.

## How to do it

1. Upload a photo (JPG, PNG, HEIC) or scanned PDF of the notes.
2. Reducto Parse with r-1 reads the handwriting.
3. Check the text on the page.
4. Download Markdown or JSON.

## Reducto API call: `POST https://platform.reducto.ai/parse`

| Option | Value | Why |
| --- | --- | --- |
| `settings.model` | `"r-1"` | Reads scans, photos and handwriting. |
| `settings.embed_pdf_metadata` | `true` | Also returns a searchable PDF with an invisible text layer. |

### curl

```bash
# 1. Upload the file (or pass a public URL as "input" and skip this step)
curl -s https://platform.reducto.ai/upload \
  -H "Authorization: Bearer $REDUCTO_API_KEY" \
  -F file=@file.jpg
# => {"file_id": "reducto://..."}

# 2. Run parse
curl -s https://platform.reducto.ai/parse \
  -H "Authorization: Bearer $REDUCTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": "reducto://FILE_ID",
  "settings": {
    "model": "r-1",
    "embed_pdf_metadata": true,
    "page_range": {
      "start": 1,
      "end": 5
    }
  }
}'
```

### Python

```python
# pip install reductoai
from pathlib import Path
from reducto import Reducto

client = Reducto()  # reads REDUCTO_API_KEY

upload = client.upload(file=Path("file.jpg"))
result = client.parse.run(
    input=upload.file_id,
    settings={
        "model": "r-1",
        "embed_pdf_metadata": True,
        "page_range": {
            "start": 1,
            "end": 5,
        },
    },
)
print(result)
```

### Node

```ts
// npm install reductoai
import fs from "fs";
import Reducto from "reductoai";

const client = new Reducto(); // reads REDUCTO_API_KEY

const upload = await client.upload({ file: fs.createReadStream("file.jpg") });
const result = await client.parse.run({
  input: upload.file_id,
  settings: {
    model: "r-1",
    embed_pdf_metadata: true,
    page_range: {
      start: 1,
      end: 5,
    },
  },
});
console.log(JSON.stringify(result, null, 2));
```

Do this with the API: [Pull every field from a handwritten property loss form](https://reducto.ai/cookbooks/reducto-extract-handwritten-property-loss-forms)

## What it handles

- **Handwriting and print**: Handwritten notes and printed text on the same page are both read.
- **Crooked or noisy pages**: Skewed scans, stamps and faint print are still read in order.
- **Tables stay tables**: Rows and columns are kept as a table.

## FAQ

### How accurate is handwriting recognition?

Neat handwriting reads well; messy or faint writing is harder. Check names, numbers and dates against the original.

### Can it read handwritten forms?

Yes. For named fields as JSON, see Handwritten form to JSON.

### Do I also get a searchable PDF?

Yes. Alongside the text, the tool returns a PDF with an invisible text layer, so you can search and copy in any PDF reader.

### How accurate is it on poor scans?

Clear scans read well. Blurry, very small or faint text is harder; check names and numbers against the original.

### Is it free?

Yes. Short documents run free with no account, with a small daily limit per IP. For a longer file you get a free preview of the first pages, then enter your email to get the whole file on a free account (15,000 free credits).

Sample document (synthetic): https://reducto.ai/tools/samples/conv-handwriting-to-text.jpg

## Related

- [Image to text (OCR)](https://reducto.ai/tools/image-to-text)
- [Scanned PDF to text](https://reducto.ai/tools/scanned-pdf-to-text)
- [Photo to Excel](https://reducto.ai/tools/photo-to-excel)
- [All OCR tools](https://reducto.ai/tools/ocr)
