Anthropic, Claude Opus 4.7 Files API 정식 GA — 파일 재업로드 없이 멀티턴 재사용

Files API란 무엇인가

Files API는 이미지·PDF·텍스트 등 파일을 Anthropic 서버에 한 번 업로드하면 file_id를 발급받아 이후 모든 요청에서 해당 ID만 참조하는 방식이다. 기존에는 멀티턴 대화나 배치 처리를 할 때마다 동일 파일을 Base64로 인코딩해 반복 전송해야 했고, 이는 입력 토큰 수 증가와 네트워크 오버헤드로 직결됐다.

주요 스펙 및 제한

• 보관 기간: 업로드 후 최대 30일, 수동 삭제 가능
• 단일 파일 최대 크기: 500 MB
• 지원 형식: PDF, 텍스트(.txt, .md, .csv), 이미지(PNG·JPEG·WEBP·GIF), 오디오(MP3·WAV) — 모델별 지원 형식 상이
• 적용 모델: Claude Opus 4.7, Claude Sonnet 4.6, Claude Haiku 4.5 전부 지원
• 가격: 파일 저장 자체에 별도 스토리지 요금 없음, 실제 참조 시 입력 토큰으로 과금 — 상세 단가는 공식 페이지 참조

import anthropic

client = anthropic.Anthropic()

# 파일 업로드 (최초 1회)
with open("spec.pdf", "rb") as f:
    file_obj = client.files.upload(
        file=("spec.pdf", f, "application/pdf")
    )
file_id = file_obj.id  # 30일간 유효

# 이후 멀티턴에서 file_id 재사용
response = client.messages.create(
    model="claude-opus-4-7",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "file", "file_id": file_id},
                {"type": "text", "text": "3페이지 요구사항 요약해줘"}
            ]
        }
    ]
)

한국 개발자 실전 활용 포인트

RAG 파이프라인 비용 절감: 동일 컨텍스트 문서를 수백 번 조회하는 검색 증강 생성 파이프라인에서 반복 업로드 토큰을 제거하면 입력 비용이 최대 수십 % 감소할 수 있다. 특히 Opus 4.7처럼 입력 단가가 높은 모델일수록 효과가 크다.

배치 작업 간소화: 야간 배치로 수천 건의 계약서·리포트를 처리할 때, 공통 가이드라인 파일을 한 번 올려두고 각 배치 요청에서 file_id만 참조하면 된다.

주의 사항: 30일 후 자동 만료되므로 장기 프로젝트에서는 만료일 관리 로직을 별도로 구현해야 한다. 민감 데이터는 Anthropic의 데이터 보존 정책을 먼저 확인할 것.