Hugging Face Inference API 무료 한도
Hugging Face Inference Providers는 여러 추론 제공업체의 오픈 모델을 위한 하나의 API입니다. 예전에는 모든 계정에 소액의 무료 월간 크레딧이 포함되었습니다. 오늘날 공식 가격 페이지는 무료 사용자에게 월간 크레딧을 나열하지 않습니다. 이 가이드는 현재 규칙, 402 오류, 무료 옵션을 설명합니다.
코드, 모델 이름, 실시간 카탈로그 레이블은 영어로 표시합니다.
현재 무료 한도
Inference Providers의 Hugging Face 가격 페이지에는 계정 유형별 월간 크레딧 표가 있습니다. 무료 사용자에게는 월간 크레딧이 없습니다. 크레딧을 구매하거나 PRO로 업그레이드해야만 Inference Providers를 사용할 수 있습니다.
| 계정 유형 | 월간 크레딧 | 종량제 |
|---|---|---|
| 무료 사용자 | 없음 | 예, 크레딧 구매 필요 |
| PRO 사용자 | $2.00 | 예 |
| Team 또는 Enterprise 조직 | 좌석당 $2.00, 조직 내 공유 | 예 |
PRO와 Team 크레딧은 범용 컴퓨트 크레딧입니다. Inference Endpoints, Spaces 하드웨어, Jobs에도 사용할 수 있습니다. Hugging Face는 추가 수수료 없이 제공업체 요금을 청구합니다.
오류 402가 발생하는 이유
HTTP 402는 결제가 필요하다는 뜻입니다. Inference Providers에서는 계정에 크레딧이 남지 않았을 때 보통 이 오류가 발생합니다. 구매한 크레딧이 없는 무료 계정에서는 첫 유료 요청이 402를 반환할 수 있습니다.
| 원인 | 해결 방법 |
|---|---|
| 구매한 크레딧이 없는 무료 계정 | 결제 페이지에서 크레딧을 구매하거나 PRO로 업그레이드하십시오 |
| 이번 달 PRO 크레딧을 모두 사용함 | 다음 달까지 기다리거나, 크레딧을 더 구매하십시오 |
| 요청 비용이 크레딧이 없는 조직에 청구됨 | X-HF-Bill-To 헤더를 제거하거나, 조직 관리자에게 크레딧 추가를 요청하십시오 |
조직이 제공업체를 비활성화하면 다른 오류가 발생할 수 있습니다. 이름으로 그 제공업체를 요청하면 요청이 실패합니다. 자동 제공업체 선택을 사용하거나 다른 제공업체를 고르십시오.
사용량은 Inference Providers 설정 페이지에서 확인하십시오. 지난 한 달의 사용량을 모델별, 제공업체별로 보여 줍니다.
API 작동 방식
- Hugging Face에 로그인하고 토큰 설정을 여십시오.
- 세분화된 토큰(fine-grained token)을 만드십시오.
- 토큰에 권한 "Make calls to Inference Providers"를 부여하십시오.
- 토큰을
HF_TOKEN환경 변수에 저장하십시오. - 크레딧을 구매하거나 PRO로 업그레이드하십시오. 크레딧이 없으면 무료 계정은 유료 요청을 완료할 수 없습니다.
Inference Providers는 채팅 완성용 OpenAI 호환 엔드포인트 https://router.huggingface.co/v1를 제공합니다. Inference Providers 호출 권한이 있는 세분화된 Hugging Face 토큰으로 인증합니다.
Hugging Face 토큰을 사용하는 OpenAI 클라이언트
import os
from openai import OpenAI
client = OpenAI(
base_url="https://router.huggingface.co/v1",
api_key=os.environ["HF_TOKEN"],
)
resp = client.chat.completions.create(
model="deepseek-ai/DeepSeek-V4.1-Flash:fastest",
messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)- 처리량이 가장 높은 제공업체를 고르려면 모델 ID에
:fastest를 추가하십시오. - 가격이 가장 낮은 제공업체를 고르려면
:cheapest를 추가하십시오. - 제공업체 하나를 고르려면 제공업체 이름을 추가하십시오. 예:
:novita. - OpenAI 호환 엔드포인트는 채팅 전용입니다. 이미지, 임베딩, 음성에는 Hugging Face 클라이언트 라이브러리를 사용하십시오.
Inference Providers에 적합한 용도
- 많은 오픈 모델 테스트: 프로덕션용으로 하나를 고르기 전에 토큰 하나로 테스트합니다.
- 다른 곳에서는 드문 모델: 예를 들어 새로 공개된 오픈 웨이트 모델과 특수 작업 모델.
- 이미지, 비디오, 오디오 모델: Hugging Face 클라이언트 라이브러리를 통해.
- 이미 PRO 또는 Team에 비용을 내는 팀: 포함된 크레딧이 먼저 적용되기 때문입니다.
Hub에서 많은 오픈 모델을 내려받아 내 하드웨어에서 실행할 수도 있습니다. llama.cpp, vLLM, Ollama 같은 도구가 로컬에서 이를 제공합니다. 로컬 추론에는 API 크레딧이 들지 않지만 GPU 또는 빠른 컴퓨터가 필요합니다. FreeLLMAPI는 무료 클라우드 등급과 함께 로컬 OpenAI 호환 서버를 사용자 지정 제공업체로 추가할 수 있습니다.
Inference Providers는 일상적인 사용을 위한 무료 API가 아닙니다. 월간 크레딧이 없으면 무료 계정은 구매 이후 모든 요청에 비용을 냅니다. $2.00 PRO 크레딧도 에이전트나 채팅 앱에는 적습니다.
오픈 모델을 위한 무료 옵션
Hugging Face의 많은 오픈 모델은 다른 제공업체에서도 주기적 무료 등급을 제공합니다. 아래 표는 오늘 카탈로그에서 가장 성능이 좋은 무료 모델을 보여 줍니다.
| 모델 | 무료 제공 | 컨텍스트 | 무료 한도 (가장 좋은 조건) | 도구 | 비전 |
|---|---|---|---|---|---|
| GLM 5.3 | APINex, UnoRouter | 1M | 5 요청/분 10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account | 예 | 아니요 |
| Qwen3.8 Max | ACLIDE | - | €20/month shared internal usage credits · no card | 예 | 아니요 |
| GLM 5.3 Flash | APINex, BlazeAPI, NVIDIA NIM +1개 더 | 1M | 40 요청/분 40 RPM | 예 | 예 |
| Gemini 3.8 Flash | APINex, Google AI Studio | 1M | 5 요청/분 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | 예 | 예 |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| Qwen3.8 Flash Next | AMD Radeon Cloud, BlazeAPI, ElectronHub | 262K | Recurring daily account allowance | 예 | 아니요 |
| Qwen3.8 Flash | ElectronHub, Inferbase | 1M | $0.25/week shared recurring credit | 예 | 예 |
| Deepseek V4.1 Flash | APINex | 1M | 5 요청/분 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | 아니요 | 아니요 |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | 예 | 예 |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 요청/분 50 요청/일 50 req/day account-wide (1,000 after a $10 purchase) | 예 | 예 |
| Agnes 3.0 Flash | Agnes AI | - | Promo $0/token | 아니요 | 아니요 |
일치하는 무료 모델 354개 중 12개를 표시합니다. 모든 모델 보기.
FreeLLMAPI 카탈로그의 실시간 데이터입니다 (버전 2026.11.19, 2026-11-19 확인). 무료 한도는 자주 바뀝니다. 카탈로그는 매일 확인합니다.
FreeLLMAPI에는 Hugging Face 어댑터가 있습니다. 무료 계정은 주기적 크레딧이 없으므로, 오늘의 무료 카탈로그에는 Hugging Face 항목이 없습니다. 키 하나로 무료 오픈 모델을 쓰려면 표의 제공업체 키를 추가하십시오. 한 제공업체가 요청 한도 오류를 반환하면 라우터는 다음 제공업체로 넘어갑니다.
자주 묻는 질문
Hugging Face Inference API는 무료입니까?
무료 계정에는 해당하지 않습니다. 현재 가격 페이지는 무료 사용자에게 월간 크레딧을 나열하지 않습니다. 무료 사용자는 크레딧을 구매하거나 PRO로 업그레이드해야 하며, PRO에는 월 $2.00의 컴퓨트 크레딧이 포함됩니다.
무료 Hugging Face 사용자는 여전히 월 $0.10을 받습니까?
오늘의 공식 가격 페이지에는 나오지 않습니다. 무료 사용자에게 월간 크레딧이 없다고 나옵니다. 예전 페이지와 일부 문서 미러는 여전히 $0.10 수치를 보여 줍니다.
Hugging Face가 오류 402 Payment Required를 반환하는 이유는 무엇입니까?
계정 또는 청구 대상 조직에 남은 크레딧이 없습니다. 크레딧을 구매하거나, PRO로 업그레이드하거나, 다음 월간 PRO 크레딧까지 기다리십시오.
Hugging Face 라우터는 OpenAI 호환입니까?
채팅 완성에 대해서는 예입니다. 기본 URL을 https://router.huggingface.co/v1로 설정하고, Hugging Face 토큰을 API 키로 사용하십시오.
Hugging Face Inference의 무료 대안은 무엇입니까?
Groq, NVIDIA NIM, Cloudflare Workers AI, OVH AI Endpoints처럼 오픈 모델에 주기적 무료 등급을 제공하는 제공업체를 사용하십시오. FreeLLMAPI는 이들을 키 하나 뒤에 묶습니다.
관련 가이드
출처
- Hugging Face docs: Inference Providers pricing and billing (20 November 2026 확인)
- Hugging Face docs: Inference Providers (20 November 2026 확인)
- UsagePricing: Hugging Face free inference credits removed (15 October 2026) (20 November 2026 확인)
- FreeLLMAPI docs: Supported platforms (20 November 2026 확인)