AI ドキュメント リネームを カスタム指示
AI に平易な英語で望む内容を伝えます。AI は文書内容を読み、意味を理解し、ロジックを適用します。これは regex では実現できません。
- 自然言語の指示 - 固定的なパターンではありません
- 意味的な抽出 - 内容からベンダー、金額、日付を読み取ります
- 条件分岐ロジック - "金額 > $10k なら HIGH-VALUE を先頭に付ける"
- 20 以上の言語 - ドイツ語を読み取り、英語のファイル名を出力します
少数のファイルだけリネームしたいですか？ 無料の Web ツールを使う
指示: 「任意の言語で文書を読む。ベンダー、請求書番号、金額を抽出する。金額が10000EURを超える場合はHIGH-VALUEを先頭に付ける。Invoices/Vendor/Yearにルーティングし、緊急マークがある場合は/priorityを追加する。」
入力
PDF に含まれる内容: "Mueller GmbH... Rechnungsnummer: INV-98234... Gesamtbetrag: 12.450,00 EUR... DRINGEND"
AI 出力
認証
すべての API リクエストでは、 Authorization ヘッダー内の Bearer token による認証が必要です。
API Token（推奨）
API token は 設定 → APIトークンから生成できます。token には rt_ の接頭辞が付き、アカウントへの完全なアクセスを提供します。
Authorization: Bearer rt_abc123def456...OAuth 2.0
ユーザーの代わりに認証するアプリでは、OAuth 2.0 を使用してください。OAuth フロー完了後、同じように機能する access token を受け取ります:
Authorization: Bearer <oauth_access_token>OAuth クライアント登録とフローの詳細は API ドキュメント をご覧ください。
AI の指示が regex より優れている理由
Regex はファイル名を変換します。AI は文書を読み、内容を理解します。
入力:
scan_001.pdf
パターン:
s/scan_(\\d+)/document_$1/
出力:
document_001.pdf
- 文書内容を読み取れない
- ベンダー、金額、日付を抽出できない
- 条件分岐ロジックを適用できない
- 複数言語を理解できない
入力:
scan_001.pdf
（ドイツ語の請求書、12,450 EUR）
指示:
「ベンダー + 金額を抽出し、>10kならHIGH-VALUEを先頭に付ける」
出力:
HIGH-VALUE_2025-01-15_Mueller-GmbH_INV-98234.pdf
- 文書内容を読み取り、理解する
- エンティティを抽出する: ベンダー、金額、日付、ID
- 自然言語から条件分岐ロジックを適用する
- 20 以上の言語に対応し、任意の言語で出力する
クイックスタート
エンドポイントは 2 つです。ファイルを直接アップロードするか、URL を渡して取得させます。AI への指示には strategy=follow_custom_prompt を customTemplate と一緒に使います。
POST /api/v1/rename - 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 - JSON ボディ、サーバーがファイルを取得
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
型安全性とエラーハンドリングを備えた、より良い開発体験のために公式 SDK をご利用ください。
TypeScript SDKの例
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"レスポンス
{ "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"}GitHub 上の SDK: github.com/renamed-to/renamed-sdk
API パラメーター
AI の動作を制御するための主要なパラメーターです。
| パラメーター | 値 | 説明 |
|---|---|---|
strategy | follow_custom_prompt by_date, by_issuer, by_type by_date_issuer, by_date_type by_issuer_type, by_all, root | customTemplate による AI 指示には follow_custom_prompt を使います |
templateMode | auto, predefined, custom | customTemplate を使う場合は custom に設定します |
customTemplate | string | AI への自然言語の指示 |
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 | 出力ファイル名の言語です。 auto は検出し、 source は文書言語を使用します |
指示でできること
AI は自然言語を解釈し、自前で構築するにはカスタムコードが必要になる複雑なロジックを適用します。
- カスタム抽出 + 条件分岐ロジック
"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"- 文書タイプ検出
"Identify document type (contract, invoice, receipt, statement). For contracts, include parties and effective date. For invoices, include vendor and amount."- スマートなフォルダー振り分け
-
by_date_issuerやby_allのような事前定義済み戦略を使うと、抽出データに基づいてファイルをフォルダー階層に整理できます。 - 多言語理解
"Read document in any language. Extract key info. Output filename in English."- 関係性の検出
"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"
本番運用向け
制限
- ファイルサイズ: 最大25MB
- 形式: PDF, DOCX, DOC, XLSX, XLS, PPTX, JPG, PNG, TIFF
- レート制限: ユーザーあたり1日10,000件
- レスポンス時間: 通常 3-10 秒
一般的なエラー
401API キーが無効、またはありません402クレジット不足413ファイルが大きすぎます（25MB 超）415未対応のファイル形式429レート制限中（Retry-Afterヘッダーを確認）
セキュリティ: すべてのリクエストは TLS 経由です。 /rename-from-url エンドポイントは localhost とプライベート IP 範囲をブロックします。
料金
50 無料クレジット を登録時に付与。その後は 1,000 文書あたり $9 （$0.009/ファイル）です。
- 1 クレジット = 1 回のリネーム
- クレジット有効期間は 12 か月
- 30 日間返金保証
始め方
3 つの手順で Renamer API をワークフローに統合できます。
FAQ
- これは regex ベースのリネームと何が違いますか？
- Regex は既存のファイル名に対して動作します。この API はドキュメント内容を読み取り、意味を理解します。レターヘッドからベンダー名を抽出し、文書タイプを検出し、金額に基づく条件分岐を適用し、ファイルを適切に振り分けることができます。これはパターンマッチングでは不可能な作業です。
- customTemplate の指示には何を入れられますか？
- 望む内容を自然言語で記述した指示です。例: "ベンダー名と請求書番号を抽出し、$10k を超える場合は HIGH-VALUE を先頭に付ける"、"文書タイプを検出し、契約書では関係当事者を含める"、"あらゆる言語を読み取り、トピックと日付を含む英語ファイル名を出力する"。
- 対応しているファイル形式は何ですか？
- PDF、DOCX、DOC、XLSX、XLS、PPTX、JPG、PNG、TIFF に対応し、100MB まで扱えます。AI は 20 以上の言語の内容を理解します。
- AI の理解精度はどの程度ですか？
- 標準的な業務文書で 95%+ の精度です。AI は文書構造を読み取って理解し、エンティティ（名前、日付、金額、ID）を抽出し、指示を文脈に応じて適用します。
- レート制限はありますか？
- ユーザーごとに 24 時間あたり 10,000 件のリネームです。超過した場合、API は Retry-After と X-RateLimit ヘッダー付きで 429 を返します。
- 料金はどのようになっていますか？
- 登録時に 50 無料クレジットがあります。その後は 1,000 文書あたり $9（$0.009/ファイル）です。1 クレジット = 1 回のリネームです。クレジットの有効期間は 12 か月です。30 日間返金保証があります。