Hugging Face(https://huggingface.co) 게이트 모델 접근 요청과 무료 계정 다운로드 제한
Hugging Face(https://huggingface.co) 게이트 자세히 보기 >
Hugging Face는 AI 모델과 데이터셋, 데모 앱(Spaces)을 공유하는 모델 허브입니다. 계정 없이도 공개 모델을 받을 수 있지만, 게이트 모델은 접근 요청이 필요하고 요청 횟수에도 한도가 있습니다. 아래에서 Hugging Face 게이트 모델 접근 요청, 액세스 토큰, 요청 제한과 429 오류, 저장 용량, Spaces 무료 범위, PRO 결제까지 정리했습니다.
체크 포인트
게이트 모델은 브라우저에서만 접근 요청 — 거절되면 다시 요청할 수 없습니다 · 429 오류 1순위 원인은 토큰 누락 — 무료 계정은 5분에 파일 받기 5,000회입니다 · 무료 계정 비공개 저장은 100GB — 파일 하나는 최대 500GB입니다
Hugging Face 게이트 모델 접근 요청 — 브라우저에서만
Hugging Face의 일부 모델은 작성자가 접근 요청(게이트)을 걸어 둡니다. 이런 모델은 로그인 없이 파일을 받을 수 없습니다.
| 구분 | 내용 |
|---|---|
| 로그인 | 필수 |
| 요청 방법 | 브라우저에서만, 모델 페이지에서 동의 |
| 공유되는 정보 | 사용자명·이메일(추가 항목이 있을 수 있음) |
| 자동 승인 | 동의 즉시 파일 접근 |
| 수동 승인 | 작성자가 직접 승인할 때까지 대기 |
| 승인 단위 | 조직이 아니라 개인 |
막히는 지점은 세 가지입니다.
- 접근 요청은 프로그램이나 터미널에서 할 수 없습니다. 브라우저로 모델 페이지에 들어가 동의해야 합니다.
- 작성자가 거절하면 다시 요청할 수 없습니다. 페이지에 “요청이 거절됐다”는 문구가 뜹니다.
- 이미 승인됐어도 작성자는 언제든 예고 없이 접근을 막을 수 있습니다.
승인된 뒤 스크립트로 파일을 받으려면 토큰으로 로그인해야 합니다. 터미널에서 hf auth login을 실행하거나, 내려받는 함수에 token 값을 넘깁니다. 브라우저에서는 로그인만 돼 있으면 자동으로 됩니다.
조직 계정으로 승인받는 방식은 없습니다. 같은 팀이라도 각자 요청해야 합니다. 일부 모델은 라이선스 때문에 유럽연합 지역 사용자의 접근을 막아 두기도 합니다.
Hugging Face 액세스 토큰 종류와 발급
액세스 토큰은 비밀번호 대신 쓰는 열쇠입니다. 역할이 세 가지입니다.
| 구분 | 내용 |
|---|---|
| read | 읽을 수 있는 저장소를 읽기만 |
| write | 쓰기 권한 있는 저장소에 올리기까지 |
| fine-grained | 특정 모델·조직으로 범위를 좁힌 권한 |
| 발급 | 설정 > Access Tokens > New token |
| 관리 | Manage 에서 삭제·갱신 |
| git 인증 | 비밀번호 자리에 토큰 입력 |
공식 문서는 용도마다 토큰을 따로 만들라고 권합니다. 내 컴퓨터용, 노트북 환경용, 서버용을 나눠 두면 하나만 폐기해도 나머지는 그대로 쓸 수 있습니다. 실제 서비스에는 fine-grained 토큰만 쓰라고 안내합니다.
토큰이 노출되면 바로 삭제하거나 갱신합니다. 그 전까지는 누구나 그 토큰으로 내 비공개 저장소를 읽고 쓸 수 있습니다. 남의 토큰을 발견했다면 /api/credentials/revoke 주소로 보내 즉시 무효화할 수 있고, 이때 그 계정에 대한 권한은 필요 없습니다. 응답은 토큰이 있든 없든 항상 202이고, 토큰 주인에게는 메일이 한 번 갑니다.
Hugging Face 요청 제한과 429 오류
요청은 세 갈래로 나눠 5분 고정 창으로 셉니다. API는 검색·저장소 생성 같은 호출, 파일 받기(Resolvers)는 모델 파일 내려받기, 페이지는 웹 화면입니다.
| 구분 | 5분당 요청 |
|---|---|
| 비로그인(IP당) | API 500 · 파일 받기 3,000 · 페이지 100 |
| 무료 계정 | API 1,000 · 파일 받기 5,000 · 페이지 200 |
| PRO | API 2,500 · 파일 받기 12,000 · 페이지 400 |
| Team 조직 | API 3,000 · 파일 받기 20,000 · 페이지 400 |
| 초과 시 | 429 Too Many Requests |
| 조직 한도 | 구성원끼리 나누지 않고 사람마다 따로 |
이 값은 2025년 9월에 공개된 것이고, 비로그인과 무료 계정 한도는 플랫폼 상황에 따라 바뀔 수 있다고 적혀 있습니다.
429가 나면 이 순서로 봅니다.
- HF_TOKEN을 넘기고 있는지 확인합니다. 공식 문서가 꼽는 1순위 원인이고, 토큰이 없으면 비로그인 IP 기준으로 계산됩니다.
- 설정 > Billing 화면의 게이지 3개에서 지난 5분 사용량을 봅니다. 넘으면 막대가 빨갛게 바뀝니다.
- 요청을 더 긴 시간에 나눠 보내고, 가능하면 API 호출 대신 한도가 높은 파일 받기 경로를 씁니다.
- 그래도 모자라면 PRO·Team·Enterprise 로 올립니다.
공식 파이썬 라이브러리 huggingface_hub 1.2.0 이상은 429를 받으면 응답 헤더에서 남은 초를 읽어 그만큼 기다린 뒤 다시 시도합니다.
Hugging Face 저장 용량과 업로드 한계
저장 용량은 계정 전체에 걸리고, 공개와 비공개가 따로 계산됩니다.
| 구분 | 내용 |
|---|---|
| 무료 계정 비공개 | 100GB |
| 무료 계정 공개 | 운영 판단(best-effort) |
| PRO | 비공개 1TB + 종량제, 공개 최대 10TB |
| 비공개 초과 | 1TB당 월 $18 |
| 공개 추가(유료 계정) | 1TB 월 $12부터 |
| 단일 파일 | 최대 500GB, 200GB 미만 분할 권장 |
무료 공개 저장소도 무한정은 아닙니다. 처음 몇 GB를 넘으면 다른 사용자에게 쓸모 있는 자료를 올려 달라고 하고, 좋아요나 다운로드 수 같은 활용도를 봅니다.
저장소 구조에도 한계가 있습니다. 한 폴더에는 파일을 1만 개 넘게 둘 수 없어 하위 폴더로 나눠야 하고, 저장소 전체 파일은 10만 개 미만을 권합니다. HTTP로 커밋할 때는 요청 하나에 60초 제한이 있어, 직접 커밋한다면 50~100개씩 나눠 올리라고 안내합니다. 공식 업로드 명령(hf upload)은 큰 폴더를 알아서 여러 커밋으로 나눕니다.
Hugging Face Spaces 무료로 되는 것과 안 되는 것
Spaces는 모델 데모 앱을 올리는 공간입니다. 무료 계정으로 되는 범위가 바뀌었습니다.
| 구분 | 내용 |
|---|---|
| 정적(Static) Spaces | 누구나 무료 |
| Gradio·Docker 새로 만들기 | 유료 요금제 필요(개인은 PRO) |
| 무료 계정 ZeroGPU | Gradio Spaces 최대 2개 |
| PRO ZeroGPU | 최대 10개 |
| CPU Basic | 2 vCPU · 16GB · 디스크 50GB(비영구), 무료 |
| 잠자기 | 48시간 미사용 시, 방문하면 다시 시작 |
예전 안내처럼 무료 계정으로 Gradio나 Docker Spaces를 새로 만들 수는 없습니다. 무료 CPU Basic 하드웨어 자체는 시간당 요금이 없지만, 그 위에서 돌아가는 Spaces를 만드는 데 유료 요금제가 필요합니다.
디스크 50GB는 영구 저장이 아니라 다시 시작하면 사라집니다. 무료 하드웨어 Spaces는 48시간 동안 아무도 쓰지 않으면 잠들고, 누군가 방문하면 자동으로 다시 켜집니다. 잠들지 않게 하거나 잠자기 시간을 바꾸려면 유료 하드웨어로 올려야 합니다. 유료 하드웨어로 올린 Spaces는 기본적으로 잠들지 않아 계속 요금이 나가므로, 멈추려면 CPU Basic으로 되돌리거나 일시정지합니다.
Hugging Face PRO 요금과 결제 규칙
PRO 구독은 월 9달러입니다. 저장 용량, 요청 한도, Spaces 기능이 늘어납니다.
| 구분 | 내용 |
|---|---|
| 결제 수단 | 신용카드만 |
| 갱신일 | 모든 구독이 매월 1일 |
| 첫 달 | 가입일부터 일할 계산 |
| 해지 | 설정 > Billing > Subscription |
| 결제수단 삭제 | 구독 해지, 결제 기간 끝까지 유지 |
| 사용량 요금 | 구독과 별도로 청구 |
공식 결제 FAQ에는 가입하고 며칠 만에 또 결제됐다는 질문이 실려 있습니다. 구독은 가입일이 아니라 매월 1일에 갱신되고, 첫 달은 가입한 날부터 일할로 계산하기 때문입니다.
카드는 3D 보안 인증을 지원하고 정기결제가 가능하게 설정돼 있어야 등록됩니다. 결제수단을 지우면 구독이 해지되는데, 새 카드를 등록하는 것만으로는 되살아나지 않습니다. 결제 기간이 끝나기 전에 결제 화면에서 Resubscribe 를 눌러야 합니다.
GPU Spaces나 추론 서비스 같은 사용량 요금은 PRO 구독료와 따로 청구되고, 청구서는 매달 초에 나옵니다. 지난 청구서는 설정 > Billing > Invoices 에서 받습니다. 결제 문의는 billing@huggingface.co 입니다.
Hugging Face 자주 묻는 질문
Q. Hugging Face 게이트 모델은 어떻게 받나요?
로그인한 뒤 브라우저에서 모델 페이지에 들어가 사용자명과 이메일 공유에 동의해 접근을 요청합니다. 자동 승인이면 바로, 수동 승인이면 작성자가 승인한 뒤 받을 수 있고, 스크립트로 받을 때는 hf auth login 으로 토큰 로그인을 해야 합니다.
Q. Hugging Face 게이트 모델 요청이 거절되면 다시 요청할 수 있나요?
다시 요청할 수 없습니다. 작성자가 거절하면 그 모델에 접근할 수 없고 재요청도 막힙니다. 이미 승인된 경우에도 작성자는 언제든 예고 없이 접근을 막을 수 있습니다.
Q. Hugging Face에서 429 오류가 나요.
5분 동안 허용된 요청 수를 넘었다는 뜻입니다. 가장 흔한 원인은 HF_TOKEN 을 넘기지 않은 것으로, 토큰이 없으면 비로그인 IP 기준으로 계산됩니다. 무료 계정은 5분에 파일 받기 5,000회, 비로그인은 3,000회입니다.
Q. Hugging Face 무료 계정 저장 용량은 얼마인가요?
비공개 저장소는 100GB이고 공개 저장소는 정해진 숫자 없이 운영 판단으로 제공합니다. 파일 하나는 최대 500GB이고, 한 폴더에 파일을 1만 개 넘게 둘 수 없습니다.
Q. Hugging Face PRO는 얼마이고 언제 결제되나요?
월 9달러이고 신용카드로만 결제합니다. 모든 구독은 매월 1일에 갱신되며, 첫 달은 가입일부터 일할로 계산되어 가입 직후 1일에 다시 결제될 수 있습니다.
Hugging Face 에서 게이트 모델을 받으려면 로그인한 뒤 브라우저에서 접근 요청에 동의해야 하고, 거절되면 다시 요청할 수 없습니다. 승인된 뒤 스크립트로 받을 때는 hf auth login 으로 토큰 로그인을 해야 합니다. 요청은 5분 단위로 세며 무료 계정은 파일 받기 5,000회, 비로그인은 3,000회이고, 429 오류의 1순위 원인은 HF_TOKEN 을 넘기지 않은 것입니다. 무료 계정의 비공개 저장은 100GB, 파일 하나는 최대 500GB, 한 폴더에는 1만 개까지입니다. Spaces는 정적 앱만 무료로 만들 수 있고 Gradio·Docker는 유료 요금제가 필요하며, 무료 계정은 ZeroGPU Gradio Spaces를 2개까지 둡니다. PRO는 월 9달러, 신용카드 전용이고 모든 구독이 매월 1일에 갱신됩니다.