Hugging Face Nasıl Kullanılır? Ücretsiz Model Çalıştırma Rehberi

Hugging Face, herkesin kullanabileceği açık kaynak yapay zeka modellerinin toplandığı en büyük site. Üç milyondan fazla model var: Yazı yazan Qwen ve gpt-oss, görsel çizen Stable Diffusion, sesi yazıya çeviren Whisper... Çoğunu hiçbir şey kurmadan, doğrudan tarayıcından deneyebilirsin. Ama çoğu kişi siteye girip birkaç arama yapıyor ve asıl işe yarayan kısımları görmeden çıkıyor.

Aşağıda bir modeli nasıl bulacağını, tarayıcıdan nasıl çalıştıracağını, kendi uygulamana nasıl bağlayacağını ve ücretsiz kullanımın nerede bittiğini bulacaksın.

Hugging Face ne işe yarıyor?

Siteyi üç ana bölüm olarak düşünebilirsin:

• Models (modeller): Üç milyondan fazla açık kaynak model burada. Her birinin kendi sayfası var.
• Spaces (hazır uygulamalar): Birilerinin bir modeli alıp tarayıcıda çalışan küçük bir uygulamaya çevirdiği demolar. Açıyorsun, kullanıyorsun.
• Datasets (veri setleri): Modellerin eğitildiği açık veriler. Günlük kullanımda bunlara pek ihtiyacın olmaz.

ChatGPT ya da Claude kullanırken sadece o şirketin kendi modeline erişirsin. Hugging Face'te ise binlerce farklı modeli yan yana deneyebilir, beğendiğini indirip kendi bilgisayarında çalıştırabilirsin. Büyük çoğunluğu da ücretsiz.

[mindi_yorum]
💰 Temel kullanım ücretsiz. PRO üyelik ayda 9 dolar: 8 kat fazla ücretsiz GPU süresi ve her ay 2 dolarlık kullanım kredisi veriyor.
🟡 Site İngilizce ve ilk girişte kalabalık görünüyor. Model sayfaları ve Spaces bölümü ise alışınca kolay.

Yol 1: Modeli tarayıcıda dene

Kod yazman ya da bir şey kurman gerekmiyor. Sadece ücretsiz bir Hugging Face hesabıyla giriş yapmış olman yeterli.

1. huggingface.co/models adresine git.
2. Listenin üstündeki "Inference Available" düğmesine tıkla. Ekranda sadece tarayıcıdan hemen deneyebileceğin modeller kalır.
3. Soldaki görev listesinden (Tasks) ne yapmak istediğini seç. Yazı için "Text Generation", sesi yazıya çevirmek için "Automatic Speech Recognition" gibi. Artık listede sadece bu işi yapan ve tarayıcıdan denenebilen modeller var.
4. Listeden bir modelin sayfasını aç.
5. Sayfanın sağ tarafında "Inference Providers" başlıklı bir kutu göreceksin. Bu kutu, modeli Hugging Face'in anlaşmalı olduğu şirketlerden (Groq, Together, Novita gibi) birinin senin yerine çalıştırdığını gösterir.
6. Kutunun altındaki "Your prompt here..." alanına sorunu yaz ve Send düğmesine bas. Cevap birkaç saniyede aynı kutuda görünür.

Kutunun altındaki iki bağlantı da işe yarar: "View Code Snippets" aynı isteği kendi kodundan nasıl göndereceğini gösterir, "Compare providers" ise modeli çalıştıran şirketlerin hızını ve fiyatını yan yana koyar.

Sağda bu kutu yoksa, o model tarayıcıdan denenemiyor demektir. Bu durumda listeye dönüp "Inference Available" filtresi açıkken başka bir model seç.

Bazı modelleri kullanmadan önce izin istemen gerekiyor. Meta'nın Llama modelleri bunlardan. Hesabınla giriş yapıp model sayfasından erişim istersin; onayın ne kadar süreceği modeli yayınlayana göre değişiyor.

Yol 2: Hazır uygulamaları kullan (Spaces)

