Saltar al contenido principal
Renamed.to logorenamed.to
API de Renamer

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

rechnung_scan_001.pdfFactura en alemán

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

Salida de IA

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

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.

Regex / coincidencia de patrones

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
IA con instrucciones personalizadas

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

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 - cuerpo JSON, el servidor obtiene el archivo

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

SDKs

Use nuestros SDK oficiales para una mejor experiencia de desarrollo con seguridad de tipos y manejo de errores.

SDK de 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"

Respuesta

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

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ámetroValoresDescripción
strategyfollow_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
templateModeauto, predefined, customEstablézcalo en custom cuando use customTemplate
customTemplatestringInstrucciones en lenguaje natural para la IA
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
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_issuer o by_all para 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

  • 401 Clave de API no válida o faltante
  • 402 Créditos insuficientes
  • 413 Archivo demasiado grande (más de 25MB)
  • 415 Tipo de archivo no compatible
  • 429 Límite de tasa alcanzado (revise el encabezado Retry-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
Ver detalles de precios

Primeros pasos

Tres pasos para integrar la API de Renamer en su flujo de trabajo.

1

Probar en API Playground

Pruebe sus instrucciones de forma interactiva antes de escribir código.

2

Obtenga su token de API

Genere un token de API desde su panel. Obtiene 50 créditos gratis al registrarse.

3

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.