Zum Hauptinhalt springen
Renamed.to logorenamed.to
PDF Split API

Teilen Sie PDFs mit Anweisungen in natürlicher Sprache

Sagen Sie der KI in einfachem Englisch, wie sie teilen soll. Sie liest den Dokumentinhalt, erkennt Grenzen und benennt jede Datei - Dinge, die seitenbasierte Splitter nie leisten konnten.

  • KI-gestützte Grenzerkennung - mit benutzerdefinierten Anweisungen
  • 3 Teilungsmodi - smart, feste Intervalle, Lesezeichen
  • Stapelverarbeitung - mehrere PDFs in einer Anfrage
  • Automatische Benennung - aufgeteilte Dateien nach Inhalt benannt

Sie müssen nur ein paar Dateien aufteilen? Kostenloses Web-Tool verwenden

Ihre Anweisung: "Trenne, wenn du eine neue Rechnungskopfzeile oder 'Seite 1 von X' siehst. Die Dokumente jedes Lieferanten sollten getrennt sein."

Eingabe

mixed_invoices_q4.pdf47 Seiten

PDF enthält: 12 Rechnungen von 5 Anbietern, gemischte Daten, unterschiedliche Seitenzahlen

KI-Ausgabe

2025-01-15_AcmeCorp_Invoice_001.pdf3 Seiten

reason: "Neue Rechnung erkannt - Acme Corp-Kopfzeile"

2025-01-14_GlobeTech_Invoice_002.pdf2 Seiten

reason: "Neuer Anbieter-Briefkopf - GlobeTech Inc"

...und 10 weitere Dokumente

Warum KI-Aufteilung seitenbasierte Tools übertrifft

Seitenbasierte Splitter zählen Seiten. KI liest Inhalte und versteht Grenzen.

Seitenbasierte / manuelle Aufteilung

Eingabe:

mixed_invoices.pdf (47 pages)

Aufteilen alle:

5 Seiten

Ausgabe:

split_1.pdf, split_2.pdf, ... (falsche Grenzen)

  • Kann nicht erkennen, wo Dokumente tatsächlich beginnen/enden
  • Schneidet Rechnungen entzwei, mischt Anbieter
  • Generische Dateinamen (split_1, split_2...)
  • Kann Dokumentinhalt nicht verstehen
KI mit benutzerdefinierten Anweisungen

Eingabe:

mixed_invoices.pdf (47 pages)

Anweisung:

"Trenne, wenn du eine neue Rechnungskopfzeile oder ein neues Firmenbriefpapier siehst"

Ausgabe:

2025-01-15_AcmeCorp_Invoice_001.pdf (3 pages)

  • Erkennt tatsächliche Dokumentgrenzen aus dem Inhalt
  • Folgt Ihren Anweisungen in natürlicher Sprache
  • Benennt Dateien automatisch anhand extrahierter Inhalte
  • Erklärt, warum jede Aufteilung vorgenommen wurde

Schnellstart

Zwei Endpunkte: Laden Sie eine Datei direkt hoch oder übergeben Sie eine URL und wir rufen sie ab. Verwenden Sie mode=smart with instructions , um der KI mitzuteilen, wie sie Grenzen erkennen soll.

POST /api/v1/pdf-split - Multipart-Datei-Upload

Shell
curl -X POST https://www.renamed.to/api/v1/pdf-split \  -H "Authorization: Bearer YOUR_API_TOKEN" \  -F "file=@mixed_documents.pdf" \  -F "mode=smart" \  -F 'instructions=Split when you detect a new document.Look for: invoice headers, "Page 1 of X", or new letterhead.Keep cover letters with their attachments.'

POST /api/v1/pdf-split/from-url - JSON-Body, Server ruft die Datei ab

Shell
curl -X POST https://www.renamed.to/api/v1/pdf-split/from-url \  -H "Authorization: Bearer YOUR_API_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "url": "https://example.com/scanned-stack.pdf",    "mode": "smart",    "instructions": "Separate by patient name.\nEach patient'"'"'s records should be one file.\nInclude all pages until you see a new patient header."  }'

SDKs

Verwenden Sie unsere offiziellen SDKs für eine bessere Developer Experience mit Type Safety und Fehlerbehandlung.

