Przejdź do głównej treści
Renamed.to logorenamed.to
Renamer API

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

rechnung_scan_001.pdfNiemiecka faktura

PDF zawierający: "Mueller GmbH... Rechnungsnummer: INV-98234... Gesamtbetrag: 12.450,00 EUR... DRINGEND"

Wynik AI

HIGH-VALUE_2025-01-15_Mueller-GmbH_INV-98234.pdf
Invoices/Mueller-GmbH/2025/priority/
Prefiks HIGH-VALUE (kwota > 10k)/priority (DRINGEND = pilne)

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ść.

Regex / dopasowywanie wzorców

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
AI z własnymi instrukcjami

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

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 - treść JSON, serwer pobiera plik

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"  }'

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

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ź

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"}

SDK na GitHub: github.com/renamed-to/renamed-sdk

Parametry API

Kluczowe parametry do kontrolowania działania AI.

ParametrWartościOpis
strategyfollow_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
templateModeauto, predefined, customUstaw na custom podczas używania customTemplate
customTemplatestringInstrukcje w języku naturalnym dla 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
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_issuer lub by_all aby 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

  • 401 Nieprawidłowy lub brakujący klucz API
  • 402 Niewystarczająca liczba kredytów
  • 413 Plik jest za duży (powyżej 25MB)
  • 415 Nieobsługiwany typ pliku
  • 429 Ograniczenie szybkości (sprawdź nagłówek Retry-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
Zobacz szczegóły cennika

Pierwsze kroki

Trzy kroki, aby zintegrować Renamer API z Pana/Pani przepływem pracy.

1

Wypróbuj w API Playground

Przetestuj swoje instrukcje interaktywnie przed napisaniem kodu.

2

Pobierz swój token API

Wygeneruj token API w swoim panelu. Po rejestracji otrzymuje Pan/Pani 50 darmowych kredytów.

3

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.