Hugging Face API nasıl kullanılır? İlk Python isteği
Hugging Face API ile model seçimini, erişim anahtarı oluşturmayı ve ilk Python isteğini öğren. Kullanım ücretini kontrol ederek uygulamana metin üretimi ekle.

Hugging Face API kullanmak için Inference Providers izni olan bir erişim anahtarı oluşturup hizmette sunulan bir model seçmelisin. Python üzerinden model kimliğini ve mesajını sohbet API adresine göndererek cevap alabilirsin; modelin bilgisayarına kurulması gerekmez. İstekten önce hesabındaki kullanım kredisini kontrol et.
Hugging Face API ile uygulamana metin üretimi eklemek istiyorsan, model dosyalarını indirmeden başlayabilirsin. Inference Providers hizmeti, isteğini modeli çalıştıran bir sağlayıcıya iletir ve cevabı uygulamana döndürür. İlk denemede yapacağın iş, uygun modeli seçmek ve kısa bir Türkçe mesajı Python üzerinden göndermek; ardından cevabı ve kullanım kaydını kontrol etmek.
Hugging Face API kullanmak için ne gerekiyor?
Bir Hugging Face hesabına, uygun izinli erişim anahtarına ve kullanacağın model için yeterli kullanım kredisine ihtiyacın var. API (uygulama programlama arayüzü), programının başka bir hizmete istek göndermesini sağlar. Inference (çıkarım), eğitilmiş modelin bir girdiyi işleyip sonuç üretmesi anlamına gelir; sağlayıcı da bu modeli sunucularında çalıştıran hizmettir.
Örneğin küçük bir uygulamada ürün açıklaması taslağı hazırlatmak istiyorsun. Uygulaman ürünün özelliklerini mesaj olarak gönderir, dönen metni senin incelemen için gösterir. Resmi başlangıç belgesine göre sohbet üretiminin yanında görsel ve ses gibi başka görevler de destekleniyor. Ancak her görev için uygun model ve çağrı biçimini seçmek gerekiyor.
Model ile uygulama arasındaki ayrımı henüz oturtamadıysan büyük dil modeli açıklamasına bakabilirsin. Python programın uzak hizmete isteği gönderecek. Bilgisayarında model çalıştırmak istiyorsan yerel yapay zekâ rehberindeki kurulum yolunu izlemelisin.
Hugging Face API anahtarı nasıl alınır?
Hesabının Access Tokens sayfasından, Inference Providers çağrısı yapma izni olan bir fine-grained, yani kapsamı daraltılmış erişim anahtarı oluşturmalısın. Yazı tarihinde resmi başlangıç belgesinde gerekli izin Make calls to Inference Providers adıyla geçiyor.
- Hesabına giriş yapıp erişim anahtarı ayarlarını aç.
New tokenile yeni anahtar oluştur ve fine-grained türünü seç.- Adını
urun-aciklamasi-denemegibi kullanacağın işi anlatan bir şey yap. - Inference Providers çağrı iznini aç; bu deneme için depo yazma yetkisi ekleme.
- Oluşturduğun değeri güvenli biçimde sakla; aşağıdaki program çalışırken soracak.
Hugging Face, anahtar yönetimi belgesinde her uygulama veya kullanım için ayrı anahtar öneriyor. Böylece bir deneme anahtarını kapatınca diğer uygulamalarının erişimini kesmezsin. Anahtarını herkese açık kod deposuna ya da bir hata ekranı paylaşımına koyma. Açığa çıkarsa aynı ayarlar sayfasından sil veya yenile; uygulamandaki eski değeri de değiştir.
Hangi modelin API ile çalıştığını nasıl anlarsın?
Modelin sayfasında Inference Providers desteğini ve yapacağın göreve uygun bir sağlayıcı bulunduğunu kontrol ederek anlayabilirsin. Hub'daki her model dosyası bu hizmette çalıştırılmaya hazır değildir. Resmi ilk çağrı rehberi, aramayı Inference Providers filtresiyle daraltmayı ve model sayfasındaki deneme alanını kullanmayı öneriyor.
Sohbet modeli seçerken Inference Playground üzerinden kısa bir mesaj dene. Örneğin "Mavi seramik fincan için yalnızca verilen özelliklerle iki cümle yaz" isteğini kullanabilirsin. Arayüzdeki kod örneğinden model kimliğini al; görünen ürün adını tahmin ederek yazma. Kimlik genellikle kurum/model-adi biçimindedir.
18 Kasım 2026 yazı tarihinde resmi başlangıç belgesi, metin sohbeti örneğinde deepseek-ai/DeepSeek-V4.1-Flash kimliğini kullanıyor. Aşağıdaki program model adını senden isteyecek. Bu kimlik hesabında sunulmuyorsa Playground'da erişebildiğin sohbet modelinin kod örneğindeki kimliği kullan. Görsel üretim modelini sohbet adresine göndererek aynı sonucu alamazsın.
Python ile ilk API isteği nasıl gönderilir?
Model kimliğini ve mesajlarını https://router.huggingface.co/v1/chat/completions adresine göndererek ilk sohbet cevabını alabilirsin. Örnek Python 3'ün standart kütüphanesini kullanır; ayrıca paket kurman gerekmez. Kodu hf_deneme.py adlı dosyaya kaydedip terminalde python3 hf_deneme.py komutuyla çalıştır. Windows'ta Python kurulumuna göre komut py hf_deneme.py olabilir.
import getpass
import json
import urllib.error
import urllib.request
model = input("Sohbet modelinin kimliği: ").strip()
token = getpass.getpass("Hugging Face erişim anahtarı: ").strip()
payload = {
"model": model,
"messages": [{
"role": "user",
"content": (
"Türkçe bir ürün açıklaması taslağı yaz. "
"Ürün: mavi seramik fincan, 250 ml. "
"En fazla iki cümle kullan. Fiyat, dayanıklılık veya "
"bulaşık makinesine uygunluk hakkında bilgi ekleme."
)
}],
"stream": False
}
request = urllib.request.Request(
"https://router.huggingface.co/v1/chat/completions",
data=json.dumps(payload).encode("utf-8"),
headers={
"Authorization": f"Bearer {token}",
"Content-Type": "application/json"
},
method="POST"
)
try:
with urllib.request.urlopen(request, timeout=120) as response:
result = json.load(response)
print(result["choices"][0]["message"]["content"])
print("Kullanım:", result.get("usage", {}))
except urllib.error.HTTPError as error:
print("HTTP hata kodu:", error.code)
print(error.read().decode("utf-8", errors="replace"))
except (urllib.error.URLError, TimeoutError) as error:
print("Bağlantı tamamlanamadı:", error)
Anahtarı kendi bilgisayarındaki terminale gir; getpass normal terminal kullanımında yazdığın karakterleri göstermez. Programın 120 saniyelik bekleme değeri örnek için seçilmiştir, sağlayıcının hizmet süresi garantisi değildir.
Sohbet API belgesinde messages konuşma mesajlarını, stream: false cevabın tek JSON nesnesi olarak dönmesini belirtir. Cevap metni choices içindeki mesajdan okunur; usage alanı token kullanımını bildirir. Token, modelin metni işlediği parçadır; kelime sayısıyla birebir örtüşmesini bekleme. Ayrıntı için token rehberine bakabilirsin. Ekrana gelen açıklamada fincanın renginin ve hacminin doğru kaldığını kontrol et.
Hugging Face API ücretsiz mi, sağlayıcı nasıl seçiliyor?
18 Kasım 2026 yazı tarihinde ücretsiz hesaplara aylık Inference Providers kredisi verilmiyor; kullanım için kredi satın almak gerekiyor. Resmi ücretlendirme sayfasına göre PRO, Team ve Enterprise planlarında dahil edilen krediler var. Bu krediler başka Hugging Face hesaplama hizmetlerinde de kullanılabildiğinden, denemeden önce kalan bakiyene bak.
İlk isteğin ardından ayarlardaki Inference Providers kullanım dökümünü aç. Model ve sağlayıcıya göre kullanımını buradan takip edebilirsin. Birkaç ürün açıklamasıyla deneme yapıp çıktı uzunluğunu ve hesabına yansıyan kullanımı kontrol et; toplu gönderime geçmeden önce bu kayıtları incele.
Yönlendirme belgesine göre yazı tarihinde dil modeli isteklerinde sağlayıcı seçimini OpenRouter yapıyor. Model kimliğine ek koymazsan fiyat, hız ve güvenilirliği değerlendiren varsayılan yönlendirme kullanılıyor.
| Model kimliğinin sonu | Seçimin anlamı |
|---|---|
| Ek yok | Varsayılan sağlayıcı yönlendirmesi |
:fastest |
Saniyede üretilen token hızına öncelik |
:cheapest |
En düşük fiyata öncelik |
:novita gibi sağlayıcı eki |
Yalnızca belirtilen sağlayıcı |
Örneğin modeli belirli bir sağlayıcıya sabitlersen, o sağlayıcı başarısız olduğunda başka sağlayıcıya otomatik geçilmez. Sağlayıcı ekini modelin gerçekten sunulduğu seçeneklerden seç.
İlk istek çalışmazsa neyi kontrol etmelisin?
Önce programın yazdırdığı hata açıklamasını okuyup erişim iznini, model kimliğini ve kredi durumunu sırayla kontrol etmelisin. Örneğin model kimliğinde yazım hatası varsa anahtarı yeniden üretmek sorunu çözmez; Playground'daki kod örneğiyle kendi girişini karşılaştır.
Erişimle ilgili hata alırsan anahtarın silinmediğini ve çağrı izninin açık olduğunu kontrol et. Sağlayıcı seçimine ilişkin hata varsa modele eklediğin sağlayıcının hesap ayarlarında kapalı olup olmadığına bak. Kuruluş hesabına faturalandırılan isteklerde kuruluşun sağlayıcı ayarları geçerlidir.
Bağlantı zaman aşımına uğrarsa arka arkaya tekrar göndermeden kullanım kaydını incele. Cevap geldiği hâlde fincanın özellikleri uydurulmuşsa bağlantıyı kurmuşsundur; şimdi çıktıyı düzeltmen gerekir. Örneğin promptta bulunmayan "ısıyı uzun süre korur" ifadesini ürün açıklamandan çıkar ve sonraki denemede verilen özelliklere bağlı kalma talimatını kontrol et.
Bizim yorumumuz
Bizce Hugging Face API'ye başlarken tek bir Türkçe görev seçmek, hangi modeli kullanacağına karar vermeni kolaylaştırır. Küçük bir mağaza için açıklama hazırlıyorsan birkaç hayalî ürünle dene. Bir fincanın hacmini yanlış yazan veya verilmemiş bir malzeme özelliği ekleyen cevabı kaydet. Aynı isteği başka bir modelde karşılaştırırken bu hatanın düzelip düzelmediğine bak. Her denemede promptu da değiştirirsen hangi değişikliğin işe yaradığını ayırmak zorlaşır.
Bizce ilk uygulamada üretilen metni insanın onaylayacağı bir taslak alanında göstermek uygun bir başlangıç. Örneğin "yayınla" düğmesine basmadan önce ürünün rengini ve ölçüsünü kontrol edebileceğin bir ekran hazırla. Modeli seçerken Türkçe anlatımının yanında, cevabı düzenlemek için ne kadar uğraştığını da not et. Tek bir başarılı çıktıya dayanarak bütün ürün kataloğunu aynı işleme bağlama.
Müşteri verileriyle çalışacaksan sağlayıcı seçimini ayrıca incele. Hugging Face'in güvenlik açıklaması, dış sağlayıcıların kendi veri politikalarına bakmanı istiyor. Bizce ilk denemeye gerçek müşteri mesajlarını taşımak gereksiz; kişisel bilgi içermeyen örnek metinler bağlantıyı ve cevap biçimini kontrol etmeye yeter. Uygulamayı kullanıma açarken erişim anahtarını sunucu tarafında sakla. Tarayıcıya gönderilen sayfanın veya JavaScript dosyasının içine yerleştirme.
API adresi, izin adı, model örneği ve ücretlendirme koşulları 18 Kasım 2026 yazı tarihinde Hugging Face'in resmi belgelerinden kontrol edildi. İlk çağrıdan önce model sayfasındaki kullanılabilir sağlayıcıyı ve hesabındaki kredi durumunu yeniden kontrol et.
Bu yazı sponsorlu değildir.
Sık sorulanlar
Hugging Face API ücretsiz mi?
18 Kasım 2026 yazı tarihinde ücretsiz hesaplara aylık Inference Providers kredisi verilmiyor; API kullanımı için kredi satın almak gerekiyor. PRO, Team ve Enterprise planlarında dahil edilen krediler bulunuyor; güncel tutarı resmi ücretlendirme sayfasından kontrol et.
Hugging Face API anahtarı nasıl alınır?
Hesabının Access Tokens sayfasından yeni bir fine-grained anahtar oluştur. Inference Providers çağrısı yapma iznini aç ve anahtarı koduna gömmeden kullan.
Hugging Face üzerindeki her model API ile çalışır mı?
Inference Providers üzerinden kullanacağın modelin bir sağlayıcı tarafından sunulması ve seçtiğin görevi desteklemesi gerekir. Hub'da model dosyalarının bulunması, bu hizmette çalıştırılabildiği anlamına gelmez.
Hugging Face API için ekran kartı gerekir mi?
Inference Providers çağrısında model uzaktaki sağlayıcıda çalışır; kendi bilgisayarında modeli çalıştıracak ekran kartına ihtiyacın yoktur. İnternet bağlantısı ve geçerli hesap erişimi gerekir.
Haftada bir e-posta. Sadece işe yarayanlar.
Haftanın en iyi yapay zekâ araçları ve yeni rehberler. İstediğin an tek tıkla çık.
EVREN hataları: 403, 404, 429, 503 ve boş cevap çözümü