TypeScript-SDK

TypeScript
import { RenamedClient } from '@renamed/sdk'const client = new RenamedClient({ apiKey: process.env.RENAMED_API_KEY })// AI reads the bundle, detects boundaries, names each splitconst job = await client.pdfSplit('./mixed_invoices.pdf', {  mode: 'smart',  instructions: `Split when you detect a new invoice.Look for: company letterhead, "Invoice #", or "Page 1 of X".Each vendor's invoice should be separate.`})// Poll for completionconst result = await job.waitForCompletion()console.log(result.splits)// => [{ filename: "2025-01-15_AcmeCorp_Invoice_001.pdf", reason: "New invoice detected - Acme Corp header" }, ...]

Antwort

JSON
{  "jobId": "abc123",  "status": "completed",  "progress": 100,  "results": {    "results": [{      "originalFilename": "mixed_documents.pdf",      "splits": [{        "filename": "2025-01-15_AcmeCorp_Invoice_001.pdf",        "downloadUrl": "https://...",        "expiresAt": "2025-01-16T12:00:00Z",        "pages": 3,        "reason": "New invoice detected - Acme Corp header"      },      {        "filename": "2025-01-14_GlobeTech_Invoice_002.pdf",        "downloadUrl": "https://...",        "expiresAt": "2025-01-16T12:00:00Z",        "pages": 2,        "reason": "New vendor letterhead - GlobeTech Inc"      }]    }]  },  "creditsUsed": 2}

SDKs auf GitHub: github.com/renamed-to/renamed-sdk

Authentifizierung

Alle API-Anfragen erfordern Authentifizierung über einen Bearer-Token im Authorization -Header.

API-Token (empfohlen)

Erzeugen Sie API-Token unter Einstellungen → API-Token. Token haben das Präfix rt_ und gewähren vollen Zugriff auf Ihr Konto.

Authorization: Bearer rt_abc123def456...

OAuth 2.0

Für Apps, die sich im Namen von Nutzern authentifizieren, verwenden Sie OAuth 2.0. Nach Abschluss des OAuth-Flows erhalten Sie ein Access Token, das auf dieselbe Weise funktioniert:

Authorization: Bearer <oauth_access_token>

Siehe API-Dokumentation für Details zur OAuth-Client-Registrierung und zum Flow.

API-Parameter

Wichtige Parameter zur Steuerung des Aufteilungsverhaltens.

ParameterTypErforderlichWerte / Hinweise
fileFileJa*Upload einer einzelnen Datei. *Mindestens eines von file oder files[] erforderlich.
files[]File[]Ja*Mehrere Dateien für die Stapelverarbeitung.
modestringNeinStandard: smart.Werte: smart | every-n-pages | by-bookmarks
instructionsstringNeinNur für den smart -Modus. Anweisungen in natürlicher Sprache zur Grenzerkennung. Max. 5,000 Zeichen.
pagesPerSplitintegerJa, wenn mode=every-n-pagesAnzahl der Seiten pro Aufteilung. Bereich: 1-1000.

URL-Endpunkt (/api/v1/pdf-split/from-url)

Gleiche Parameter wie oben, aber statt file/files[]verwenden Sie url (string) oder urls (string[]).

Was Ihre Anweisungen leisten können

Die KI interpretiert natürliche Sprache und wendet komplexe Grenzerkennung an, für die Sie sonst eigenen Code schreiben müssten.

Grenzerkennung
"Split when you see 'Page 1 of X' or a new company letterhead"
Dokumentgruppierung
"Keep cover letters with their attachments. Don't split appendices from main documents."
Entitätsbasierte Aufteilung
"Separate by patient name - each patient's records should be one file"
Kopfzeilenerkennung
"Each PURCHASE ORDER starts a new document. Invoice headers also indicate new documents."

Teilungsmodi

Wählen Sie den Modus, der zu Ihrem Anwendungsfall passt. Smart-Modus ist der Standard.

smartStandard

Die KI erkennt Dokumentgrenzen automatisch. Optional können Sie instructions angeben, um die Grenzerkennung zu steuern.

every-n-pages

Teilt in festen Intervallen. Erfordert den Parameter pagesPerSplit (1-1000).

by-bookmarks

