Ridenominazione documenti con AI e Istruzioni personalizzate
Dica all’AI ciò che desidera in inglese semplice. Legge il contenuto del documento, ne comprende il significato e applica la Sua logica - cose che regex non potrebbe mai fare.
- Istruzioni in linguaggio naturale - non pattern rigidi
- Estrazione semantica - legge fornitori, importi, date dal contenuto
- Logica condizionale - "se importo > $10k, prefisso HIGH-VALUE"
- 20+ lingue - legge il tedesco, produce nomi file in inglese
Deve solo rinominare alcuni file? Usi lo strumento web gratuito
La Sua istruzione: "Leggi il documento in qualsiasi lingua. Estrai fornitore, numero fattura, importo. Se l'importo > 10000 EUR, aggiungi il prefisso HIGH-VALUE. Instrada verso Invoices/Vendor/Year, aggiungi /priority se contrassegnato come urgente."
Input
PDF contenente: "Mueller GmbH... Rechnungsnummer: INV-98234... Gesamtbetrag: 12.450,00 EUR... DRINGEND"
Output AI
Autenticazione
Tutte le richieste API richiedono autenticazione tramite token Bearer nell’intestazione Authorization .
Token API (consigliato)
Generi i token API da Impostazioni → Token API. I token hanno il prefisso rt_ e forniscono accesso completo al Suo account.
Authorization: Bearer rt_abc123def456...OAuth 2.0
Per le app che si autenticano per conto degli utenti, usi OAuth 2.0. Dopo il completamento del flusso OAuth, riceve un token di accesso che funziona allo stesso modo:
Authorization: Bearer <oauth_access_token>Veda la documentazione API per la registrazione del client OAuth e i dettagli del flusso.
Perché le istruzioni AI superano regex
Regex trasforma i nomi file. L’AI legge i documenti e ne comprende il contenuto.
Input:
scan_001.pdf
Pattern:
s/scan_(\\d+)/document_$1/
Output:
document_001.pdf
- Non può leggere il contenuto del documento
- Non può estrarre fornitore, importo, data
- Non può applicare logica condizionale
- Non può comprendere più lingue
Input:
scan_001.pdf
(fattura tedesca, 12,450 EUR)
Istruzione:
"Estrai fornitore + importo, prefisso HIGH-VALUE se >10k"
Output:
HIGH-VALUE_2025-01-15_Mueller-GmbH_INV-98234.pdf
- Legge e comprende il contenuto del documento
- Estrae entità: fornitori, importi, date, ID
- Applica logica condizionale dal linguaggio naturale
- Funziona con oltre 20 lingue, con output a Sua scelta
Avvio rapido
Due endpoint: carichi direttamente un file, oppure passi un URL e noi lo recupereremo. Usi strategy=follow_custom_prompt con customTemplate per fornire all’AI le Sue istruzioni.
POST /api/v1/rename - caricamento file 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 - corpo JSON, il server recupera il file
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
Usi i nostri SDK ufficiali per una migliore esperienza di sviluppo con sicurezza dei tipi e gestione degli errori.
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"Risposta
{ "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 su GitHub: github.com/renamed-to/renamed-sdk
Parametri API
Parametri chiave per controllare il comportamento dell'AI.
| Parametro | Valori | Descrizione |
|---|---|---|
strategy | follow_custom_prompt by_date, by_issuer, by_type by_date_issuer, by_date_type by_issuer_type, by_all, root | Usi follow_custom_prompt per le istruzioni AI tramite customTemplate |
templateMode | auto, predefined, custom | Imposti su custom quando usa customTemplate |
customTemplate | string | Istruzioni in linguaggio naturale per l’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 | Lingua del nome file in output. auto rileva, source usa la lingua del documento |
Cosa possono fare le Sue istruzioni
L’AI interpreta il linguaggio naturale e applica logica complessa che richiederebbe codice personalizzato se dovesse svilupparla da solo.
- Estrazione personalizzata + logica condizionale
"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"- Rilevamento del tipo di documento
"Identify document type (contract, invoice, receipt, statement). For contracts, include parties and effective date. For invoices, include vendor and amount."- Instradamento intelligente delle cartelle
- Usi strategie predefinite come
by_date_issueroby_allper organizzare i file in gerarchie di cartelle basate sui dati estratti. - Comprensione multilingue
"Read document in any language. Extract key info. Output filename in English."- Rilevamento delle relazioni
"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"
Progettato per la produzione
Limiti
- Dimensione file: max 25 MB
- Formati: PDF, DOCX, DOC, XLSX, XLS, PPTX, JPG, PNG, TIFF
- Limite di frequenza: 10.000/giorno per utente
- Tempo di risposta: 3-10 secondi tipici
Errori comuni
401Chiave API non valida o mancante402Crediti insufficienti413File troppo grande (oltre 25MB)415Tipo di file non supportato429Limitazione di frequenza applicata (controlli l’intestazioneRetry-After)
Sicurezza: Tutte le richieste tramite TLS. L’endpoint /rename-from-url blocca localhost e gli intervalli IP privati.
Prezzi
50 crediti gratuiti alla registrazione. Poi $9 per 1,000 documenti ($0.009/file).
- 1 credito = 1 rinomina
- Crediti validi per 12 mesi
- Garanzia di rimborso di 30 giorni
Come iniziare
Tre passaggi per integrare l’API Renamer nel Suo flusso di lavoro.
Provi nell’API Playground
Testi le Sue istruzioni in modo interattivo prima di scrivere codice.
Ottenga il Suo token API
Generi un token API dalla Sua dashboard. Ottiene 50 crediti gratuiti alla registrazione.
Integri
Usi il nostro SDK o chiami direttamente l’API REST dalla Sua applicazione.
FAQ
- In cosa differisce dalla ridenominazione basata su regex?
- Regex opera sui nomi file esistenti. Questa API legge il contenuto del documento e ne comprende il significato. Può estrarre i nomi dei fornitori dalle intestazioni, rilevare i tipi di documento, applicare logica condizionale in base agli importi e instradare i file in modo intelligente - attività impossibili con la corrispondenza di pattern.
- Cosa posso inserire nelle istruzioni customTemplate?
- Istruzioni in linguaggio naturale che descrivono ciò che desidera. Esempi: "Estrai fornitore e numero fattura, aggiungi il prefisso HIGH-VALUE se supera $10k", "Rileva il tipo di documento e includi le parti coinvolte per i contratti", "Leggi qualsiasi lingua, restituisci un nome file in inglese con argomento e data".
- Quali formati di file sono supportati?
- File PDF, DOCX, DOC, XLSX, XLS, PPTX, JPG, PNG e TIFF fino a 100MB. L’AI comprende contenuti in oltre 20 lingue.
- Quanto è accurata la comprensione dell’AI?
- Accuratezza del 95%+ sui documenti aziendali standard. L’AI legge e comprende la struttura del documento, estrae entità (nomi, date, importi, ID) e applica le Sue istruzioni in base al contesto.
- Quali sono i limiti di frequenza?
- 10,000 ridenominazioni per 24 ore per utente. Se superati, l’API restituisce 429 con intestazioni Retry-After e X-RateLimit.
- Come funziona il prezzo?
- 50 crediti gratuiti alla registrazione. Poi $9 per 1,000 documenti ($0.009/file). 1 credito = 1 rinomina. I crediti sono validi per 12 mesi. Garanzia di rimborso di 30 giorni.