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

PAPYR 的 API

與網站相同的工具，從您的程式碼呼叫：透過 HTTP 送出檔案，取回結果。不儲存：處理完即刪除，一如既往。

刻意採取封閉測試

API 依設計逐步開放：每個帳戶有自己的金鑰（可輪替、可撤銷）、速率限制、每月配額與輸入限制。Pro 方案已內含；想試用或需要大量使用，寫信給我們，我們為您開通。

驗證

每個請求都在標頭中攜帶您的金鑰。金鑰只在建立時顯示一次；請存放在密鑰管理工具中。您可以隨時撤銷。

Authorization: Bearer papyr_sk_…

一分鐘上手

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();

端點（v1）

GET	`/api/v1/me`	驗證您的金鑰；回傳方案、用量與限制。
POST	`/api/v1/convert/to-pdf`	Office → PDF — file
POST	`/api/v1/img/compress`	壓縮圖片 — file + quality
POST	`/api/v1/img/convert`	轉換圖片 — file + fmt, quality
POST	`/api/v1/pdf/compress`	壓縮 — file
POST	`/api/v1/pdf/merge`	合併 — files[]
POST	`/api/v1/pdf/ocr`	OCR 文字辨識 — file + lang
POST	`/api/v1/pdf/page-numbers`	頁碼 — file + position, start
POST	`/api/v1/pdf/protect`	保護 — file + password
POST	`/api/v1/pdf/rotate`	旋轉 — file + degrees
POST	`/api/v1/pdf/split`	分割 — file + cada
POST	`/api/v1/pdf/to-csv`	PDF → CSV — file + sep
POST	`/api/v1/pdf/to-images`	PDF → 圖片 — file + dpi, fmt
POST	`/api/v1/pdf/to-text`	PDF → 純文字 — file
POST	`/api/v1/pdf/to-word`	PDF → Word — file + lang
POST	`/api/v1/pdf/unlock`	解除密碼 — file + password
POST	`/api/v1/pdf/watermark`	浮水印 — file + text

限制——清楚明白，且寫在回應裡

突發：每分鐘 20 次請求 · 持續：每把金鑰每小時 300 次。
每月配額依方案計（Pro：每月 1,000 次呼叫）。每個回應都包含 X-Monthly-Used 與 X-Monthly-Limit。
檔案最大 50 MB。內容限制與網站相同。
誠實的錯誤碼：401 金鑰無效 · 403 無方案 · 413 檔案過大 · 429 達到限制（附 Retry-After）。

您的資料，一如既往

僅為您的這次操作在歐盟伺服器上處理，並隨回應一併丟棄。API 不會放寬網站隱私政策的任何一條。