Aller au contenu principal
Renamed.to logorenamed.to
API Renamer

Renommage de documents par IA avec Instructions personnalisées

Dites à l'IA ce que vous voulez en anglais simple. Elle lit le contenu du document, en comprend le sens et applique votre logique - des choses que regex ne pourrait jamais faire.

  • Instructions en langage naturel - pas de motifs rigides
  • Extraction sémantique - lit fournisseurs, montants, dates dans le contenu
  • Logique conditionnelle - "si montant > 10k$, préfixe HIGH-VALUE"
  • 20+ langues - lit l’allemand, génère des noms de fichiers anglais

Vous devez juste renommer quelques fichiers ? Utiliser l'outil web gratuit

Votre instruction : "Lis le document dans n'importe quelle langue. Extrais le fournisseur, le numéro de facture, le montant. Si le montant > 10000 EUR, ajoute le préfixe HIGH-VALUE. Route vers Invoices/Vendor/Year, ajoute /priority si marqué urgent."

Entrée

rechnung_scan_001.pdfFacture allemande

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

Sortie IA

HIGH-VALUE_2025-01-15_Mueller-GmbH_INV-98234.pdf
Invoices/Mueller-GmbH/2025/priority/
Préfixe HIGH-VALUE (montant > 10k)/priority (DRINGEND = pressant)

Authentification

Toutes les requêtes API nécessitent une authentification via un token Bearer dans l'en-tête Authorization .

Token API (recommandé)

Générez des tokens API depuis Paramètres → Jetons API. Les tokens sont préfixés par rt_ et fournissent un accès complet à votre compte.

Authorization: Bearer rt_abc123def456...

OAuth 2.0

Pour les applications qui s’authentifient au nom des utilisateurs, utilisez OAuth 2.0. Une fois le flux OAuth terminé, vous recevez un access token qui fonctionne de la même manière :

Authorization: Bearer <oauth_access_token>

Voir la documentation de l'API pour l'enregistrement du client OAuth et les détails du flux.

Pourquoi les instructions IA surpassent regex

Regex transforme les noms de fichiers. L’IA lit les documents et en comprend le contenu.

Regex / correspondance de motifs

Entrée :

scan_001.pdf

Motif :

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

Sortie :

document_001.pdf

  • Ne peut pas lire le contenu du document
  • Ne peut pas extraire fournisseur, montant, date
  • Ne peut pas appliquer une logique conditionnelle
  • Ne peut pas comprendre plusieurs langues
IA avec instructions personnalisées

Entrée :

scan_001.pdf

(facture allemande, 12,450 EUR)

Instruction :

"Extraire fournisseur + montant, préfixe HIGH-VALUE si >10k"

Sortie :

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

  • Lit et comprend le contenu du document
  • Extrait les entités : fournisseurs, montants, dates, IDs
  • Applique une logique conditionnelle à partir du langage naturel
  • Fonctionne avec plus de 20 langues, sortie dans la langue de votre choix

Démarrage rapide

Deux endpoints : téléchargez un fichier directement, ou transmettez une URL et nous le récupérerons. Utilisez strategy=follow_custom_prompt avec customTemplate pour donner vos instructions à l'IA.

POST /api/v1/rename - téléversement de fichier 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 - corps JSON, le serveur récupère le fichier

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

Utilisez nos SDKs officiels pour une meilleure expérience développeur avec sécurité de type et gestion des erreurs.

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"

Réponse

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

Paramètres de l'API

Paramètres clés pour contrôler le comportement de l'IA.

ParamètreValeursDescription
strategyfollow_custom_prompt
by_date, by_issuer, by_type
by_date_issuer, by_date_type
by_issuer_type, by_all, root
Utilisez follow_custom_prompt pour les instructions IA via customTemplate
templateModeauto, predefined, customDéfinissez sur custom lors de l’utilisation de customTemplate
customTemplatestringInstructions en langage naturel pour l'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
Langue du nom de fichier de sortie. auto détecte, source utilise la langue du document

Ce que vos instructions peuvent faire

L'IA interprète le langage naturel et applique une logique complexe qui demanderait du code personnalisé si vous la développiez vous-même.

Extraction personnalisée + logique conditionnelle
"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"
Détection du type de document
"Identify document type (contract, invoice, receipt, statement). For contracts, include parties and effective date. For invoices, include vendor and amount."
Routage intelligent des dossiers
Utilisez des stratégies prédéfinies comme by_date_issuer ou by_all pour organiser les fichiers dans des hiérarchies de dossiers selon les données extraites.
Compréhension multilingue
"Read document in any language. Extract key info. Output filename in English."
Détection des relations
"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"

Conçu pour la production

Limites

  • Taille de fichier : 25 Mo max.
  • Formats : PDF, DOCX, DOC, XLSX, XLS, PPTX, JPG, PNG, TIFF
  • Limite de débit : 10,000/jour par utilisateur
  • Temps de réponse : 3-10 secondes en général

Erreurs courantes

  • 401 Clé API invalide ou manquante
  • 402 Crédits insuffisants
  • 413 Fichier trop volumineux (plus de 25MB)
  • 415 Type de fichier non pris en charge
  • 429 Limite de débit atteinte (vérifiez l’en-tête Retry-After )

Sécurité : Toutes les requêtes passent par TLS. Le endpoint /rename-from-url bloque localhost et les plages IP privées.

Tarification

50 crédits gratuits à l’inscription. Ensuite $9 pour 1,000 documents ($0.009/fichier).

  • 1 crédit = 1 renommage
  • Crédits valables 12 mois
  • Garantie de remboursement de 30 jours
Voir les détails de tarification

Premiers pas

Trois étapes pour intégrer l’API Renamer dans votre flux de travail.

1

Essayer dans l'API Playground

Testez vos instructions de façon interactive avant d’écrire du code.

2

Obtenez votre token API

Générez un token API depuis votre tableau de bord. Vous obtenez 50 crédits gratuits à l'inscription.

3

Intégrer

Utilisez notre SDK ou appelez directement l’API REST depuis votre application.

FAQ

En quoi est-ce différent du renommage basé sur regex ?
Regex fonctionne sur les noms de fichiers existants. Cette API lit le contenu des documents et en comprend le sens. Elle peut extraire les noms de fournisseurs à partir des en-têtes, détecter les types de documents, appliquer une logique conditionnelle selon les montants et router les fichiers intelligemment - des tâches impossibles avec la correspondance de motifs.
Que puis-je mettre dans les instructions customTemplate ?
Des instructions en langage naturel décrivant ce que vous voulez. Exemples : "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".
Quels formats de fichiers sont pris en charge ?
Fichiers PDF, DOCX, DOC, XLSX, XLS, PPTX, JPG, PNG et TIFF jusqu’à 100MB. L’IA comprend le contenu dans plus de 20 langues.
Quel est le niveau de précision de la compréhension par l'IA ?
95%+ de précision sur les documents professionnels standard. L'IA lit et comprend la structure du document, extrait les entités (noms, dates, montants, IDs) et applique vos instructions selon le contexte.
Quelles sont les limites de débit ?
10,000 renommages par tranche de 24 heures et par utilisateur. En cas de dépassement, l'API renvoie 429 avec les en-têtes Retry-After et X-RateLimit.
Comment fonctionne la tarification ?
50 crédits gratuits à l’inscription. Ensuite, $9 pour 1,000 documents ($0.009/fichier). 1 crédit = 1 renommage. Les crédits sont valables 12 mois. Garantie de remboursement de 30 jours.