API nedir?

Bugün kullandığımız hava durumu uygulamalarından yapay zekâ sohbet botlarına kadar pek çok uygulama, arka planda aslında bir API ile konuşur. Bu derste API'nin ne olduğunu, istek–yanıt döngüsüyle nasıl çalıştığını ve yapay zekâ dünyasındaki yerini sıfırdan, somut örneklerle anlatıyoruz. Serinin diğer başlıkları için Yapay Zekâ dersleri sayfasına göz atabilirsin.

API Nedir?

API, Application Programming Interface, yani "uygulama programlama arayüzü" ifadesinin kısaltmasıdır. Kısaca, iki yazılımın birbiriyle kurallı ve güvenli bir biçimde veri alışverişi yapmasını sağlayan sözleşmedir. API görsel bir ekran sunmaz; bir programın, başka bir programın sunduğu yetenekleri kendi kodundan çağırmasına imkân verir.

Farkı netleştirmek için restoran benzetmesi kullanışlıdır: Sen (kullandığın uygulama) garsona (API) siparişini söylersin, garson isteği mutfağa (sunucuya) iletir ve yemeği (veriyi) sana getirir. Mutfağa doğrudan giremezsin; her şey belirli kurallar içinde olur. API de aynı işi yapar: hem bir erişim kapısıdır hem de hangi isteklerin nasıl yapılabileceğini gösteren bir kural listesidir.

API Nasıl Çalışır: İstek ve Yanıt Döngüsü

API'lerin neredeyse tamamı aynı temel döngüyle çalışır: istek (request) ve yanıt (response).

1. Uygulamanız, API'nin belirli bir adresine (buna endpoint denir) bir istek gönderir. İstekte ne istediğinizi anlatan veriler bulunur; örneğin sorgulanacak şehrin adı ya da modele iletilecek soru.
2. Sunucu isteği doğrular, işi gerçekleştirir ve sonucu hazırlar.
3. Sonuç, genellikle JSON denen anahtar–değer çiftlerinden oluşan yapılandırılmış bir metin biçiminde uygulamaya geri döner.

Somut bir örnek: telefonunuzdaki hava durumu uygulaması, hava durumu servisinin API'sine "Ankara'nın sıcaklığı kaç derece?" anlamında bir istek gönderir; servis de "sehir: Ankara, sicaklik: 24" gibi düzenli bir yanıt döndürür. Uygulama bu yanıtı alıp ekranda renkli bir kart hâline getirir. Yani ekranda gördüğün bilgi ile onu üreten sistem arasında köprü kuran şey API'dir.

Yapay Zekâ API'leri Ne İşe Yarar?

2024–2025 itibarıyla yaygın biçimde kullanılan GPT-4o, Claude ve Gemini gibi büyük dil modelleri, geliştiren şirketlerin kendi sunucularında çalışır; modelin ağırlıkları kullanıcıyla paylaşılmaz. Bu yüzden bir uygulamaya yapay zekâ yeteneği eklemenin standart yolu, sağlayıcının sunduğu API'yi kullanmaktır: uygulamanız metni bir istekle gönderir, model sağlayıcının sunucusunda yanıtı üretir ve metin JSON biçiminde size döner.

Bu yapı sayesinde bir e-ticaret sitesi, müşteri sorularını otomatik yanıtlayan bir bot; bir not uygulaması, belge özetleme özelliği; bir kod editörü ise satır içi kod önerileri sunabilir. Kod tamamlama özelliğinin arkasında da tam olarak bu tür bir API iletişimi vardır; bu senaryoyu kod tamamlama dersinde ayrıca işliyoruz.

API üzerinden sunulan bu modeller çoğunlukla kapalı yapay zekâ modelleridır: modeli kimse indirip kuramaz, yalnızca API ile konuşur. Buna karşılık açık kaynak yapay zekâ modelleri kendi bilgisayarınızda veya sunucunuzda çalıştırılabildiği için dışarıya istek göndermek zorunda kalmayabilirsiniz. İki yaklaşımı değerlendirirken yapay zekâ modeli karşılaştırma dersindeki ölçütler işinizi kolaylaştırır.

Bilmeniz Gereken Temel API Kavramları

API ile ilgili metinlerde sık geçen terimleri şöyle özetleyebiliriz:

