PAIM PAPYR ES, EN, FR, DE, IT, PT, 繁中, NL, PL, CA, EU, GL, SV, DA, NB, FI, CS, SK, RO, HU, EL, TR, JA, KO

PAPYRのAPI

サイトと同じツールを、自社のコードから。HTTPでファイルを送り、結果を受け取ります。保存はしません。これまでどおり、処理して削除します。

クローズドベータ、意図的に

APIは意図的に段階を追って公開しています。アカウントごとのキー（ローテーション・失効が可能）、バースト上限、月間の利用枠、入力の上限を設けています。APIはProプランに含まれます。試してみたい場合や大量処理が必要な場合は、メールでご連絡ください。アクセスをご用意します。

アクセスを申請

認証

各リクエストのヘッダーにキーを含めます。キーは作成時に一度だけ表示されるので、シークレットマネージャーに保管してください。いつでも失効させることができます。

Authorization: Bearer papyr_sk_…

1分で始める

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付き）。

データの扱いは、これまでどおり

EU域内のサーバーで、依頼された処理のためだけに処理し、応答の送信後に削除します。APIだからといって、サイトのプライバシーポリシーが緩むことは一切ありません。