JavaScript ile AI API Kullanımı: fetch ve Sohbet İsteği

Giriş

JavaScript ile AI API entegrasyonu yapmak artık günümüzde oldukça yaygın bir ihtiyaç haline geldi. Özellikle sohbet tabanlı AI servisleri, web uygulamalarınıza akıllı özellikler eklemenizi sağlıyor. Bu yazıda, fetch API kullanarak JavaScript ile AI sohbet isteği göndermeyi adım adım öğreneceksiniz.

API Anahtarı ve Hazırlık

AI API servisi kullanmaya başlamadan önce bir API anahtarına ihtiyacınız olacak. Anahtarınızı aldıktan sonra güvenli bir şekilde saklamalı ve asla public repository'lerde paylaşmamalısınız. .env dosyası veya sunucu tarafında environment variable olarak tutmanız önerilir.

Temel Fetch İsteği

Sohbet isteği göndermek için fetch fonksiyonunu kullanacağız. Aşağıdaki örnek, basit bir mesaj gönderimini göstermektedir:

const response = await fetch('https://api.apicloud.com.tr/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    model: 'gpt-3.5-turbo',
    messages: [
      { role: 'user', content: 'Merhaba, nasıl yardımcı olabilirsin?' }
    ],
    max_tokens: 500
  })
});

const data = await response.json();
console.log(data.choices[0].message.content);

Bu kod bloğu, basit bir soru-scevap döngüsü kurmanızı sağlar. messages dizisi içine rolleri (system, user, assistant) ve içerikleri ekleyerek daha bağlamsal bir sohbet oluşturabilirsiniz.

Çok Adımlı Sohbet Yönetimi

Gerçek bir sohbet deneyimi için geçmiş mesajları saklamak ve yeni her istekte bu geçmişi göndermek gerekir. İşte bunu yönetmenin basit bir yolu:

let conversationHistory = [
  { role: 'system', content: 'Sen yardımsever bir asistansın.' }
];

async function sendMessage(userMessage) {
  conversationHistory.push({ role: 'user', content: userMessage });
  
  const response = await fetch('https://api.apicloud.com.tr/v1/chat/completions', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_API_KEY'
    },
    body: JSON.stringify({
      model: 'gpt-3.5-turbo',
      messages: conversationHistory,
      max_tokens: 500
    })
  });
  
  const data = await response.json();
  const assistantMessage = data.choices[0].message.content;
  conversationHistory.push({ role: 'assistant', content: assistantMessage });
  
  return assistantMessage;
}

Bu yapı, kullanıcı mesajlarını ve AI yanıtlarını aynı dizide tutarak akıcı bir sohbet akışı sağlar.

Hata Yönetimi ve Dikkat Edilecekler

API isteklerinde hata almak mümkündür. response.ok kontrolü yaparak HTTP hata kodlarını (401, 429 gibi) yakalayabilir ve kullanıcıya uygun mesajlar gösterebilirsiniz. Ayrıca rate limit sınırlarına dikkat etmeli, gereksiz tekrar isteklerden kaçınmalısınız.

apicloud.com.tr üzerinden yaptığınız işlemlerde bakiye durumunuzu düzenli takip etmek, beklenmedik kesintilerin önüne geçmenizi sağlar.

Sonuç

fetch ile AI API entegrasyonu, JavaScript projelerinize akıllı sohbet özellikleri eklemenin en temel yoludur. Doğru yapılandırma, hata yönetimi ve geçmiş mesaj takibi ile güçlü bir sohbet arayüzü oluşturabilirsiniz. API anahtarınızı güvende tutmayı ve rate limit sınırlarını aşmamaya dikkat etmeyi unutmayın.