Zum Hauptinhalt springen
Renamed.to logorenamed.to
Renamer API

AI-Dokumentumbenennung mit benutzerdefinierten Anweisungen

Sagen Sie der AI in klarem Englisch, was Sie möchten. Sie liest Dokumentinhalte, versteht die Bedeutung und wendet Ihre Logik an - Dinge, die Regex nie leisten könnte.

  • Anweisungen in natürlicher Sprache - keine starren Muster
  • Semantische Extraktion - liest Lieferanten, Beträge und Daten aus dem Inhalt
  • Bedingte Logik - "wenn Betrag > $10k, Präfix HIGH-VALUE"
  • 20+ Sprachen - liest Deutsch, gibt englische Dateinamen aus

Müssen Sie nur ein paar Dateien umbenennen? Das kostenlose Web-Tool verwenden

Ihre Anweisung: "Lies das Dokument in jeder Sprache. Extrahiere Lieferant, Rechnungsnummer, Betrag. Wenn der Betrag > 10000 EUR ist, füge das Präfix HIGH-VALUE hinzu. Route zu Invoices/Vendor/Year, füge /priority hinzu, wenn als dringend markiert."

Eingabe

rechnung_scan_001.pdfDeutsche Rechnung

PDF mit folgendem Inhalt: "Mueller GmbH... Rechnungsnummer: INV-98234... Gesamtbetrag: 12.450,00 EUR... DRINGEND"

AI-Ausgabe

HIGH-VALUE_2025-01-15_Mueller-GmbH_INV-98234.pdf
Invoices/Mueller-GmbH/2025/priority/
HIGH-VALUE-Präfix (Betrag > 10k)/priority (DRINGEND = dringend)

Authentifizierung

Alle API-Anfragen erfordern Authentifizierung per Bearer-Token im Authorization Header.

API-Token (empfohlen)

Erstellen Sie API-Token unter Einstellungen → API-Token. Token beginnen mit rt_ und gewähren vollen Zugriff auf Ihr Konto.

Authorization: Bearer rt_abc123def456...

OAuth 2.0

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

Authorization: Bearer <oauth_access_token>

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

Warum AI-Anweisungen Regex überlegen sind

Regex transformiert Dateinamen. AI liest Dokumente und versteht Inhalte.

Regex / Musterabgleich

Eingabe:

scan_001.pdf

Muster:

s/scan_(\\d+)/document_$1/

Ausgabe:

document_001.pdf

  • Kann Dokumentinhalte nicht lesen
  • Kann Lieferant, Betrag und Datum nicht extrahieren
  • Kann keine bedingte Logik anwenden
  • Kann mehrere Sprachen nicht verstehen
AI mit benutzerdefinierten Anweisungen

Eingabe:

scan_001.pdf

(deutsche Rechnung, 12,450 EUR)

Anweisung:

"Lieferant + Betrag extrahieren, HIGH-VALUE voranstellen wenn >10k"

Ausgabe:

HIGH-VALUE_2025-01-15_Mueller-GmbH_INV-98234.pdf

  • Liest und versteht Dokumentinhalte
  • Extrahiert Entitäten: Lieferanten, Beträge, Daten, IDs
  • Wendet bedingte Logik aus natürlicher Sprache an
  • Funktioniert mit 20+ Sprachen, Ausgabe in Ihrer Wahl

Schnellstart

Zwei Endpunkte: Laden Sie eine Datei direkt hoch oder übergeben Sie eine URL und wir rufen sie ab. Verwenden Sie strategy=follow_custom_prompt mit customTemplate um der AI Ihre Anweisungen zu geben.

POST /api/v1/rename - Multipart-Datei-Upload

Shell
curl -X POST https://www.renamed.to/api/v1/rename \  -H "Authorization: Bearer YOUR_API_TOKEN" \  -F "file=@invoice.pdf" \  -F "strategy=follow_custom_prompt" \  -F "templateMode=custom" \  -F 'customTemplate=Extract vendor name and invoice number.If total amount exceeds $10,000, prefix with HIGH-VALUE_.Format: [prefix]YYYY-MM-DD_VendorName_INV-Number' \  -F "language=en"

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

Shell
curl -X POST https://www.renamed.to/api/v1/rename-from-url \  -H "Authorization: Bearer YOUR_API_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "url": "https://example.com/document.pdf",    "strategy": "follow_custom_prompt",    "templateMode": "custom",    "customTemplate": "Identify document type (contract/invoice/receipt).\nFor contracts include parties and effective date.\nFor invoices include vendor and amount.",    "language": "en"  }'

SDKs

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

TypeScript-SDK

TypeScript
import { RenamedClient } from '@renamed/sdk'const client = new RenamedClient({ apiKey: process.env.RENAMED_API_KEY })// AI reads the German invoice, understands it, creates English filenameconst result = await client.rename('./rechnung_001.pdf', {  strategy: 'follow_custom_prompt',  templateMode: 'custom',  customTemplate: `Read document in any language, output English filename.Extract: vendor, invoice number, total amount.If amount > 10000 EUR, prefix with HIGH-VALUE_`,  language: 'en'})console.log(result.suggestedFilename)// => "HIGH-VALUE_2025-01-15_Mueller-GmbH_INV-98234.pdf"console.log(result.folderPath)// => "Invoices/Mueller-GmbH/2025"

Antwort

