Zum Inhalt springen

Funktion

PDFs ausfüllen, schwärzen, teilen und verkleinern

Nicht jedes Dokument beginnt als Vorlage. Formfeed arbeitet auch mit den PDFs, die Sie schon haben: Es füllt ein Formular über die Namen seiner Felder, entfernt Namen und Kontonummern aus der Datei selbst und prüft, dass sie weg sind, teilt ein PDF in Teile, macht es kleiner, ohne etwas zu verlieren, und zeichnet seine Seiten als Bilder. Jedes Tool nimmt ein hochgeladenes PDF, das verarbeitet und nicht aufbewahrt wird, oder ein in Formfeed gespeichertes, und antwortet wie ein Rendering, mit einem Link zum Ergebnis.

Kostenloser Plan mit 100 Einheiten im Monat, keine Kreditkarte

Schwärzen, das entfernt und dann prüft

POST /v1/pdf/redact nimmt die zu entfernenden Texte, auf jeder Seite gefunden, gleich mit welchen Leerzeichen, und Rechtecke der Seite, wie ein Viewer sie zeigt. Was dort steht, wird aus der Datei genommen, nicht übermalt: der Text, die Pixel eines Bildes unter einem Rechteck, ein Link oder Kommentar, den es berührt. Danach wird das Ergebnis erneut gelesen, mit Metadaten, Lesezeichen, Anhängen und Formular, und solange sich ein Text noch finden lässt, scheitert der Aufruf mit 422 redaction_incomplete und liefert nichts (was geprüft wird).

  • Gefunden, gleich mit welchen Leerzeichen. Eine IBAN in Vierergruppen wird über ihre Zeichen ohne Abstände gefunden. Buchstaben werden nach Unicode-Normalisierung verglichen und, sofern match_case nicht gesetzt ist, ohne Rücksicht auf Groß- und Kleinschreibung; mit whole_words wird ein Text nur als ganzes Wort gefunden.
  • Rechtecke in Punkten. x und y von der oberen linken Ecke der Seite, wie ein Viewer sie zeigt, ihre Drehung eingerechnet. 72 Punkte sind ein Zoll.
  • Ein Kasten, eine andere Farbe oder keiner. Über jede entfernte Stelle kommt ein schwarzer Kasten; fill nennt eine andere Farbe, und null lässt die Stelle leer.
  • Nie gespeichert. Die Texte, die Sie nennen, werden weder gespeichert noch protokolliert.
Der Anfang des Arbeitszeugnisses aus den Beispielen, mit dem Namen und dem Geburtsdatum der Mitarbeiterin
Vorher: der Anfang des Arbeitszeugnisses aus den Beispielen.
Derselbe Anfang ohne den Namen und das Geburtsdatum der Mitarbeiterin
Nachher: „Frau Erika Mustermann“, „Frau Mustermann“, „12. April 1990“ entfernt, wo immer sie standen.
TerminalShell
curl https://api.formfeed.dev/v1/pdf/redact \
  -H "Authorization: Bearer $FORMFEED_API_KEY" \
  -F file=@arbeitszeugnis.pdf \
  -F 'text=["Frau Erika Mustermann","Frau Mustermann","12. April 1990"]'

Ein Formular über die Namen seiner Felder ausfüllen

POST /v1/pdf/info listet die Felder eines Formulars mit vollem Namen, Beschriftung, Typ und Optionen, kostenlos in jedem Plan: hier applicant.name, ein Feld vom Typ text mit der Beschriftung „Vor- und Nachname“, und membership, eine Optionsgruppe aus basic, plus, team. POST /v1/pdf/fill nimmt Werte unter diesen Namen: Text, true oder false für ein Kontrollkästchen, eine Option einer Auswahl oder Optionsgruppe. Das Formular bleibt ausfüllbar, oder mit flatten werden die Werte in die Seiten gezeichnet und die Felder entfernt (fill).

  • Streng oder nachsichtig. Ein Name, den das Formular nicht hat, oder ein Wert, den sein Feld nicht nimmt, scheitert mit 422 und nennt das Feld, nie den Wert. Mit strict: false wird beides ausgelassen und im form.skipped des Renderings aufgelistet.
  • Was ein Viewer ausführen würde. Keine Berechnung und kein Anzeigeformat des Formulars läuft; form.warnings des Renderings nennt die Felder, die eines haben.
  • Formulare, die sich nicht füllen lassen. Ein Formular, das ein Passwort braucht, ein signiertes Formular und ein Formular, das nur XFA-Viewer füllen, werden abgelehnt, jedes mit eigenem Code; ein hybrides Formular wird über sein AcroForm gefüllt und sein XFA-Teil entfernt.
  • Nie gespeichert. Die Werte werden weder gespeichert noch protokolliert; das Rendering behält die Namen der Felder, die es gefüllt hat.
