Vai al contenuto principale
Renamed.to logorenamed.to
API Renamer

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

rechnung_scan_001.pdfFattura tedesca

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

Output AI

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

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.

Regex / corrispondenza di pattern

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
AI con istruzioni personalizzate

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

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 - corpo JSON, il server recupera il file

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

Usi i nostri SDK ufficiali per una migliore esperienza di sviluppo con sicurezza dei tipi e gestione degli errori.

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"

Risposta

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 su GitHub: github.com/renamed-to/renamed-sdk

Parametri API

Parametri chiave per controllare il comportamento dell'AI.

ParametroValoriDescrizione
strategyfollow_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
templateModeauto, predefined, customImposti su custom quando usa customTemplate
customTemplatestringIstruzioni in linguaggio naturale per l’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
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_issuer o by_all per 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

  • 401 Chiave API non valida o mancante
  • 402 Crediti insufficienti
  • 413 File troppo grande (oltre 25MB)
  • 415 Tipo di file non supportato
  • 429 Limitazione di frequenza applicata (controlli l’intestazione Retry-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
Veda i dettagli dei prezzi

Come iniziare

Tre passaggi per integrare l’API Renamer nel Suo flusso di lavoro.

1

Provi nell’API Playground

Testi le Sue istruzioni in modo interattivo prima di scrivere codice.

2

Ottenga il Suo token API

Generi un token API dalla Sua dashboard. Ottiene 50 crediti gratuiti alla registrazione.

3

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.