OCR pelo AI Gateway

Consulte URLs e autenticação HTTP 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.

Para ver o esquema completo de requisição e resposta, consulte a referência da API Create OCR.

Início rápido

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

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 para ver o esquema completo.

Modelos compatíveis

Para ver a lista atual de modelos de OCR, consulte Modelos de OCR na página Modelos compatíveis.

Toqan Router

Visão geral

APIs

MCP Portal

Roteamento

Segurança e privacidade

Recursos dos modelos

Ferramentas de servidor

Cenários comuns

Configuração de provedores

Visão geral

Início rápido

Tipos de entrada

Opções

Resposta

Modelos compatíveis

​Visão geral

​Início rápido

​Tipos de entrada

​Opções

​Resposta

​Modelos compatíveis

Visão geral

Início rápido

Tipos de entrada

Opções

Resposta

Modelos compatíveis