Ein leerer Mitgliedsantrag mit neun Feldern
Vorher: ein Formular, wie ein Büro es verschickt, mit 9 Feldern.
Derselbe Antrag ausgefüllt: Name, Anschrift, eine Option, ein Datum aus einer Liste und ein angekreuztes Kästchen
Nachher: über die Namen ausgefüllt und in die Seite gezeichnet.
TerminalShell
curl https://api.formfeed.dev/v1/pdf/fill \
  -H "Authorization: Bearer $FORMFEED_API_KEY" \
  -F file=@mitgliedsantrag.pdf \
  -F 'fields={
    "applicant.name": "Erika Mustermann",
    "membership": "plus",
    "start": "1. Februar 2027",
    "newsletter": true
  }' \
  -F flatten=true

In Teile teilen

POST /v1/pdf/split teilt ein PDF alle N Seiten oder in einen Teil je Seitenauswahl wie 1-3,5 oder 4- für Seite 4 bis zur letzten und antwortet mit einem ZIP der Teile, benannt nach der Quelle: report.zip enthält report-1.pdf und report-2.pdf. Ergibt das Teilen nur einen Teil, kommt dieses PDF zurück. Ein PDF/A wird abgelehnt, weil seine Teile einen Anspruch trügen, den niemand geprüft hat (split).

Die erste Seite von report-1.pdf
report-1.pdf, 1 Seite.
Die erste Seite von report-2.pdf
report-2.pdf, 1 Seite.
TerminalShell
curl https://api.formfeed.dev/v1/pdf/split \
  -H "Authorization: Bearer $FORMFEED_API_KEY" \
  -F file=@report.pdf \
  -F every=1

Seiten als Bilder

POST /v1/pdf/to-image zeichnet Seiten als PNG oder JPEG mit 36 bis 300 dpi, 150, wenn Sie keine nennen: Eine Seite kommt als das Bild zurück, mehrere als ZIP, benannt nach der Seite. Ein Aufruf zeichnet bis zu 100 Seiten, und jedes Bild kostet eine Einheit, wie ein Bild-Rendering (to-image).

Die erste Seite der Beispielrechnung als Bild
invoice-1.png: 1242 × 1756 Pixel bei 150 dpi, 131 kB.
TerminalShell
curl https://api.formfeed.dev/v1/pdf/to-image \
  -H "Authorization: Bearer $FORMFEED_API_KEY" \
  -F file=@invoice.pdf \
  -F pages=1 \
  -F dpi=150

Kleiner, ohne etwas zu verlieren

POST /v1/pdf/compress schreibt ein PDF neu, ohne zu ändern, was es zeigt: Objekte in komprimierte Streams gepackt, gleiche Streams einmal gespeichert, Bilder verlustfrei neu komprimiert und Schriften auf die Zeichen gekürzt, die das Dokument nutzt. Die Bildqualität sinkt nie, und eine Datei, die das Neuschreiben nicht kleiner macht, kommt zurück, wie sie war. Fünf Beispiele dieser Website, gemessen am 18. November 2026, wurden 15 bis 42 % kleiner (compress):

BeispielVorherNachherGespart
price-list.pdf272 kB225 kB17 %
nda.pdf147 kB124 kB15 %
us-invoice.pdf141 kB81 kB42 %
mahnung.pdf114 kB70 kB38 %
invoice.pdf90 kB60 kB33 %
TerminalShell
curl https://api.formfeed.dev/v1/pdf/compress \
  -H "Authorization: Bearer $FORMFEED_API_KEY" \
  -F file=@price-list.pdf

