Renombrado de documentos con IA con instrucciones personalizadas
Dígale a la IA lo que quiere en inglés sencillo. Lee el contenido del documento, entiende el significado y aplica su lógica, cosas que regex nunca podría hacer.
- Instrucciones en lenguaje natural - no patrones rígidos
- Extracción semántica - lee proveedores, importes y fechas del contenido
- Lógica condicional - "si importe > $10k, prefijo HIGH-VALUE"
- Más de 20 idiomas - lee alemán, genera nombres en inglés
¿Solo necesita renombrar algunos archivos? Usar la herramienta web gratuita
Su instrucción: "Lee el documento en cualquier idioma. Extrae proveedor, número de factura, importe. Si el importe > 10000 EUR, añade el prefijo HIGH-VALUE. Enruta a Invoices/Vendor/Year, añade /priority si está marcado como urgente."
Entrada
PDF que contiene: "Mueller GmbH... Rechnungsnummer: INV-98234... Gesamtbetrag: 12.450,00 EUR... DRINGEND"
Salida de IA
Autenticación
Todas las solicitudes a la API requieren autenticación mediante token Bearer en el encabezado Authorization .
Token de API (recomendado)
Genere tokens de API desde Configuración → Tokens de API. Los tokens tienen el prefijo rt_ y proporcionan acceso completo a su cuenta.
Authorization: Bearer rt_abc123def456...OAuth 2.0
Para aplicaciones que se autentican en nombre de los usuarios, use OAuth 2.0. Después de completar el flujo de OAuth, recibirá un token de acceso que funciona de la misma manera:
Authorization: Bearer <oauth_access_token>Consulte la documentación de la API para el registro del cliente OAuth y los detalles del flujo.
Por qué las instrucciones con IA superan a regex
Regex transforma nombres de archivo. La IA lee documentos y entiende el contenido.
Entrada:
scan_001.pdf
Patrón:
s/scan_(\\d+)/document_$1/
Salida:
document_001.pdf
- No puede leer el contenido del documento
- No puede extraer proveedor, importe ni fecha
- No puede aplicar lógica condicional
- No puede entender varios idiomas
Entrada:
scan_001.pdf
(factura en alemán, 12,450 EUR)
Instrucción:
"Extraer proveedor + importe, prefijo HIGH-VALUE si >10k"
Salida:
HIGH-VALUE_2025-01-15_Mueller-GmbH_INV-98234.pdf
- Lee y entiende el contenido del documento
- Extrae entidades: proveedores, importes, fechas, ID
- Aplica lógica condicional desde lenguaje natural
- Funciona con más de 20 idiomas, genera salida en el idioma que elija
Inicio rápido
Dos endpoints: cargue un archivo directamente o pase una URL y lo obtendremos. Use strategy=follow_custom_prompt con customTemplate para dar sus instrucciones a la IA.
POST /api/v1/rename - carga de archivos 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 - cuerpo JSON, el servidor obtiene el archivo
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
Use nuestros SDK oficiales para una mejor experiencia de desarrollo con seguridad de tipos y manejo de errores.
SDK de 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"Respuesta
{ "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 en GitHub: github.com/renamed-to/renamed-sdk
Parámetros de la API
Parámetros clave para controlar el comportamiento de la IA.
| Parámetro | Valores | Descripción |
|---|---|---|
strategy | follow_custom_prompt by_date, by_issuer, by_type by_date_issuer, by_date_type by_issuer_type, by_all, root | Use follow_custom_prompt para instrucciones de IA mediante customTemplate |
templateMode | auto, predefined, custom | Establézcalo en custom cuando use customTemplate |
customTemplate | string | Instrucciones en lenguaje natural para la IA |
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 | Idioma del nombre de archivo de salida. auto detects, source usa el idioma del documento |
Lo que pueden hacer sus instrucciones
La IA interpreta el lenguaje natural y aplica lógica compleja que requeriría código personalizado si lo desarrollara usted mismo.
- Extracción personalizada + lógica condicional
"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"- Detección del tipo de documento
"Identify document type (contract, invoice, receipt, statement). For contracts, include parties and effective date. For invoices, include vendor and amount."- Enrutamiento inteligente de carpetas
- Use estrategias predefinidas como
by_date_issueroby_allpara organizar archivos en jerarquías de carpetas basadas en los datos extraídos. - Comprensión multilingüe
"Read document in any language. Extract key info. Output filename in English."- Detección de relaciones
"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"
Diseñado para producción
Límites
- Tamaño del archivo: máx. 25 MB
- Formatos: PDF, DOCX, DOC, XLSX, XLS, PPTX, JPG, PNG, TIFF
- Límite de tasa: 10.000/día por usuario
- Tiempo de respuesta: 3–10 segundos habitualmente
Errores comunes
401Clave de API no válida o faltante402Créditos insuficientes413Archivo demasiado grande (más de 25MB)415Tipo de archivo no compatible429Límite de tasa alcanzado (revise el encabezadoRetry-After)
Seguridad: Todas las solicitudes se realizan mediante TLS. El endpoint /rename-from-url bloquea localhost y rangos de IP privadas.
Precios
50 créditos gratis al registrarse. Luego 9 $ por cada 1000 documentos ($0.009/archivo).
- 1 crédito = 1 cambio de nombre
- Créditos válidos durante 12 meses
- Garantía de devolución de 30 días
Primeros pasos
Tres pasos para integrar la API de Renamer en su flujo de trabajo.
Probar en API Playground
Pruebe sus instrucciones de forma interactiva antes de escribir código.
Obtenga su token de API
Genere un token de API desde su panel. Obtiene 50 créditos gratis al registrarse.
Integrar
Use nuestro SDK o llame a la API REST directamente desde su aplicación.
Preguntas frecuentes
- ¿En qué se diferencia esto del renombrado basado en regex?
- Regex opera sobre nombres de archivo existentes. Esta API lee el contenido del documento y entiende el significado. Puede extraer nombres de proveedores de membretes, detectar tipos de documento, aplicar lógica condicional según importes y enrutar archivos de forma inteligente, tareas imposibles con coincidencia de patrones.
- ¿Qué puedo poner en las instrucciones de customTemplate?
- Instrucciones en lenguaje natural que describen lo que desea. Ejemplos: "Extract vendor and invoice number, prefix HIGH-VALUE if over $10k", "Detect document type and include parties involved for contracts", "Read any language, output English filename with topic and date".
- ¿Qué formatos de archivo son compatibles?
- Archivos PDF, DOCX, DOC, XLSX, XLS, PPTX, JPG, PNG y TIFF de hasta 100MB. La IA entiende contenido en más de 20 idiomas.
- ¿Qué tan precisa es la comprensión de la IA?
- 95%+ de precisión en documentos empresariales estándar. La IA lee y comprende la estructura del documento, extrae entidades (nombres, fechas, importes, ID) y aplica sus instrucciones según el contexto.
- ¿Cuáles son los límites de tasa?
- 10,000 renombrados por 24 horas por usuario. Si se supera, la API devuelve 429 con encabezados Retry-After y X-RateLimit.
- ¿Cómo funciona el precio?
- 50 créditos gratis al registrarse. Luego $9 por 1,000 documentos ($0.009/archivo). 1 crédito = 1 cambio de nombre. Los créditos son válidos durante 12 meses. Garantía de devolución de 30 días.