Pular para o conteúdo principal
Renamed.to logorenamed.to
API de Renomeação

Renomeação de Documentos com IA com Instruções Personalizadas

Diga à IA o que o senhor deseja em inglês simples. Ela lê o conteúdo do documento, entende o significado e aplica sua lógica - coisas que regex nunca conseguiria fazer.

  • Instruções em linguagem natural - não padrões rígidos
  • Extração semântica - lê fornecedores, valores e datas do conteúdo
  • Lógica condicional - "se valor > $10k, prefixo HIGH-VALUE"
  • Mais de 20 idiomas - lê alemão, gera nomes de arquivos em inglês

Precisa apenas renomear alguns arquivos? Usar a ferramenta web gratuita

Sua instrução: "Leia o documento em qualquer idioma. Extraia fornecedor, número da fatura, valor. Se o valor > 10000 EUR, adicione o prefixo HIGH-VALUE. Direcione para Invoices/Vendor/Year, adicione /priority se marcado como urgente."

Entrada

rechnung_scan_001.pdfFatura em alemão

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

Saída da IA

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

Autenticação

Todas as solicitações da API exigem autenticação via token Bearer no cabeçalho Authorization .

Token de API (recomendado)

Gere tokens de API em Configurações → Tokens de API. Os tokens têm o prefixo rt_ e fornecem acesso total à sua conta.

Authorization: Bearer rt_abc123def456...

OAuth 2.0

Para aplicativos que se autenticam em nome dos usuários, use OAuth 2.0. Após a conclusão do fluxo OAuth, o senhor recebe um token de acesso que funciona da mesma forma:

Authorization: Bearer <oauth_access_token>

Consulte a documentação da API para detalhes sobre registro do cliente OAuth e do fluxo.

Por que instruções com IA superam regex

Regex transforma nomes de arquivos. A IA lê documentos e entende o conteúdo.

Regex / correspondência de padrões

Entrada:

scan_001.pdf

Padrão:

s/scan_(\\d+)/document_$1/

Saída:

document_001.pdf

  • Não consegue ler o conteúdo do documento
  • Não consegue extrair fornecedor, valor, data
  • Não consegue aplicar lógica condicional
  • Não consegue entender vários idiomas
IA com instruções personalizadas

Entrada:

scan_001.pdf

(fatura em alemão, 12,450 EUR)

Instrução:

"Extrair fornecedor + valor, prefixo HIGH-VALUE se >10k"

Saída:

HIGH-VALUE_2025-01-15_Mueller-GmbH_INV-98234.pdf

  • Lê e entende o conteúdo do documento
  • Extrai entidades: fornecedores, valores, datas, IDs
  • Aplica lógica condicional a partir de linguagem natural
  • Funciona com mais de 20 idiomas, com saída na sua escolha

Início rápido

Dois endpoints: envie um arquivo diretamente ou passe uma URL e nós o buscaremos. Use strategy=follow_custom_prompt com customTemplate para dar suas instruções à IA.

POST /api/v1/rename - upload de arquivo 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, o servidor busca o arquivo

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 nossos SDKs oficiais para uma melhor experiência de desenvolvimento com segurança de tipos e tratamento de erros.

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"

Resposta

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

Parâmetros da API

Principais parâmetros para controlar o comportamento da IA.

ParâmetroValoresDescrição
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 instruções de IA via customTemplate
templateModeauto, predefined, customDefina como custom ao usar customTemplate
customTemplatestringInstruções em linguagem natural para a 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 do nome do arquivo de saída. auto detecta, source usa o idioma do documento

O que suas instruções podem fazer

A IA interpreta linguagem natural e aplica lógica complexa que exigiria código personalizado para ser criada pelo senhor.

Extração 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"
Detecção de tipo de documento
"Identify document type (contract, invoice, receipt, statement). For contracts, include parties and effective date. For invoices, include vendor and amount."
Encaminhamento inteligente para pastas
Use estratégias predefinidas como by_date_issuer ou by_all para organizar arquivos em hierarquias de pastas com base nos dados extraídos.
Compreensão multilíngue
"Read document in any language. Extract key info. Output filename in English."
Detecção de relacionamento
"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"

Criado para produção

Limites

  • Tamanho do arquivo: máx. 25 MB
  • Formatos: PDF, DOCX, DOC, XLSX, XLS, PPTX, JPG, PNG, TIFF
  • Limite de taxa: 10.000/dia por usuário
  • Tempo de resposta: 3–10 segundos normalmente

Erros comuns

  • 401 Chave de API inválida ou ausente
  • 402 Créditos insuficientes
  • 413 Arquivo muito grande (acima de 25MB)
  • 415 Tipo de arquivo não compatível
  • 429 Taxa limitada (verifique o cabeçalho Retry-After )

Segurança: Todas as solicitações via TLS. O endpoint /rename-from-url bloqueia localhost e intervalos de IP privados.

Preços

50 créditos grátis no cadastro. Depois, $9 por 1,000 documentos ($0.009/arquivo).

  • 1 crédito = 1 renomeação
  • Créditos válidos por 12 meses
  • Garantia de reembolso de 30 dias
Ver detalhes de preços

Primeiros passos

Três etapas para integrar a API de Renomeação ao seu fluxo de trabalho.

1

Experimente no API Playground

Teste suas instruções de forma interativa antes de escrever código.

2

Obtenha seu token de API

Gere um token de API no seu painel. O senhor recebe 50 créditos grátis no cadastro.

3

Integrar

Use nosso SDK ou chame a API REST diretamente da sua aplicação.

FAQ

Como isso é diferente da renomeação baseada em regex?
Regex opera sobre nomes de arquivos existentes. Esta API lê o conteúdo do documento e entende o significado. Ela pode extrair nomes de fornecedores de timbres, detectar tipos de documento, aplicar lógica condicional com base em valores e encaminhar arquivos de forma inteligente - tarefas impossíveis com correspondência de padrões.
O que posso colocar nas instruções de customTemplate?
Instruções em linguagem natural descrevendo o que o senhor deseja. Exemplos: "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".
Quais formatos de arquivo são compatíveis?
Arquivos PDF, DOCX, DOC, XLSX, XLS, PPTX, JPG, PNG e TIFF de até 100MB. A IA entende conteúdo em mais de 20 idiomas.
Quão precisa é a compreensão da IA?
95%+ de precisão em documentos empresariais padrão. A IA lê e compreende a estrutura do documento, extrai entidades (nomes, datas, valores, IDs) e aplica suas instruções de acordo com o contexto.
Quais são os limites de taxa?
10,000 renomeações por 24 horas por usuário. Se excedido, a API retorna 429 com cabeçalhos Retry-After e X-RateLimit.
Como funciona o preço?
50 créditos grátis no cadastro. Depois, $9 por 1,000 documentos ($0.009/arquivo). 1 crédito = 1 renomeação. Os créditos são válidos por 12 meses. Garantia de reembolso de 30 dias.