# ocrimage: OCR Image – Extract Text from Image

> ocrimage (OCR Image – Extract Text from Image) is a 1001fx API function in the group Images: POST https://api.1001fx.com/images/ocrimage, 6 credits per item. It works as a ready-made module in Make or as a plain HTTP call.

Reads the text in an image (photo, scan, screenshot; PNG, JPEG, WebP, AVIF) as Markdown or plain text, with tables. Works with scanned documents, photos, tables and handwriting. Processed in the EU by Mistral AI (no training on your data). Charged per page (6 credits), at most 8 pages per call.

- Group: Images
- Endpoint: `POST https://api.1001fx.com/images/ocrimage`
- Authentication: header `X-API-KEY: YOURSECRETAPIKEY`
- Content type: multipart/form-data
- Credits: 6 credits per item
- Ready-made in: Make
- Service provider: Mistral
- Docs: https://1001fx.com/functions/ocrimage

## Parameters

- `file` (file, optional) – File: The image to read. Either file or fileUrl.
- `fileUrl` (string, optional) – File URL: Public URL of the image. Either file or fileUrl.
- `outputFormat` (enum, optional, one of `markdown`, `text`, default `markdown`) – Output format: markdown (default) keeps headings and tables; text is plain text.
- `tableFormat` (enum, optional, one of `inline`, `markdown`, `html`, default `inline`) – Table format: inline (default): tables as Markdown in the text; markdown or html: tables separately in pages[].tables.
- `extractHeaderFooter` (boolean, optional, default `false`) – Separate header and footer: Return page headers and footers separately instead of in the text.
- `extractImages` (enum, optional, one of `urls`, `none`, `base64`, default `urls`) – Embedded images: urls (default): photos and figures as download links (48 h) in the text and in pages[].images; base64: inline; none: left out.
- `describeImages` (boolean, optional, default `false`) – Describe images: Adds a short description of every image, chart and figure. Costs 18 instead of 6 credits per page.

## Example: OCR Image

```bash
curl -X POST 'https://api.1001fx.com/images/ocrimage' \
  -H 'X-API-KEY: YOURSECRETAPIKEY'
```