Zmiana nazw dokumentów AI z własnymi instrukcjami
Proszę powiedzieć AI, czego Pan/Pani chce, prostym językiem. Odczytuje treść dokumentu, rozumie znaczenie i stosuje Pana/Pani logikę — rzeczy, których regex nigdy nie potrafiłby zrobić.
- Instrukcje w języku naturalnym - nie sztywne wzorce
- Wyodrębnianie semantyczne - odczytuje dostawców, kwoty, daty z treści
- Logika warunkowa - "jeśli kwota > $10k, dodaj prefiks HIGH-VALUE"
- Ponad 20 języków - odczytuje niemiecki, zwraca angielskie nazwy plików
Potrzebuje Pan/Pani tylko zmienić nazwę kilku plików? Użyj darmowego narzędzia webowego
Pana/Pani instrukcja: "Odczytaj dokument w dowolnym języku. Wyodrębnij dostawcę, numer faktury, kwotę. Jeśli kwota > 10000 EUR, dodaj prefiks HIGH-VALUE. Skieruj do Invoices/Vendor/Year, dodaj /priority, jeśli oznaczono jako pilne."
Wejście
PDF zawierający: "Mueller GmbH... Rechnungsnummer: INV-98234... Gesamtbetrag: 12.450,00 EUR... DRINGEND"
Wynik AI
Uwierzytelnianie
Wszystkie żądania API wymagają uwierzytelnienia przez token Bearer w nagłówku Authorization .
Token API (zalecane)
Tokeny API można generować w Ustawienia → Tokeny API. Tokeny mają prefiks rt_ i zapewniają pełny dostęp do Pana/Pani konta.
Authorization: Bearer rt_abc123def456...OAuth 2.0
W przypadku aplikacji uwierzytelniających się w imieniu użytkowników należy użyć OAuth 2.0. Po zakończeniu przepływu OAuth otrzymuje Pan/Pani token dostępu, który działa w ten sam sposób:
Authorization: Bearer <oauth_access_token>Zobacz dokumentację API aby poznać szczegóły rejestracji klienta OAuth i przebiegu procesu.
Dlaczego instrukcje AI wygrywają z regex
Regex przekształca nazwy plików. AI odczytuje dokumenty i rozumie treść.
Wejście:
scan_001.pdf
Wzorzec:
s/scan_(\\d+)/document_$1/
Wynik:
document_001.pdf
- Nie może odczytać treści dokumentu
- Nie może wyodrębnić dostawcy, kwoty, daty
- Nie może stosować logiki warunkowej
- Nie może rozumieć wielu języków
Wejście:
scan_001.pdf
(niemiecka faktura, 12,450 EUR)
Instrukcja:
"Wyodrębnij dostawcę + kwotę, dodaj prefiks HIGH-VALUE, jeśli >10k"
Wynik:
HIGH-VALUE_2025-01-15_Mueller-GmbH_INV-98234.pdf
- Odczytuje i rozumie treść dokumentu
- Wyodrębnia encje: dostawców, kwoty, daty, identyfikatory
- Stosuje logikę warunkową z języka naturalnego
- Działa z ponad 20 językami, zwraca wynik w wybranym języku
Szybki start
Dwa endpointy: prześlij plik bezpośrednio lub podaj URL, a my go pobierzemy. Użyj strategy=follow_custom_prompt z customTemplate aby przekazać AI swoje instrukcje.
POST /api/v1/rename - przesyłanie pliku multipart
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 - treść JSON, serwer pobiera plik
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" }'SDK
Użyj naszych oficjalnych SDK, aby zapewnić lepsze doświadczenie deweloperskie z bezpieczeństwem typów i obsługą błędów.
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"Odpowiedź
{ "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"}SDK na GitHub: github.com/renamed-to/renamed-sdk
Parametry API
Kluczowe parametry do kontrolowania działania AI.
| Parametr | Wartości | Opis |
|---|---|---|
strategy | follow_custom_prompt by_date, by_issuer, by_type by_date_issuer, by_date_type by_issuer_type, by_all, root | Użyj follow_custom_prompt dla instrukcji AI przez customTemplate |
templateMode | auto, predefined, custom | Ustaw na custom podczas używania customTemplate |
customTemplate | string | Instrukcje w języku naturalnym dla 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 | Język wyjściowej nazwy pliku. auto wykrywa, source używa języka dokumentu |
Co mogą zrobić Pana/Pani instrukcje
AI interpretuje język naturalny i stosuje złożoną logikę, która wymagałaby własnego kodu, aby zbudować ją samodzielnie.
- Własne wyodrębnianie + logika warunkowa
"Wyodrębnij nazwę dostawcy i numer faktury. Jeśli całkowita kwota przekracza $10,000, dodaj prefiks HIGH-VALUE_. Format: [prefix]YYYY-MM-DD_VendorName_INV-Number"- Wykrywanie typu dokumentu
"Zidentyfikuj typ dokumentu (contract, invoice, receipt, statement). Dla umów uwzględnij strony i datę wejścia w życie. Dla faktur uwzględnij dostawcę i kwotę."- Inteligentne kierowanie do folderów
- Użyj predefiniowanych strategii, takich jak
by_date_issuerlubby_allaby organizować pliki w hierarchie folderów na podstawie wyodrębnionych danych. - Wielojęzyczne rozumienie
"Odczytaj dokument w dowolnym języku. Wyodrębnij kluczowe informacje. Zwróć nazwę pliku po angielsku."- Wykrywanie relacji
"Jeśli wygląda na to, że jest to odpowiedź lub aneks do innego dokumentu, uwzględnij prefiks RE_ lub AMD_ i numer dokumentu źródłowego, jeśli został wspomniany"
Stworzone do środowiska produkcyjnego
Limity
- Rozmiar pliku: maks. 25MB
- Formaty: PDF, DOCX, DOC, XLSX, XLS, PPTX, JPG, PNG, TIFF
- Limit szybkości: 10,000/dzień na użytkownika
- Czas odpowiedzi: zwykle 3-10 sekund
Typowe błędy
401Nieprawidłowy lub brakujący klucz API402Niewystarczająca liczba kredytów413Plik jest za duży (powyżej 25MB)415Nieobsługiwany typ pliku429Ograniczenie szybkości (sprawdź nagłówekRetry-After)
Bezpieczeństwo: Wszystkie żądania przez TLS. Endpoint /rename-from-url blokuje localhost i prywatne zakresy IP.
Cennik
50 darmowych kredytów po rejestracji. Następnie $9 za 1,000 dokumentów ($0.009/plik).
- 1 kredyt = 1 zmiana nazwy
- Kredyty ważne przez 12 miesięcy
- 30-dniowa gwarancja zwrotu pieniędzy
Pierwsze kroki
Trzy kroki, aby zintegrować Renamer API z Pana/Pani przepływem pracy.
Wypróbuj w API Playground
Przetestuj swoje instrukcje interaktywnie przed napisaniem kodu.
Pobierz swój token API
Wygeneruj token API w swoim panelu. Po rejestracji otrzymuje Pan/Pani 50 darmowych kredytów.
Zintegruj
Użyj naszego SDK lub wywołaj REST API bezpośrednio ze swojej aplikacji.
FAQ
- Czym to się różni od zmiany nazw opartej na regex?
- Regex działa na istniejących nazwach plików. To API odczytuje treść dokumentu i rozumie jego znaczenie. Może wyodrębniać nazwy dostawców z papieru firmowego, wykrywać typy dokumentów, stosować logikę warunkową na podstawie kwot i inteligentnie kierować pliki — zadania niemożliwe przy dopasowywaniu wzorców.
- Co mogę umieścić w instrukcjach customTemplate?
- Instrukcje w języku naturalnym opisujące, czego Pan/Pani chce. Przykłady: "Wyodrębnij dostawcę i numer faktury, dodaj prefiks HIGH-VALUE, jeśli kwota przekracza $10k", "Wykryj typ dokumentu i uwzględnij strony umowy dla kontraktów", "Odczytaj dowolny język, zwróć angielską nazwę pliku z tematem i datą".
- Jakie formaty plików są obsługiwane?
- Pliki PDF, DOCX, DOC, XLSX, XLS, PPTX, JPG, PNG i TIFF do 100MB. AI rozumie treść w ponad 20 językach.
- Jak dokładne jest rozumienie przez AI?
- Dokładność 95%+ dla standardowych dokumentów biznesowych. AI odczytuje i rozumie strukturę dokumentu, wyodrębnia encje (nazwy, daty, kwoty, identyfikatory) i stosuje Pana/Pani instrukcje kontekstowo.
- Jakie są limity szybkości?
- 10,000 zmian nazw na 24 godziny na użytkownika. Po przekroczeniu API zwraca 429 z nagłówkami Retry-After i X-RateLimit.
- Jak działa cennik?
- 50 darmowych kredytów po rejestracji. Następnie $9 za 1,000 dokumentów ($0.009/plik). 1 kredyt = 1 zmiana nazwy. Kredyty są ważne przez 12 miesięcy. 30-dniowa gwarancja zwrotu pieniędzy.