Claude 공식 릴리스 노트의 새 항목을 AI가 분석·정리한 글입니다. 정확한 내용은 하단 원문에서 확인해 주세요.
🤖 AI 분석 (Claude)
Files API가 베타에서 정식 가용(GA) 상태로 전환되었습니다. 더 이상 files-api-2025-04-14 베타 헤더를 필수로 포함할 필요가 없습니다.
GA 응답 형식은 파일 만료 관리(expires_in_seconds 설정, expires_at 조회), 페이지 기반 페이지네이션, ids[] 필터를 지원합니다. 조직당 1TB 저장소와 분당 500개 요청의 속도 제한이 적용됩니다.
왜 중요한가
베타 기능에서 정식 기능으로 전환되어 프로덕션 환경에서 안정적으로 사용할 수 있습니다. 파일 만료 관리와 효율적인 페이지네이션으로 대규모 파일 처리가 더 체계적으로 가능해집니다.
이전과 다른 점
이전에는 files-api-2025-04-14 베타 헤더를 반드시 포함해야 했고, 이전 응답 형식을 사용했습니다. 이제는 헤더 없이 요청할 수 있으며, expires_at 형식의 파일 만료 정보와 page/next_page 페이지네이션이 제공됩니다.
실제로 써보려면
/v1/files 엔드포인트 요청 시 files-api-2025-04-14 베타 헤더를 제거하면 GA 응답 형식을 사용합니다. 파일 업로드 시 expires_in_seconds 파라미터를 설정하여 파일 만료를 관리할 수 있습니다.
⚠️ AI가 원문을 바탕으로 생성한 분석입니다. 사실 확인은 아래 원문에서 해 주세요.
변경 내용 (원문)
The Files API is now generally available on the Claude API. Requests to the /v1/files endpoints, and Messages API requests that reference an uploaded file, no longer require the files-api-2025-04-14 beta header. Requests sent without the header use the GA response format: file expiration (set expires_in_seconds when you upload a file; file objects report expires_at), and page and next_page pagination plus an ids[] filter when you list files. Storage is 1 TB per organization and the rate limit is 500 requests per minute. /v1/files requests that still send the beta header keep working and return the previous response format.
출처: Claude Platform 릴리스 노트 (원문 보기)