AI 문서 이름 변경을 맞춤 지침으로
원하는 내용을 평이한 영어로 AI에 알려주세요. 문서 내용을 읽고 의미를 이해하며, 사용자의 로직을 적용합니다 - regex로는 할 수 없는 일입니다.
- 자연어 지침 - 엄격한 패턴이 아닙니다
- 의미 기반 추출 - 내용에서 공급업체, 금액, 날짜를 읽습니다
- 조건부 로직 - "금액 > $10k이면 HIGH-VALUE를 앞에 붙이기"
- 20개 이상의 언어 - 독일어를 읽고 영어 파일명으로 출력합니다
파일 몇 개만 이름 변경하면 되시나요? 무료 웹 도구 사용하기
지침: "문서를 어떤 언어로든 읽습니다. 공급업체, 청구서 번호, 금액을 추출합니다. 금액 > 10000 EUR이면 HIGH-VALUE를 앞에 붙입니다. Invoices/Vendor/Year로 라우팅하고, 긴급으로 표시된 경우 /priority를 추가합니다."
입력
다음이 포함된 PDF: "Mueller GmbH... Rechnungsnummer: INV-98234... Gesamtbetrag: 12.450,00 EUR... DRINGEND"
AI 출력
인증
모든 API 요청은 Authorization 헤더의 Bearer 토큰을 통한 인증이 필요합니다.
API 토큰(권장)
다음에서 API 토큰을 생성하세요: 설정 → API 토큰. 토큰은 rt_ 접두사가 붙으며 계정에 대한 전체 액세스를 제공합니다.
Authorization: Bearer rt_abc123def456...OAuth 2.0
사용자를 대신해 인증하는 앱의 경우 OAuth 2.0을 사용하세요. OAuth 흐름이 완료되면 동일한 방식으로 작동하는 액세스 토큰을 받게 됩니다:
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개 이상의 언어에서 작동하며 원하는 언어로 출력
빠른 시작
엔드포인트는 두 가지입니다. 파일을 직접 업로드하거나 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는 자연어를 해석하고 직접 구현하려면 맞춤 코드가 필요한 복잡한 로직을 적용합니다.
- 맞춤 추출 + 조건부 로직
"공급업체명과 청구서 번호를 추출합니다. 총금액이 $10,000 초과이면 HIGH-VALUE_를 앞에 붙입니다. 형식: [prefix]YYYY-MM-DD_VendorName_INV-Number"- 문서 유형 감지
"문서 유형(계약서, 청구서, 영수증, 명세서)을 식별합니다. 계약서에는 당사자와 발효일을 포함합니다. 청구서에는 공급업체와 금액을 포함합니다."- 스마트 폴더 라우팅
- 추출된 데이터를 기반으로 파일을 폴더 계층으로 정리하려면
by_date_issuer또는by_all같은 사전 정의된 전략을 사용하세요. - 다국어 이해
"문서를 어떤 언어로든 읽습니다. 핵심 정보를 추출합니다. 파일명은 영어로 출력합니다."- 관계 감지
"이 문서가 다른 문서에 대한 응답 또는 수정본으로 보이면 RE_ 또는 AMD_ 접두사를 포함하고, 언급된 경우 원본 문서 번호를 참조에 포함합니다"
프로덕션용으로 설계됨
제한
- 파일 크기: 최대 25MB
- 형식: PDF, DOCX, DOC, XLSX, XLS, PPTX, JPG, PNG, TIFF
- 요청 한도: 사용자당 10,000/일
- 응답 시간: 일반적으로 3-10초
일반적인 오류
401유효하지 않거나 누락된 API 키402크레딧 부족413파일이 너무 큼(25MB 초과)415지원되지 않는 파일 형식429요청 한도 초과(Retry-After헤더 확인)
보안: 모든 요청은 TLS를 통해 전송됩니다. /rename-from-url 엔드포인트는 localhost 및 사설 IP 대역을 차단합니다.
요금
무료 크레딧 50개 가입 시 제공. 이후 문서 1,000개당 $9 ($0.009/파일)입니다.
- 1크레딧 = 1회 이름 변경
- 크레딧은 12개월 동안 유효
- 30일 환불 보장
시작하기
세 단계로 Renamer API를 워크플로에 통합하세요.
FAQ
- 이것은 regex 기반 이름 변경과 어떻게 다른가요?
- Regex는 기존 파일명에 대해 작동합니다. 이 API는 문서 내용을 읽고 의미를 이해합니다. 레터헤드에서 공급업체명을 추출하고, 문서 유형을 감지하며, 금액에 따라 조건부 로직을 적용하고, 파일을 지능적으로 라우팅할 수 있습니다. 이는 패턴 매칭으로는 불가능한 작업입니다.
- customTemplate 지침에는 무엇을 넣을 수 있나요?
- 원하는 내용을 설명하는 자연어 지침입니다. 예: "공급업체와 청구서 번호를 추출하고, $10k 초과 시 HIGH-VALUE를 앞에 붙이기", "문서 유형을 감지하고 계약서의 경우 관련 당사자를 포함하기", "모든 언어를 읽고 주제와 날짜가 포함된 영어 파일명으로 출력하기".
- 어떤 파일 형식을 지원하나요?
- 최대 100MB의 PDF, DOCX, DOC, XLSX, XLS, PPTX, JPG, PNG, TIFF 파일을 지원합니다. 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일 환불 보장이 제공됩니다.