JSON
{  "originalFilename": "rechnung_001.pdf",  "suggestedFilename": "HIGH-VALUE_2025-01-15_Mueller-GmbH_INV-98234.pdf",  "extractedInfo": {    "date": "2025-01-15",    "issuer": "Mueller GmbH",    "invoice_number": "INV-98234",    "document_type": "invoice"  },  "folderPath": "Invoices/Mueller-GmbH/2025",  "organizationStrategy": "follow_custom_prompt",  "templateUsed": "custom"}

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

API-Parameter

Wichtige Parameter zur Steuerung des Verhaltens der AI.

ParameterWerteBeschreibung
strategyfollow_custom_prompt
by_date, by_issuer, by_type
by_date_issuer, by_date_type
by_issuer_type, by_all, root
Verwenden Sie follow_custom_prompt für AI-Anweisungen über customTemplate
templateModeauto, predefined, customAuf custom setzen, wenn customTemplate verwendet wird
customTemplatestringAnweisungen in natürlicher Sprache für die AI
languageauto, source, en, de, fr, es
it, pt, pt-BR, nl, pl, sv
no, da, fi, cs, tr, zh-Hans
zh-Hant, ja, ko, ar, hi, id
Ausgabesprache des Dateinamens. auto erkennt, source verwendet die Dokumentsprache

Was Ihre Anweisungen leisten können

Die AI interpretiert natürliche Sprache und wendet komplexe Logik an, für die Sie sonst eigenen Code entwickeln müssten.

Benutzerdefinierte Extraktion + bedingte Logik
"Extract vendor name and invoice number. If total amount is over $10,000, prefix with HIGH-VALUE_. Format: [prefix]YYYY-MM-DD_VendorName_INV-Number"
Erkennung des Dokumenttyps
"Identify document type (contract, invoice, receipt, statement). For contracts, include parties and effective date. For invoices, include vendor and amount."
Intelligente Ordnerweiterleitung
Verwenden Sie vordefinierte Strategien wie by_date_issuer oder by_all um Dateien anhand extrahierter Daten in Ordnerhierarchien zu organisieren.
Mehrsprachiges Verständnis
"Read document in any language. Extract key info. Output filename in English."
Erkennung von Beziehungen
"If this appears to be a response or amendment to another document, include RE_ or AMD_ prefix and reference the original document number if mentioned"

Für den Produktionseinsatz entwickelt

Limits

  • Dateigröße: max. 25 MB
  • Formate: PDF, DOCX, DOC, XLSX, XLS, PPTX, JPG, PNG, TIFF
  • Rate Limit: 10,000/Tag pro Benutzer
  • Antwortzeit: typisch 3-10 Sekunden

Häufige Fehler

  • 401 Ungültiger oder fehlender API-Schlüssel
  • 402 Unzureichende Credits
  • 413 Datei zu groß (über 25MB)
  • 415 Nicht unterstützter Dateityp
  • 429 Rate Limit erreicht (prüfen Sie den Retry-After Header)

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

Preise

50 kostenlose Credits bei der Registrierung. Danach $9 pro 1,000 Dokumente ($0.009/Datei).

  • 1 Credit = 1 Umbenennung
  • Credits 12 Monate gültig
  • 30-Tage-Geld-zurück-Garantie
Preise im Detail ansehen

Erste Schritte

Drei Schritte, um die Renamer API in Ihren Workflow zu integrieren.

1

Im API Playground testen

Testen Sie Ihre Anweisungen interaktiv, bevor Sie Code schreiben.

2

API-Token erhalten

Erstellen Sie ein API-Token in Ihrem Dashboard. Sie erhalten 50 kostenlose Credits bei der Registrierung.

3

Integrieren

Verwenden Sie unser SDK oder rufen Sie die REST API direkt aus Ihrer Anwendung auf.

FAQ

Wie unterscheidet sich das von regex-basierter Umbenennung?
Regex arbeitet mit bestehenden Dateinamen. Diese API liest Dokumentinhalte und versteht deren Bedeutung. Sie kann Lieferantennamen aus Briefköpfen extrahieren, Dokumenttypen erkennen, bedingte Logik basierend auf Beträgen anwenden und Dateien intelligent weiterleiten - Aufgaben, die mit Musterabgleich nicht möglich sind.
Was kann ich in customTemplate-Anweisungen angeben?
Anweisungen in natürlicher Sprache, die beschreiben, was Sie möchten. Beispiele: "Lieferant und Rechnungsnummer extrahieren, HIGH-VALUE voranstellen, wenn über $10k", "Dokumenttyp erkennen und bei Verträgen beteiligte Parteien einfügen", "Beliebige Sprache lesen, englischen Dateinamen mit Thema und Datum ausgeben".
Welche Dateiformate werden unterstützt?
PDF-, DOCX-, DOC-, XLSX-, XLS-, PPTX-, JPG-, PNG- und TIFF-Dateien bis zu 100MB. Die AI versteht Inhalte in 20+ Sprachen.
Wie genau ist das Verständnis der AI?
95%+ Genauigkeit bei Standard-Geschäftsdokumenten. Die AI liest und versteht die Dokumentstruktur, extrahiert Entitäten (Namen, Daten, Beträge, IDs) und wendet Ihre Anweisungen kontextbezogen an.
Welche Rate Limits gelten?
10,000 Umbenennungen pro 24 Stunden pro Benutzer. Bei Überschreitung gibt die API 429 mit Retry-After- und X-RateLimit-Headern zurück.
Wie funktioniert die Preisgestaltung?
50 kostenlose Credits bei der Registrierung. Danach $9 pro 1,000 Dokumente ($0.009/Datei). 1 Credit = 1 Umbenennung. Credits sind 12 Monate gültig. 30-Tage-Geld-zurück-Garantie.