PDF Tools

Endireitar PDF

Detecta e corrige automaticamente páginas PDF inclinadas. Preserva as páginas de texto como conteúdo vetorial pesquisável e rasteriza apenas as páginas de imagem (ex. digitalizações).

file· Resultado de arquivoAbrir ferramenta

Início rápido

Chame esta ferramenta a partir do seu código em três idiomas.

cURL

# 1) Request a presigned URL → returns { uploadUrl, storageKey }
curl -X POST 'https://api.elysiatools.com/api/upload/presign/pdf-deskew' \
  -H 'Content-Type: application/json' \
  -d '{"filename":"sourceFile.ext","contentType":"application/octet-stream","size":12345}'

# 2) PUT the file bytes directly to the presigned uploadUrl
curl -X PUT '<presigned uploadUrl>' \
  --data-binary @/path/to/file.ext

# 3) Call the tool, passing the returned storageKey for each file field
curl -X POST 'https://api.elysiatools.com/pt/api/tools/pdf-deskew' \
  -F 'sourceFile=/public/samples/pdf/sample-multipage.pdf' \
  -F 'mode=auto' \
  -F 'manualAngle=0' \
  -F 'threshold=0.5' \
  -F 'rasterizeText=false' \
  -F 'pageRange='

Referência da API

Envie uma requisição POST com suas entradas em JSON. Parâmetros do tipo arquivo exigem upload prévio.

Endpoint

HTTP

POST https://api.elysiatools.com/pt/api/tools/pdf-deskew

Parâmetros

Nome	Tipo	Obrigatório	Descrição
sourceFile	fileupload necessário	Sim	—
mode	select	Sim	—
manualAngle	number	Não	Ângulo de correção manual (graus). Valor positivo corrige inclinação horária. Usado apenas no modo manual.
threshold	number	Não	Ângulo mínimo de inclinação detectado (em graus) necessário para aplicar correção no modo automático. Valores menores detectam inclinações sutis.
rasterizeText	select	Não	Por padrão, as páginas de texto são preservadas como conteúdo vetorial pesquisável (não endireitadas). Ative apenas se precisar endireitar o conteúdo de texto vetorial, aceitando a perda da capacidade de seleção de texto.
pageRange	text	Não	Especifique as páginas para endireitar (ex. 1-3,5,7-9). Deixe em branco para todas.

Parâmetros do tipo arquivo devem ser enviados primeiro via POST /upload/pdf-deskew; o filePath retornado é então passado ao campo correspondente.

Formato de resposta

Resultado de arquivo

JSON

{
  "filePath": "/public/processing/randomid.ext",
  "fileName": "output.ext",
  "contentType": "application/octet-stream",
  "size": 1024,
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}

Integração MCP

Adicione esta ferramenta ao seu servidor Model Context Protocol para que agentes de IA possam listá-la e chamá-la.

Configuração do servidor

Adicione este bloco à configuração do seu cliente MCP:

mcp.json

{
  "mcpServers": {
    "elysiatools-pdf-deskew": {
      "name": "pdf-deskew",
      "description": "Detecta e corrige automaticamente páginas PDF inclinadas. Preserva as páginas de texto como conteúdo vetorial pesquisável e rasteriza apenas as páginas de imagem (ex. digitalizações).",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=pdf-deskew",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Listar ferramentas disponíveis

Após conectar ao endpoint SSE, liste as ferramentas expostas:

tools/list

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

Chamar esta ferramenta

Invoque a ferramenta pelo seu id; os argumentos são construídos a partir de seus parâmetros:

tools/call

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "pdf-deskew",
    "arguments": {
  "sourceFile": "/public/samples/pdf/sample-multipage.pdf",
  "mode": "auto",
  "manualAngle": 0,
  "threshold": 0.5,
  "rasterizeText": "false",
  "pageRange": ""
}
  }
}

Encadeie várias ferramentas em uma sessão com uma lista toolId separada por vírgulas, p. ex. /mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp (máx. 20).

Parâmetros de arquivo aceitam somente uma URL de arquivo pública (https://…). Caminhos locais, data: URI e strings Base64 não são suportados.

Dúvidas ou problemas? Contate [email protected]