메인 콘텐츠로 건너뛰기
Renamed.to logorenamed.to
Renamer API

AI 문서 이름 변경을 맞춤 지침으로

원하는 내용을 평이한 영어로 AI에 알려주세요. 문서 내용을 읽고 의미를 이해하며, 사용자의 로직을 적용합니다 - regex로는 할 수 없는 일입니다.

  • 자연어 지침 - 엄격한 패턴이 아닙니다
  • 의미 기반 추출 - 내용에서 공급업체, 금액, 날짜를 읽습니다
  • 조건부 로직 - "금액 > $10k이면 HIGH-VALUE를 앞에 붙이기"
  • 20개 이상의 언어 - 독일어를 읽고 영어 파일명으로 출력합니다

파일 몇 개만 이름 변경하면 되시나요? 무료 웹 도구 사용하기

지침: "문서를 어떤 언어로든 읽습니다. 공급업체, 청구서 번호, 금액을 추출합니다. 금액 > 10000 EUR이면 HIGH-VALUE를 앞에 붙입니다. Invoices/Vendor/Year로 라우팅하고, 긴급으로 표시된 경우 /priority를 추가합니다."

입력

rechnung_scan_001.pdf독일어 청구서

다음이 포함된 PDF: "Mueller GmbH... Rechnungsnummer: INV-98234... Gesamtbetrag: 12.450,00 EUR... DRINGEND"

AI 출력

HIGH-VALUE_2025-01-15_Mueller-GmbH_INV-98234.pdf
Invoices/Mueller-GmbH/2025/priority/
HIGH-VALUE 접두사 (금액 > 10k)/priority (DRINGEND = 긴급)

인증

모든 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는 문서를 읽고 내용을 이해합니다.

Regex / 패턴 매칭

입력:

scan_001.pdf

패턴:

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

출력:

document_001.pdf

  • 문서 내용을 읽을 수 없음
  • 공급업체, 금액, 날짜를 추출할 수 없음
  • 조건부 로직을 적용할 수 없음
  • 여러 언어를 이해할 수 없음
맞춤 지침이 있는 AI

입력:

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 파일 업로드

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 - JSON 본문, 서버가 파일을 가져옴

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

SDK

타입 안정성과 오류 처리를 포함한 더 나은 개발자 경험을 위해 공식 SDK를 사용하세요.

TypeScript SDK 예제

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"

응답

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

GitHub의 SDK: github.com/renamed-to/renamed-sdk

API 매개변수

AI의 동작을 제어하기 위한 주요 매개변수입니다.

매개변수값설명
strategyfollow_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 를 사용하세요
templateModeauto, predefined, customcustomTemplate를 사용할 때는 custom 로 설정하세요
customTemplatestringAI를 위한 자연어 지침
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
출력 파일명 언어입니다. 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를 워크플로에 통합하세요.

1

API Playground에서 사용해보기

코드를 작성하기 전에 지침을 대화형으로 테스트하세요.

2

API 토큰 받기

대시보드에서 API 토큰을 생성하세요. 가입 시 50개의 무료 크레딧이 제공됩니다.

3

통합

SDK를 사용하거나 애플리케이션에서 직접 REST 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일 환불 보장이 제공됩니다.