Hugging Face Inference API ücretsiz limiti
Hugging Face Inference Providers, birçok çıkarım sağlayıcısından açık modeller için tek bir API'dir. Eskiden her hesap için küçük bir aylık ücretsiz kredi içerirdi. Bugün resmi fiyatlandırma sayfası ücretsiz kullanıcılar için aylık kredi listelemez. Bu rehber geçerli kuralları, 402 hatasını ve ücretsiz seçenekleri açıklar.
Kod, model adları ve canlı katalog etiketleri İngilizce gösterilir.
Geçerli ücretsiz limit
Hugging Face'in Inference Providers fiyatlandırma sayfasında hesap türüne göre aylık kredi tablosu vardır. Ücretsiz kullanıcılar aylık kredi almaz. Inference Providers'ı yalnızca kredi satın aldıklarında veya PRO'ya yükselttiklerinde kullanabilirler.
| Hesap türü | Aylık kredi | Kullandıkça öde |
|---|---|---|
| Ücretsiz kullanıcı | Yok | Evet, kredi satın alımı gerekir |
| PRO kullanıcı | $2.00 | Evet |
| Ekip veya Enterprise kuruluşu | Koltuk başına 2,00 $, kuruluş içinde paylaşılır | Evet |
PRO ve Ekip kredileri genel hesaplama kredileridir. Bunları Inference Endpoints, Spaces donanımı ve Jobs için de harcayabilirsiniz. Hugging Face, sağlayıcı fiyatını ek ücret almadan uygular.
402 hatası neden alınır
HTTP 402, ödeme gerektiği anlamına gelir. Inference Providers'ta bu genellikle hesabınızda kredi kalmadığında alınır. Satın alınmış kredisi olmayan ücretsiz bir hesapta ilk ücretli istek 402 döndürebilir.
| Neden | Çözüm |
|---|---|
| Satın alınmış kredisi olmayan ücretsiz hesap | Faturalandırma sayfasından kredi satın alın veya PRO'ya yükseltin |
| Bu ayki PRO kredisi harcandı | Sonraki ayı bekleyin veya daha fazla kredi satın alın |
| İstek, kredisi olmayan bir kuruluşa faturalandırılıyor | X-HF-Bill-To başlığını kaldırın veya kuruluş yöneticisinden kredi eklemesini isteyin |
Bir kuruluş bir sağlayıcıyı devre dışı bıraktığında farklı bir hata oluşabilir. Bu sağlayıcıyı adıyla isterseniz istek başarısız olur. Otomatik sağlayıcı seçimini kullanın veya başka bir sağlayıcı seçin.
Kullanımınızı Inference Providers ayarlar sayfasında kontrol edin. Sayfa, geçen ayki kullanımı model ve sağlayıcıya göre gösterir.
API nasıl çalışır
- Hugging Face'e giriş yapın ve token ayarlarını açın.
- İnce ayarlı bir token oluşturun.
- Token'a "Make calls to Inference Providers" iznini verin.
- Token'ı
HF_TOKENortam değişkeninde saklayın. - Kredi satın alın veya PRO'ya yükseltin. Kredi olmadan ücretsiz bir hesap ücretli istekleri tamamlayamaz.
Inference Providers, sohbet tamamlamaları için https://router.huggingface.co/v1 adresinde OpenAI uyumlu bir uç nokta sunar. Inference Providers'a çağrı yapma izni olan ince ayarlı bir Hugging Face token'ı ile kimlik doğrularsınız.
Hugging Face token'ı ile OpenAI istemcisi
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)- En yüksek verimli sağlayıcıyı seçmek için model kimliğine
:fastestekleyin. - En düşük fiyatlı sağlayıcıyı seçmek için
:cheapestekleyin. - Tek bir sağlayıcı seçmek için
:novitagibi bir sağlayıcı adı ekleyin. - OpenAI uyumlu uç nokta yalnızca sohbet içindir. Görseller, gömmeler ve konuşma için Hugging Face istemci kitaplıklarını kullanın.
Inference Providers ne işe yarar
- Birçok açık modeli test etme: üretim için bir model seçmeden önce tek bir token ile.
- Başka yerlerde nadir bulunan modeller: örneğin yeni açık ağırlıklı sürümler ve özel görev modelleri.
- Görsel, video ve ses modelleri: Hugging Face istemci kitaplıkları üzerinden.
- Zaten PRO veya Ekip için ödeme yapan ekipler: dahil olan kredi önce uygulandığı için.
Hub'dan birçok açık modeli indirip kendi donanımınızda da çalıştırabilirsiniz. llama.cpp, vLLM ve Ollama gibi araçlar bunları yerel olarak sunar. Yerel çıkarım API kredisi harcamaz, ancak bir GPU veya hızlı bir bilgisayar gerekir. FreeLLMAPI, yerel bir OpenAI uyumlu sunucuyu özel sağlayıcı olarak ücretsiz bulut katmanlarının yanına ekleyebilir.
Inference Providers, günlük kullanım için ücretsiz bir API değildir. Aylık kredisi olmayan ücretsiz bir hesap, satın almadan sonraki her istek için öder. 2,00 $'lık PRO kredisi de bir ajan veya sohbet uygulaması için küçüktür.
Açık modeller için ücretsiz seçenekler
Hugging Face'teki birçok açık modelin, başka sağlayıcılarda da yinelenen ücretsiz katmanları vardır. Tablo, bugünkü katalogdaki en güçlü ücretsiz modelleri gösterir.
| Model | Ücretsiz olduğu yer | Bağlam | Ücretsiz limitler (en iyi teklif) | Araçlar | Görsel girdi |
|---|---|---|---|---|---|
| GLM 5.3 | APINex, UnoRouter | 1M | 5 istek/dk 10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account | Evet | Hayır |
| Qwen3.8 Max | ACLIDE | - | €20/month shared internal usage credits · no card | Evet | Hayır |
| GLM 5.3 Flash | APINex, BlazeAPI, NVIDIA NIM +1 tane daha | 1M | 40 istek/dk 40 RPM | Evet | Evet |
| Gemini 3.8 Flash | APINex, Google AI Studio | 1M | 5 istek/dk 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Evet | Evet |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| Qwen3.8 Flash Next | AMD Radeon Cloud, BlazeAPI, ElectronHub | 262K | Recurring daily account allowance | Evet | Hayır |
| Qwen3.8 Flash | ElectronHub, Inferbase | 1M | $0.25/week shared recurring credit | Evet | Evet |
| Deepseek V4.1 Flash | APINex | 1M | 5 istek/dk 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Hayır | Hayır |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Evet | Evet |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 istek/dk 50 istek/gün 50 req/day account-wide (1,000 after a $10 purchase) | Evet | Evet |
| Agnes 3.0 Flash | Agnes AI | - | Promo $0/token | Hayır | Hayır |
354 eşleşen ücretsiz modelden 12 tanesi gösteriliyor. Tüm modelleri gör.
Canlı veriler FreeLLMAPI kataloğundan alınır (sürüm 2026.11.19, 2026-11-19 tarihinde kontrol edildi). Ücretsiz limitler sık değişir. Katalog her gün kontrol edilir.
FreeLLMAPI'nin bir Hugging Face bağdaştırıcısı vardır. Bugünkü ücretsiz katalogda Hugging Face satırı yoktur, çünkü ücretsiz hesapların yinelenen kredisi yoktur. Ücretsiz açık modelleri tek bir anahtarla kullanmak için tablodaki sağlayıcılardan anahtarlar ekleyin. Yönlendirici bir sağlayıcı hız limiti hatası döndürdüğünde sonrakine geçer.
Sık sorulan sorular
Hugging Face Inference API ücretsiz mi?
Ücretsiz hesaplar için değil. Geçerli fiyatlandırma sayfası ücretsiz kullanıcılar için aylık kredi listelemez. Kredi satın almaları veya ayda 2,00 $ hesaplama kredisi içeren PRO'ya yükseltmeleri gerekir.
Ücretsiz Hugging Face kullanıcıları hâlâ ayda 0,10 $ alıyor mu?
Resmi fiyatlandırma sayfası bunu bugün göstermiyor. Ücretsiz kullanıcılar için aylık kredi listelemiyor. Eski sayfalar ve bazı belge kopyaları hâlâ 0,10 $ rakamını gösterir.
Neden Hugging Face, 402 Payment Required hatası döndürüyor?
Hesabınızda veya faturalandırılan kuruluşta kalan kredi yok. Kredi satın alın, PRO'ya yükseltin veya bir sonraki aylık PRO kredisini bekleyin.
Hugging Face yönlendiricisi OpenAI uyumlu mu?
Sohbet tamamlamaları için evet. Temel URL'yi https://router.huggingface.co/v1 olarak ayarlayın ve API anahtarı olarak bir Hugging Face token'ı kullanın.
Hugging Face Inference için ücretsiz bir alternatif nedir?
Açık modeller için yinelenen ücretsiz katmanı olan sağlayıcıları kullanın, örneğin Groq, NVIDIA NIM, Cloudflare Workers AI veya OVH AI Endpoints. FreeLLMAPI bunları tek bir anahtarın arkasında toplar.
İlgili rehberler
- Ücretsiz OpenAI uyumlu API base URL'leri
- Kredi kartı olmadan ücretsiz LLM API
- Ücretsiz LLM API hız sınırları
- OVH AI Endpoints ücretsiz API
- Ücretsiz embeddings API
Kaynaklar
- Hugging Face docs: Inference Providers pricing and billing (20 November 2026 tarihinde kontrol edildi)
- Hugging Face docs: Inference Providers (20 November 2026 tarihinde kontrol edildi)
- UsagePricing: Hugging Face free inference credits removed (15 October 2026) (20 November 2026 tarihinde kontrol edildi)
- FreeLLMAPI docs: Supported platforms (20 November 2026 tarihinde kontrol edildi)