İ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.

  1. Art arda gönder düğmesiyle sınıra takıl, hatayı oku.
  2. Tekir'den örnek bir istek yazmasını ve her alanı açıklamasını iste.
  3. 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
  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.