PAIM PAPYR ES · EN · FR · DE · IT · PT · 繁中

A API do PAPYR

As mesmas ferramentas do site, a partir do teu código: envia um ficheiro por HTTP e recebe o resultado. Sem armazenamento: processamos e apagamos, como sempre.

Beta fechada, de propósito

A API abre gradualmente, por desenho: chaves por conta (rotativas e revogáveis), limite de rajada, quota mensal e limites de entrada. Está incluída no plano Pro; para experimentar ou para volume, escreve-nos e damos-te acesso.

Pedir acesso

Autenticação

Cada pedido leva a tua chave num cabeçalho. A chave mostra-se uma única vez ao criar; guarda-a num gestor de segredos. Podes revogá-la a qualquer momento.

Authorization: Bearer papyr_sk_…

Começar num minuto

curl -X POST https://www.aim-papyr.ai/api/v1/pdf/merge \
  -H "Authorization: Bearer papyr_sk_YOUR_KEY" \
  -F "files=@report.pdf" -F "files=@annex.pdf" \
  -o merged.pdf

Scan to searchable PDF bash

curl -X POST https://www.aim-papyr.ai/api/v1/pdf/ocr \
  -H "Authorization: Bearer YOUR_KEY" \
  -F "file=@factura.pdf" -F "lang=spa" \
  -o factura-buscable.pdf

Extract tables to CSV python

import requests

r = requests.post(
    "https://www.aim-papyr.ai/api/v1/pdf/to-csv",
    headers={"Authorization": "Bearer YOUR_KEY"},
    files={"file": open("facturas.pdf", "rb")},
    data={"sep": ";"}, timeout=120)
r.raise_for_status()
open("facturas.csv", "wb").write(r.content)
print(r.headers["X-Monthly-Used"], "/", r.headers["X-Monthly-Limit"])

PDF to Word from the browser javascript

const fd = new FormData();
fd.append("file", archivo);        // File o Blob

const r = await fetch("https://www.aim-papyr.ai/api/v1/pdf/to-word", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_KEY" },
  body: fd,
});
if (!r.ok) throw new Error((await r.json()).detail);
const docx = await r.blob();

Endpoints (v1)

GET	`/api/v1/me`	Valida a tua chave; devolve plano, uso e limites.
POST	`/api/v1/convert/to-pdf`	Office → PDF — file
POST	`/api/v1/img/compress`	Comprimir imagem — file + quality
POST	`/api/v1/img/convert`	Converter imagem — file + fmt, quality
POST	`/api/v1/pdf/compress`	Comprimir — file
POST	`/api/v1/pdf/merge`	Juntar — files[]
POST	`/api/v1/pdf/ocr`	OCR — file + lang
POST	`/api/v1/pdf/page-numbers`	Números de página — file + position, start
POST	`/api/v1/pdf/protect`	Proteger — file + password
POST	`/api/v1/pdf/rotate`	Rodar — file + degrees
POST	`/api/v1/pdf/split`	Dividir — file + cada
POST	`/api/v1/pdf/to-csv`	PDF → CSV — file + sep
POST	`/api/v1/pdf/to-images`	PDF → imagens — file + dpi, fmt
POST	`/api/v1/pdf/to-text`	PDF → Texto — file
POST	`/api/v1/pdf/to-word`	PDF → Word — file + lang
POST	`/api/v1/pdf/unlock`	Desbloquear — file + password
POST	`/api/v1/pdf/watermark`	Marca de água — file + text

Limites — claros, e na resposta

Rajada: 20 pedidos/minuto · sustentado: 300/hora por chave.
Quota mensal por conta segundo o plano (Pro: 1.000 chamadas/mês). Cada resposta inclui X-Monthly-Used e X-Monthly-Limit.
Ficheiros até 50 MB. Os mesmos limites de conteúdo do site.
Erros honestos: 401 chave inválida · 403 sem plano · 413 ficheiro grande · 429 limite atingido (com Retry-After).

Os teus dados, como sempre

Processados em servidores da UE apenas para a tua operação e descartados com a resposta. A API não alivia nada da política de privacidade do site.