Darmowy limit API Hugging Face Inference
Hugging Face Inference Providers to jedno API dla otwartych modeli od wielu dostawców wnioskowania. Kiedyś każde konto dostawało mały miesięczny kredyt za darmo. Dziś oficjalna strona cennika nie podaje miesięcznego kredytu dla użytkowników darmowych. Ten poradnik wyjaśnia obecne zasady, błąd 402 i darmowe opcje.
Kod, nazwy modeli i etykiety z katalogu na żywo są podane po angielsku.
Obecny darmowy limit
Strona cennika Hugging Face dla Inference Providers zawiera tabelę miesięcznych kredytów dla każdego typu konta. Użytkownicy darmowi nie dostają miesięcznego kredytu. Mogą używać Inference Providers tylko po zakupie kredytów albo po przejściu na PRO.
| Typ konta | Miesięczny kredyt | Płatność za użycie |
|---|---|---|
| Użytkownik darmowy | Brak | Tak, wymagany zakup kredytów |
| Użytkownik PRO | $2.00 | Tak |
| Organizacja Team lub Enterprise | 2,00 USD na miejsce, wspólne w organizacji | Tak |
Kredyty PRO i Team to ogólne kredyty obliczeniowe. Możesz je wydać też na Inference Endpoints, sprzęt Spaces i Jobs. Hugging Face pobiera stawkę dostawcy bez dodatkowej opłaty.
Dlaczego pojawia się błąd 402
HTTP 402 oznacza wymaganą płatność. W Inference Providers zwykle pojawia się, gdy na koncie nie ma już kredytu. Na darmowym koncie bez zakupionego kredytu pierwsze płatne żądanie może zwrócić 402.
| Przyczyna | Rozwiązanie |
|---|---|
| Darmowe konto bez zakupionego kredytu | Kup kredyty na stronie rozliczeń albo przejdź na PRO |
| Kredyt PRO na ten miesiąc został wykorzystany | Poczekaj na następny miesiąc albo kup więcej kredytów |
| Żądanie obciąża organizację, która nie ma kredytu | Usuń nagłówek X-HF-Bill-To albo poproś administratora organizacji o dodanie kredytu |
Inny błąd może wystąpić, gdy organizacja wyłączy dostawcę. Jeśli zażądasz tego dostawcy po nazwie, żądanie się nie uda. Użyj automatycznego wyboru dostawcy albo wybierz innego dostawcę.
Zużycie sprawdzisz na stronie ustawień Inference Providers. Pokazuje zużycie z poprzedniego miesiąca według modelu i dostawcy.
Jak działa API
- Zaloguj się do Hugging Face i otwórz ustawienia tokenów.
- Utwórz token typu fine-grained.
- Nadaj tokenowi uprawnienie "Make calls to Inference Providers".
- Zapisz token w zmiennej środowiskowej
HF_TOKEN. - Kup kredyty albo przejdź na PRO. Bez kredytu darmowe konto nie może zrealizować płatnych żądań.
Inference Providers ma punkt końcowy zgodny z OpenAI dla chat completions pod adresem https://router.huggingface.co/v1. Uwierzytelniasz się tokenem Hugging Face typu fine-grained, który ma uprawnienie do wywołań Inference Providers.
Klient OpenAI z tokenem Hugging Face
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)- Dodaj
:fastestdo identyfikatora modelu, aby wybrać dostawcę z najwyższą przepustowością. - Dodaj
:cheapest, aby wybrać dostawcę z najniższą ceną. - Dodaj nazwę dostawcy, na przykład
:novita, aby wybrać jednego dostawcę. - Punkt końcowy zgodny z OpenAI służy tylko do czatu. Do obrazów, osadzeń i mowy użyj bibliotek klienckich Hugging Face.
Do czego nadaje się Inference Providers
- Testowanie wielu otwartych modeli jednym tokenem, zanim wybierzesz jeden do produkcji.
- Modele rzadko dostępne gdzie indziej, na przykład nowe wydania o otwartych wagach i modele do specjalnych zadań.
- Modele obrazów, wideo i audio przez biblioteki klienckie Hugging Face.
- Zespoły, które już płacą za PRO lub Team, bo zawarty kredyt jest zużywany najpierw.
Wiele otwartych modeli możesz też pobrać z Hub i uruchomić na własnym sprzęcie. Narzędzia takie jak llama.cpp, vLLM i Ollama udostępniają je lokalnie. Wnioskowanie lokalne nie kosztuje kredytu API, ale potrzebujesz GPU albo szybkiego komputera. FreeLLMAPI może dodać lokalny serwer zgodny z OpenAI jako własnego dostawcę, obok darmowych planów w chmurze.
Inference Providers nie jest darmowym API do codziennego użycia. Bez miesięcznego kredytu darmowe konto płaci za każde żądanie po zakupie. Kredyt PRO w wysokości 2,00 USD jest też mały dla agenta albo aplikacji czatu.
Darmowe opcje dla otwartych modeli
Wiele otwartych modeli na Hugging Face ma też cykliczne darmowe plany u innych dostawców. Tabela pokazuje najmocniejsze darmowe modele z dzisiejszego katalogu.
| Model | Za darmo w | Kontekst | Darmowe limity (najlepsza oferta) | Narzędzia | Wizja |
|---|---|---|---|---|---|
| GLM 5.3 | APINex, UnoRouter | 1M | 5 żądań/min 10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account | Tak | Nie |
| Qwen3.8 Max | ACLIDE | - | €20/month shared internal usage credits · no card | Tak | Nie |
| GLM 5.3 Flash | APINex, BlazeAPI, NVIDIA NIM +1 więcej | 1M | 40 żądań/min 40 RPM | Tak | Tak |
| Gemini 3.8 Flash | APINex, Google AI Studio | 1M | 5 żądań/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Tak | Tak |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 żądań/min 20 żądań/dzień 250,000 tokenów/min ~3M | Tak | Tak |
| Qwen3.8 Flash Next | AMD Radeon Cloud, BlazeAPI, ElectronHub | 262K | Recurring daily account allowance | Tak | Nie |
| Qwen3.8 Flash | ElectronHub, Inferbase | 1M | $0.25/week shared recurring credit | Tak | Tak |
| Deepseek V4.1 Flash | APINex | 1M | 5 żądań/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Nie | Nie |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 żądań/min 20 żądań/dzień 250,000 tokenów/min ~3M | Tak | Tak |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Tak | Tak |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 żądań/min 50 żądań/dzień 50 req/day account-wide (1,000 after a $10 purchase) | Tak | Tak |
| Agnes 3.0 Flash | Agnes AI | - | Promo $0/token | Nie | Nie |
Pokazano 12 z 354 pasujących darmowych modeli. Zobacz wszystkie modele.
Dane na żywo z katalogu FreeLLMAPI (wersja 2026.11.19, sprawdzono 2026-11-19). Darmowe limity często się zmieniają. Katalog jest sprawdzany codziennie.
FreeLLMAPI ma adapter Hugging Face. Dzisiejszy darmowy katalog nie ma wierszy Hugging Face, bo darmowe konta nie dostają cyklicznego kredytu. Aby używać darmowych otwartych modeli z jednym kluczem, dodaj klucze od dostawców z tabeli. Router przechodzi do następnego dostawcy, gdy jeden zwróci błąd limitu szybkości.
Najczęstsze pytania
Czy API Hugging Face Inference jest darmowe?
Nie dla darmowych kont. Obecna strona cennika nie podaje miesięcznego kredytu dla użytkowników darmowych. Muszą kupić kredyty albo przejść na PRO, które zawiera 2,00 USD kredytu obliczeniowego miesięcznie.
Czy darmowi użytkownicy Hugging Face nadal dostają 0,10 USD miesięcznie?
Oficjalna strona cennika tego dziś nie pokazuje. Nie podaje miesięcznego kredytu dla użytkowników darmowych. Starsze strony i niektóre kopie dokumentacji nadal pokazują wartość 0,10 USD.
Dlaczego Hugging Face zwraca błąd 402 Payment Required?
Twoje konto albo rozliczana organizacja nie ma już kredytu. Kup kredyty, przejdź na PRO albo poczekaj na następny miesięczny kredyt PRO.
Czy router Hugging Face jest zgodny z OpenAI?
Tak, dla chat completions. Ustaw adres bazowy na https://router.huggingface.co/v1 i użyj tokenu Hugging Face jako klucza API.
Jaka jest darmowa alternatywa dla Hugging Face Inference?
Użyj dostawców z cyklicznymi darmowymi planami dla otwartych modeli, takich jak Groq, NVIDIA NIM, Cloudflare Workers AI albo OVH AI Endpoints. FreeLLMAPI łączy ich za jednym kluczem.
Powiązane poradniki
- Darmowe bazowe URL-e API zgodne z OpenAI
- Darmowe API LLM bez karty kredytowej
- Darmowe API LLM: limity żądań
- Darmowe API OVH AI Endpoints
- Darmowe API embeddings
Źródła
- Hugging Face docs: Inference Providers pricing and billing (sprawdzono 20 November 2026)
- Hugging Face docs: Inference Providers (sprawdzono 20 November 2026)
- UsagePricing: Hugging Face free inference credits removed (15 October 2026) (sprawdzono 20 November 2026)
- FreeLLMAPI docs: Supported platforms (sprawdzono 20 November 2026)