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
PDF mit folgendem Inhalt: "Mueller GmbH... Rechnungsnummer: INV-98234... Gesamtbetrag: 12.450,00 EUR... DRINGEND"
AI-Ausgabe
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.
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
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
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
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
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
{ "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.
| Parameter | Werte | Beschreibung |
|---|---|---|
strategy | follow_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 |
templateMode | auto, predefined, custom | Auf custom setzen, wenn customTemplate verwendet wird |
customTemplate | string | Anweisungen in natürlicher Sprache für die AI |
language | auto, 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_issueroderby_allum 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
401Ungültiger oder fehlender API-Schlüssel402Unzureichende Credits413Datei zu groß (über 25MB)415Nicht unterstützter Dateityp429Rate Limit erreicht (prüfen Sie denRetry-AfterHeader)
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
Erste Schritte
Drei Schritte, um die Renamer API in Ihren Workflow zu integrieren.
Im API Playground testen
Testen Sie Ihre Anweisungen interaktiv, bevor Sie Code schreiben.
API-Token erhalten
Erstellen Sie ein API-Token in Ihrem Dashboard. Sie erhalten 50 kostenlose Credits bei der Registrierung.
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.