Spaces, birinin bir modeli alıp senin için kullanıma hazır hale getirdiği uygulamalar. Görsel üretmek, fotoğrafın arka planını silmek ya da bir ses kaydını yazıya dökmek için en kolay yol bu.

1. huggingface.co/spaces sayfasına git.
2. Arama kutusuna ne istediğini İngilizce yaz: "image generation" (görsel üretme), "speech to text" (sesi yazıya çevirme), "background removal" (arka plan silme).
3. Beğendiğin uygulamayı aç. Sayfa yüklenince kullanmaya başlayabilirsin.

En çok kullanılan türler:

Ücretsiz GPU süresi: Bazı uygulamalar çalışmak için güçlü bir ekran kartına (GPU) ihtiyaç duyuyor. Hugging Face bunun için herkese günlük ücretsiz bir süre veriyor. Bu sisteme ZeroGPU deniyor. Hesap açmadan günde 2 dakika, ücretsiz hesapla 5 dakika, PRO üyelikle 40 dakika kullanabilirsin. Süre, o gün GPU'yu ilk kullandığın andan 24 saat sonra yenileniyor. Kalan süren ne kadar çoksa sıradaki önceliğin de o kadar yüksek oluyor. PRO üyeler günlük süreyi bitirince önceden yükledikleri krediyle devam edebiliyor: 10 dakikalık GPU süresi 1 dolar.

Yol 3: Modeli kendi uygulamana bağla (API)

Bir modeli kendi yazdığın uygulamada kullanmak istiyorsan en kolay yol Hugging Face'in Inference Providersⁱtek bir anahtarla farklı şirketlerdeki modellere erişmeni sağlayan servis hizmeti. Ekran kartı kiralaman ya da modeli indirmen gerekmiyor. Hugging Face'ten aldığın tek bir anahtarla istek gönderiyorsun, Hugging Face de isteği modeli çalıştıran şirkete iletiyor.

1. Anahtarını (token) oluştur

1. huggingface.co/settings/tokens sayfasına git.
2. "New token"a tıkla, "Fine-grained"ı seç, "Make calls to Inference Providers" kutusunu işaretle ve oluştur.
3. Anahtarı kopyala ve güvenli bir yere kaydet. Kimseyle paylaşma.

2. İlk isteğini gönder

Python ile:

from huggingface_hub import InferenceClient

client = InferenceClient()

completion = client.chat.completions.create(
    model="openai/gpt-oss-20b",
    messages=[
        {"role": "user", "content": "Yapay zeka nedir? Kısaca açıkla."}
    ],
)
print(completion.choices[0].message.content)

Ya da doğrudan bir HTTP isteğiyle:

POST https://router.huggingface.co/v1/chat/completions
Authorization: Bearer hf_xxxxxxxxxxxx
{"model": "openai/gpt-oss-20b", "messages": [{"role": "user", "content": "Yapay zeka nedir?"}]}

Zaten OpenAI'ın kod kütüphanesini kullanıyorsan kodunu değiştirmene gerek yok. Adres olarak https://router.huggingface.co/v1 yaz, anahtar olarak da Hugging Face anahtarını ver, yeter. İnternette eski api-inference.huggingface.co adresini kullanan örneklere rastlarsan onlar artık güncel değil.

Ücretsiz kullanım ne kadar? Ücretsiz hesap her ay 0,10 dolarlık, PRO üyelik 2 dolarlık kullanım kredisi alıyor. Ücretsiz hesaptaki tutar zaman zaman değişebiliyor. Kredi bitince devam etmek için kredi satın alman gerekiyor.

5 dakikada ilk modelini çalıştır

Aşağıdaki adımları sırayla yaparsan beş dakika içinde hem yazı üreten bir modelle konuşmuş hem de ilk görselini üretmiş olursun.

1. Hesap aç

huggingface.co/join adresine git. E-posta adresini ve bir şifre yaz, ardından gelen doğrulama e-postasındaki bağlantıya tıkla. Kredi kartı istemiyor.

2. Denenebilir bir model bul

huggingface.co/models sayfasına git. Önce listenin üstündeki "Inference Available" düğmesine tıkla, ardından soldaki görev listesinden "Text Generation"ı seç. Ekranda sadece tarayıcıdan denenebilen yazı modelleri kalır. Sıralamayı "Trending" (o an en çok ilgi gören) olarak bırak. Başlangıç için iki iyi seçenek:

• gpt-oss-20b (openai/gpt-oss-20b): OpenAI'ın herkese açık modeli. Ticari kullanıma izin veren Apache 2.0 lisansıyla geliyor ve birçok şirket tarafından çalıştırılıyor, yani tarayıcıdan denemek için hazır.
• Qwen3.8-27B: O da Apache 2.0 lisanslı. Yazının yanında görselleri de anlayabiliyor.

3. Tarayıcıda konuş

Model sayfasını aç. Sağdaki "Inference Providers" kutusunda "Your prompt here..." alanına Türkçe bir soru yaz, örneğin "Yapay zeka nedir? Üç cümleyle anlat." Send'e bas. Cevap aynı kutuda gelir. Bu deneme, aylık ücretsiz kredinden çok küçük bir miktar harcar.

4. Kendi anahtarını oluştur

Sağ üstteki profil resmine tıkla, "Settings"e, ardından "Access Tokens"a gir. "New token"a bas, "Fine-grained"ı seç, "Make calls to Inference Providers" kutusunu işaretle ve oluştur. Anahtarı kopyala, yukarıdaki Python örneğini kendi anahtarınla dene. Model sayfasındaki "View Code Snippets" bağlantısı da aynı kodu hazır olarak verir.

5. İlk görselini üret

huggingface.co/spaces sayfasına git ve arama kutusuna "FLUX.1-dev" yaz. black-forest-labs'ın "FLUX.1 [dev]" uygulamasını aç. Sayfa yüklenince metin kutusuna ne görmek istediğini İngilizce yaz, örneğin "a red octopus reading a book in a cozy library", ve üret düğmesine bas. Bu uygulama ücretsiz GPU süresini (ZeroGPU) kullanır, yani günlük hakkından birkaç saniye düşer.

Hangi modeli seçmelisin?

Üç milyon model içinde kaybolmamak için dört şeye bak:

Ne iş yapacağı. Önce amacına göre filtrele: yazı mı, görsel mi, ses mi? Bu tek adım listeyi binlerden onlara indirir.

Kaç kişinin kullandığı. İndirme sayısı iyi bir işaret. Ayda bir milyondan fazla indirilen bir model genelde denenmiş ve güvenilir demektir.

Ne kadar büyük olduğu. Modelin adındaki "7B", "70B" gibi rakamlar büyüklüğünü gösterir. 7B bir model Spaces'te rahat çalışır. 70B bir modeli kendi bilgisayarında çalıştırmak içinse çok güçlü bir donanım gerekir.

Hangi lisansla geldiği. Modeli bir işte, para kazanacağın bir projede kullanacaksan lisans önemli. Apache 2.0 ve MIT lisanslı modelleri ticari olarak serbestçe kullanabilirsin. Llama modellerinde ise Meta'nın koyduğu şartlar geçerli. Her modelin lisansı kendi sayfasında yazıyor.

[mindi_yorum]
🟡 "En büyük model en iyisidir" diye bir kural yok. Senin işine özel eğitilmiş küçük bir model, dev bir genel modelden daha iyi sonuç verebilir.
🔵 Bir modeli kullanmadan önce sayfasındaki açıklamayı (model card) oku. Neyle eğitildiği, neyi iyi yapamadığı ve lisansı orada açıkça yazıyor.

Şimdi ne yapmalısın?

Başlamak için ücretsiz bir hesap yeterli, ilk denemeleri hesap açmadan bile yapabilirsin.

1. Spaces'ta hazır bir uygulama aç ve iki dakika oyna. Hiçbir şey kurman gerekmiyor.
2. Models bölümünde amacına göre filtrele, beğendiğin bir modeli sağdaki "Inference Providers" kutusundan dene.
3. Kendi uygulamana bağlamak istersen bir anahtar oluştur ve Python ya da HTTP örneğini dene.
4. Ücretsiz GPU süresi ve kredi yetmemeye başlarsa PRO üyeliğe (ayda 9 dolar) geçmeyi düşün.