Yapay zekayla bir şey kurmaya başlayınca üç harf sürekli karşına çıkıyor: API. Anahtar isteniyor, ücreti konuşuluyor, "API'den çekelim" deniyor. Kod bilmeyen biri için bu kelime gereksiz yere korkutucu duruyor. Oysa anlattığı şey gündelik: iki programın birbiriyle konuşma biçimi.
Kısa cevap
API, bir programın dışarıya açtığı hizmet penceresidir: "bana şunu sorarsan sana şunu veririm" kuralları. Bir hava durumu uygulamasının veriyi kendisi ölçmeyip başka bir yerden alması API sayesindedir. Kod bilmeden kurduğun araçlarda API iki yerde karşına çıkar: bir hizmetten veri almak ve yapay zeka modelini kendi aracının içinde çalıştırmak. İkisi de anahtar denen bir parola ile açılır ve kullandıkça ücretlenir.
Günlük hayattan tek örnek
Bir lokantada mutfağa girmezsin. Garsona ne istediğini söylersin, garson mutfağın kurallarını bilir, siparişini oraya iletir ve tabağı sana getirir. API tam olarak o garsondur: mutfağın içini görmene gerek yok, ne isteyebileceğin ve karşılığında ne alacağın belli.
Bu benzetmenin devamı da doğru: menüde olmayan bir şey isteyemezsin. Bir hizmetin API'si neyi veriyorsa onu alabilirsin, fazlasını değil. Bu yüzden bir aracı kurmadan önce sorulacak doğru soru şudur: bu hizmet dışarıya ne veriyor?
API anahtarı nedir, neden gizli tutulur?
API anahtarı, o hizmete "bu istek benden geliyor" diyen uzun bir parolalar dizisidir. İki işi vardır: seni tanır ve kullanımını hesaplar. Anahtar başkasının eline geçerse, senin adına istek atılır ve fatura sana gelir.
Bu yüzden tek kural nettir: anahtarı sohbete, ekran görüntüsüne, paylaştığın dosyaya yazma. Ajanla çalışırken de anahtarı ayrı bir dosyada tutmasını iste; kodun içine gömdürme. Veri ve anahtar güvenliğinin tamamını gizlilik yazısında topladık.
API mi, MCP mi, ajan mı?
Üç kavram karışıyor, ayrımı basit:
- API: bir hizmetin dışarıya açtığı pencere. Yıllardır var, neredeyse her hizmette bulunur.
- MCP: yapay zeka ajanlarının bu pencerelere tek tip yoldan bağlanması için çıkmış standart. Ayrıntısı MCP yazısında.
- Ajan: senin adına iş yapan program; kodlama ajanı hem API'yi hem MCP'yi kullanabilir.
Ücret nasıl işliyor?
Çoğu API kullandıkça ödeme mantığıyla çalışır: kaç istek attığın veya ne kadar metin işlediğin ölçülür. Küçük bir araç için aylık maliyet genellikle bir kahve parası düzeyindedir, ama iki tuzağa dikkat: döngüye giren bir program saatlerce istek atarak faturayı büyütebilir ve ücretsiz sınırlar habersiz dolabilir. Önlem basittir: hesabına harcama sınırı koy ve yeni kurduğun aracı ilk gün gözünün önünde çalıştır.
Kod bilmeden API kullanmak mümkün mü?
Evet, çünkü bağlantıyı sen değil ajan kurar. Senin işin üç adımdır: hizmetin sayfasından anahtarı almak, ajana hangi hizmete bağlanacağını söylemek ve sonucun doğru geldiğini kontrol etmek. Kalanı iş emrinin netliğine bakar; kalıbı iş emri rehberinde bulabilirsin.