• Endpoint: API'nin sunduğu her işlemin kendi adresi; örneğin "sohbet yanıtı üret" ile "metni vektöre çevir" farklı uçlardadır.
• JSON: istek ve yanıtların taşındığı, insanın da okuyabildiği yapılandırılmış veri biçimi.
• API anahtarı (API key): sizi tanıtan gizli kimlik bilgisi; isteklerin kimin adına yapıldığını ve faturalamanın kime yapılacağını belirler.
• Token: dil modellerinde kelimeye ya da kelime parçasına karşılık gelen birim; kullanım ve ücretlendirme token üzerinden hesaplanır.
• Hız limiti (rate limit): belirli süre içinde yapılabilecek istek sayısını sınırlayan kural; aşıldığında API istekleri geçici olarak reddeder.
• SDK: API'yi ham HTTP istekleri yerine dile özgü hazır fonksiyonlarla kullanmanızı sağlayan kütüphane; Python ve JavaScript için ayrı ayrı yayımlanır.
• Akış (streaming): yanıtın tek parça yerine parça parça iletilmesi; sohbet botlarındaki yazının kelime kelime belirmesi bundandır.

Sohbet Arayüzü ile API Arasındaki Fark

ChatGPT ve benzeri botların web ekranı insanlar için tasarlanmıştır; API ise programlar içindir. Aradaki farkı listeleyelim:

• Hedef kitle: arayüzü herkes kullanır; API'yi ağırlıklı olarak yazılımcılar kullanır.
• Kullanım biçimi: arayüzde kutucuğa elle yazarsınız; API'de uygulamanız isteği otomatik gönderir ve yanıtı kendi akışına işler.
• Ölçek: arayüzde istekleri tek tek yazarsınız; API ile gecede binlerce belgeyi otomatik işleyen bir sistem kurulabilir.
• Maliyet modeli: arayüzde genellikle ücretsiz kullanım veya abonelik vardır; API'de ödeme çoğunlukla harcanan token kadardır.
• Esneklik: API'de model seçimi ile yanıt uzunluğu ve yaratıcılık gibi parametreleri kodla ayarlarsınız; arayüzde bu ayarların bir bölümü hiç gösterilmez.

İlk API çağrınızı gerçekten atmak istediğinizde adım adım yol gösteren ayrı bir dersimiz var: AI API nasıl kullanılır? dersine geçebilirsin.

Sık Yapılan Hatalar ve Yanılgılar

API'ye yeni başlayanların sıkça karşılaştığı durumları şöyle sıralayabiliriz:

• "API bir web sayfasıdır" sanmak: API'nin kendisi görsel bir sayfa değildir; sitelerin ve uygulamaların arkasındaki programlar arası kanaldır. Tarayıcıda bir API adresini açınca anlaşılmaz bir hata görmenin sebebi budur.
• API anahtarını kodun içine yazıp paylaşmak: anahtar herkese açık bir depoya kopyalanırsa başkaları sizin adınıza istek atabilir; hem güvenlik hem de faturalama sorunu doğar. Anahtarlar ortam değişkenleri gibi koddan ayrı yerlerde tutulur.
• "API ile modeli değiştiririm" sanmak: API modele bir erişim kapısıdır; modelin davranışını istem ve parametrelerle yönlendirirsiniz ama modelin kendisini API üzerinden değiştiremezsiniz.
• "Tek API türü vardır" sanmak: REST en yaygın yaklaşımdır ama GraphQL, WebSocket ve akışlı yanıtlar gibi farklı türler de vardır; her sağlayıcının belgeleri kendi kurallarını koyar.
• Yanıtları her zaman güncel sanmak: API'den gelen yanıt, modelin eğitim verisiyle sınırlıdır. Güncel bilgi gerektiren işlerde RAG gibi yöntemler devreye girer; konunun tamamını RAG nedir? dersinde işliyoruz.

API aynı zamanda yapay zekâ ajanlarının da temel taşıdır: bir ajanın araç kullanması, arama yapması ya da başka bir sistemden veri çekmesi çoğunlukla API çağrılarıyla gerçekleşir. Ajanların bu beceriyi adım adım nasıl sergilediğini merak ediyorsan AI agent nasıl çalışır? dersine bakabilirsin. Yazılım tarafındaki diğer başlıklar için ise yazılım derslerimize göz atmanı öneririz.