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

# OCR pelo AI Gateway

> Extraia texto e estrutura de PDFs, imagens, recibos e faturas com o endpoint de OCR do AI Gateway, que retorna saída em markdown por página.

Consulte [URLs e autenticação HTTP](/docs/pt-BR/reference/base-urls.md) e a referência da API para os formatos completos de solicitação e resposta.

**Casos de uso**

* Extrair texto e layout de PDFs e imagens digitalizados.
* Digitalizar recibos, faturas e formulários em markdown estruturado.
* Pré-processar documentos para pipelines posteriores de RAG ou de análise.
* Transformar arquivos enviados em conteúdo pesquisável e legível por máquina.

***

## Visão geral

Use **`POST /v3/router/ocr`** no **AI Gateway** para executar OCR em um documento ou imagem. O endpoint retorna markdown por página que preserva a estrutura e a hierarquia do documento, junto com as imagens extraídas.

> [!NOTE]
>
> Para ver o esquema completo de requisição e resposta, consulte a referência da API [Create OCR](/docs/pt-BR/reference/ocr/create-ocr.md).

## Início rápido

Envie a URL de um documento ou de uma imagem e especifique o modelo de OCR a ser usado.

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST "https://router.toqan.ai/eu/v3/router/ocr" \
  -H "Authorization: Bearer $TOQAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mistral/mistral-ocr-4-0",
    "document": {
      "type": "document_url",
      "document_url": "https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf",
      "document_name": "dummy.pdf"
    }
  }'
```

## Tipos de entrada

O campo `document` aceita a URL de um documento ou a URL de uma imagem.

| Tipo | Campo | Descrição |
| - | - | - |
| `document_url` | `document_url` | URL do documento (por exemplo, PDF) a ser processado. `document_name` é opcional. |
| `image_url` | `image_url` | Dados de imagem codificados em base64, ou um objeto com uma `url` e um campo `detail` opcional. |

## Opções

Campos adicionais controlam quais páginas são processadas e como as imagens são retornadas.

| Campo | Descrição |
| - | - |
| `pages` | Array de índices de página, a partir de 0, a serem processados. Omita ou passe `null` para todas as páginas. |
| `ocr_settings.include_image_base64` | Retorna as imagens extraídas inline como base64 na resposta. |
| `ocr_settings.max_images_to_include` | Número máximo de imagens a incluir por página. |
| `ocr_settings.image_min_size` | Altura e largura mínimas (em pixels) para que uma imagem seja incluída. |

## Resposta

Cada resposta inclui o modelo usado, um array de páginas com o `markdown` e as `images` extraídos e um objeto `usage` que contabiliza as páginas ou os tokens processados. Consulte a referência [Create OCR](/docs/pt-BR/reference/ocr/create-ocr.md) para ver o esquema completo.

## Modelos compatíveis

Para ver a lista atual de modelos de OCR, consulte [Modelos de OCR](/docs/pt-BR/ai-gateway/supported-models.md#ocr-models) na página Modelos compatíveis.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.