Teilt an PDF-Lesezeichengrenzen. Erfordert, dass die Quelldatei PDF Lesezeichen hat.

Für den Produktionseinsatz entwickelt

Grenzen

  • Dateigröße: max. 100 MB
  • Formate: Nur PDF
  • Anweisungen: 5,000 Zeichen max
  • Seiten pro Aufteilung: 1-1,000 (für every-n-pages-Modus)
  • Verarbeitung: 30s-2min typisch

Häufige Fehler

  • 400 no_files Keine Dateien bereitgestellt
  • 400 invalid_file_type Keine PDF
  • 400 file_too_large Überschreitet 100MB
  • 401 unauthorized Fehlender oder ungültiger API-Schlüssel
  • 402 insufficient_credits Nicht genug Credits
  • 404 not_found Job nicht gefunden

Sicherheit: Alle Anfragen über TLS. Der Endpunkt /from-url blockiert localhost und private IP-Bereiche.

Preise

1 Credit pro 3 Seiten (aufgerundet). Dann $9 pro 1,000 Credits.

  • 50 kostenlose Credits bei der Registrierung
  • Credits 12 Monate gültig
  • 30 Tage Geld-zurück-Garantie
Preisdetails ansehen

Erste Schritte

Vier Schritte, um die PDF Split API in Ihren Workflow zu integrieren.

1

Holen Sie sich Ihren API-Token

Erzeugen Sie einen API-Token in Ihrem Dashboard. Sie erhalten 50 kostenlose Credits bei der Registrierung.

2

PDF hochladen oder URL angeben

Senden Sie an /api/v1/pdf-split (Datei-Upload) oder /api/v1/pdf-split/from-url (URL). Fügen Sie Ihre instructions für den Smart-Modus hinzu.

3

Status-Endpunkt abfragen

Die erste Antwort enthält eine statusUrl. Fragen Sie /api/v1/pdf-split/status/{jobId} ab, bis status=completed.

4

Aufgeteilte Dateien herunterladen

Jede Aufteilung enthält eine downloadUrl. URLs laufen nach 24 Stunden ab. Das Feld reason erklärt, warum jede Grenze erkannt wurde.

FAQ

Wie funktioniert die KI-Grenzerkennung?
Im „Smart“-Modus analysiert die KI den Dokumentinhalt, um zu erkennen, wo ein Dokument endet und ein anderes beginnt. Sie erkennt Änderungen in Briefköpfen, Dokumenttypen, Anbietern, Mustern wie „Page 1 of X“ und strukturellen Elementen. Sie können sie mit Anweisungen in natürlicher Sprache steuern.
Was kann ich im instructions-Parameter angeben?
Natürliche Sprache, die beschreibt, wie Grenzen erkannt werden sollen. Beispiele: „Split when you see a new invoice header or Page 1 of X“, „Each document starts with a cover letter followed by attachments“, „Separate by patient name - each patient's records should be one file“.
Wie lange dauert die Verarbeitung?
Die meisten Jobs sind in 30 Sekunden bis 2 Minuten abgeschlossen, abhängig von Dateigröße und Seitenanzahl. Die API ist asynchron - Sie senden einen Job und fragen den Abschlussstatus ab.
Wie groß darf eine Datei maximal sein?
PDF-Dateien bis zu 100MB. Es gibt kein festes Seitenlimit, aber sehr große Dokumente können länger für die Verarbeitung benötigen.
Wie werden aufgeteilte Dateien benannt?
Im Smart-Modus erzeugt die KI beschreibende Dateinamen auf Basis des Dokumentinhalts - sie extrahiert Daten, Anbieter, Dokumenttypen und andere Entitäten. Jede Aufteilung enthält außerdem ein Feld „reason“, das erklärt, warum die Grenze erkannt wurde.
Worin unterscheidet sich das von herkömmlichen PDF-Splittern?
Herkömmliche Splitter arbeiten mit Seitenzahlen oder Lesezeichen. Diese API liest den Dokumentinhalt, versteht die Bedeutung und wendet Ihre Anweisungen in natürlicher Sprache an. Sie kann nach Anbieter, Patient, Dokumenttyp oder jeder semantischen Grenze teilen - Dinge, die mit seitenbasierten Tools unmöglich sind.