İleri: bağlamak ve üretmek, kurs 18, 20 dakika
API nedir: uygulamalar yapay zekâyla nasıl konuşur?
Kendin gör
İsteği kur, gönder, cevabı oku. Burada gerçek bir çağrı yapılmaz.
İSTEK
{
"model": "hizli-model",
"mesaj": "Merhaba",
"en_fazla_token": 100
}Gerçek hayatta anahtar burada görünmez: sunucuda, gizli ayarda durur.
Şimdi sen oyna
Garson sınavı
3 seviye, yaklaşık 3 dakika. Girişe, yapay zekâya ya da başka bir uygulamaya gerek yok.
Tekir’de dene
Gerçek bir yapay zekâyla dene. Altın renkli yerleri kendine göre değiştir, “Tekir’de dene”ye bas: tarif kopyalanır, Tekir açılır, yapıştır ve gönder.
- Art arda gönder düğmesiyle sınıra takıl, hatayı oku.
- Tekir'den örnek bir istek yazmasını ve her alanı açıklamasını iste.
- Kullandığın bir uygulamanın arkasında API olup olmadığını düşün.
Örnek istek
Bir yapay zekâ API'sine giden örnek isteği göster. Her alanın ne işe yaradığını tek cümleyle yaz. Mesaj şu olsun: «MESAJ». Gerçek anahtar kullanma.
Kursun kısa özeti
Adım 1
Anahtar
API anahtarı kim olduğunu söyler. Harcama da o anahtarın hesabına yazılır. Şifre gibidir: kimseyle paylaşılmaz.
Adım 2
İstek
Programın gönderdiği düzenli mesajdır: hangi model, hangi mesaj, en fazla ne kadar uzunluk. Sohbet ekranının arkasında da aynı şey olur.
Adım 3
Cevap
Metin, kullanılan token ve varsa hata düzenli bir biçimde gelir. Program bunu okuyup ekrana yazar ya da başka bir işte kullanır.
Adım 4
Hatayı oku
Anahtar yanlışsa istek reddedilir. Çok sık istek atarsan sınıra takılırsın: biraz bekle, tekrar dene. Uzunluk sınırı dolunca cevap yarıda kesilir.
Adım 5
Anahtarı koru
Anahtarı sunucuda, gizli ayarda tut. Sitenin açık koduna yazılan anahtarı herkes kullanır, fatura sana gelir. Sızarsa hemen iptal et, yenisini al.
Farkı gör
Zayıf tarif
Sitemin koduna anahtarı yazdım, çalışıyor.
Sonuç
Herkes sayfanın kodunda anahtarı görür. Başkaları kullanır, fatura sana gelir.
Güçlü tarif
Site isteği kendi sunucuma gönderiyor. Anahtar yalnız sunucuda, gizli ayarda duruyor.
Sonuç
Anahtar dışarı çıkmaz. Sen de kullanımı sunucuda sınırlayabilirsin.
Püf noktaları ve sık hatalar
Püf noktaları
- Her uygulama için ayrı anahtar aç; biri sızınca hepsi gitmesin.
- Hata mesajını Tekir'e yapıştırıp anlattırabilirsin; anahtarı yapıştırma.
- Uzunluk sınırı koymak maliyeti de korur.
Sık yapılan hatalar
- Anahtarı sitenin koduna yazmak.
- Anahtarı sohbete yapıştırmak.
- Sınıra takılınca hemen yeniden denemek.
- Hata mesajını okumadan her şeyi değiştirmek.