Ein hochgeladenes PDF oder ein in Formfeed gespeichertes

Jedes Tool nimmt das PDF als multipart/form-data mit der Datei als file, bis zur Ausgabegröße Ihres Plans und höchstens 100 MB, verarbeitet und nicht aufbewahrt; oder als JSON, das ein gespeichertes PDF in source nennt: die ID eines Renderings, etwa der Rechnung, die Ihre Vorlage gerade erzeugt hat, oder ein PDF der Dateibibliothek über seinen Namen. Das Ergebnis ist ein Rendering wie jedes andere, mit seinem Download-Link, aufbewahrt, solange Ihr Plan Dateien aufbewahrt (Quellen).

JSONJSON
POST /v1/pdf/split
{
  "source": "rnd_7da09ab6cd9946b798c187c2a9350852",
  "ranges": ["1", "2-"]
}

Anhängen, Wasserzeichen und Passwort im Rendering selbst

Der post-Block eines Renderings hängt weitere PDFs an das Dokument an, setzt ein Text- oder Bild-Wasserzeichen und verschlüsselt das Ergebnis mit AES-256, und dieselben drei laufen auf gespeicherten PDFs über /v1/pdf/merge, /v1/pdf/watermark und /v1/pdf/protect. Die Beispiele zeigen ein Entwurfs-Wasserzeichen und eine Gehaltsabrechnung mit Passwort.

Aus Code, von der Kommandozeile oder durch einen Agenten

  • SDKs. client.pdf.redact(), fill(), split(), compress(), toImage() und info() in TypeScript, dieselben in Python mit to_image().
  • Kommandozeile. npx formfeed pdf redact arbeitszeugnis.pdf --text "Frau Erika Mustermann", daneben fill, split, compress, to-image und info.
  • KI-Agenten. redact_pdf, fill_pdf_form, split_pdf, compress_pdf, pdf_to_image und get_pdf_info des MCP-Servers (KI-Agenten).
  • Workflows ohne Code. Schritte für die PDF-Tools in den No-Code-Apps, Plattform für Plattform (Integrationen).

Pläne und Einheiten

Die Tools gehören zum Starter-Plan und höher. Jedes kostet 0,5 Einheiten auf einem Live-Schlüssel, Seiten zeichnen eine Einheit je Bild, und /pdf/info ist in jedem Plan kostenlos (Preise).

FAQ

Ist geschwärzter Text wirklich weg?
Ja. Er wird aus der Datei genommen, nicht übermalt, und das Ergebnis wird vor der Lieferung erneut gelesen: Solange sich einer der Texte noch finden lässt, auf einer Seite, in den Metadaten, einem Lesezeichen, einem Anhang oder einem Formularfeld, scheitert der Aufruf, und es wird keine Datei geliefert.
Kann ich ein Formular füllen, das ich nie gesehen habe?
Fragen Sie zuerst /pdf/info: Es listet jedes Feld mit vollem Namen, Beschriftung, Typ und Optionen, und genau diese Namen nimmt /pdf/fill.
Werden hochgeladene Dateien aufbewahrt?
Nein. Ein Upload wird verarbeitet und nicht aufbewahrt; nur das Ergebnis wird gespeichert, wie jedes Rendering, so lange, wie Ihr Plan Dateien aufbewahrt.

Aus dem Blog

  • Ein PDF so schwärzen, dass der Text wirklich weg ist →

    Ein schwarzer Kasten über einem Namen verbirgt ihn vor dem Auge und vor niemandem sonst. Dreimal kam verdeckter Text öffentlich wieder zum Vorschein, was eine Schwärzung außer den Wörtern auf der Seite entfernen muss, und der eine Buchstabe, den unser eigenes Werkzeug stehen ließ, während wir das hier schrieben.

Weitere Funktionen

Heute mit dem Rendern beginnen

Der kostenlose Plan enthält 100 Einheiten im Monat und kostenlose Testrenderings. Wechseln Sie den Plan, wenn Sie mehr brauchen.