Python Kullanarak OpenAI API Entegrasyonu Nasıl Yapılır?

​

1. Hazırlık Süreci: API Anahtarı ve Kurulum​

API Anahtarı Alma​

1. OpenAI Platform adresine gidin ve bir hesap oluşturun.
2. Sağ üst köşedeki profil simgesinden "View API Keys" sekmesine geçin.
3. "Create new secret key" butonuna tıklayarak size özel anahtarı oluşturun.
   
   

   Dikkat: API anahtarınızı asla GitHub gibi halka açık platformlarda paylaşmayın. Bu anahtar, hesabınızdaki kredilerin harcanmasına neden olabilir.

   Genişletmek için tıkla ...

Gerekli Kütüphanelerin Kurulması​

2. İlk Python Kodunu Yazma: "Hello World"​

import os
from openai import OpenAI
from dotenv import load_dotenv

# .env dosyasındaki anahtarı yükle
load_dotenv()
client = OpenAI(api_key=os.getenv("OPENAI_API_KEY"))

response = client.chat.completions.create(
  model="gpt-4o",
  messages=[
    {"role": "system", "content": "Sen yardımcı bir asistansın."},
    {"role": "user", "content": "Python ile API entegrasyonu neden önemlidir?"}
  ]
)

print(response.choices[0].message.content)

Kodun Anatomisi​

• Client Yapısı: Yeni OpenAI SDK'sı (v1.0+), bir OpenAI nesnesi üzerinden çalışır.
• Messages Listesi: Modelin bağlamı anlaması için roller (system, user, assistant) kullanılır.
• Model: gpt-4o veya gpt-3.5-turbo gibi modeller arasından seçim yapılır.

3. OpenAI API Mesaj Rolleri ve Mimari​

1. System: Modelin kişiliğini ve sınırlarını belirler. (Örn: "Sadece teknik terimlerle yanıt ver.")
2. User: Kullanıcının gönderdiği asıl komut veya sorudur.
3. Assistant: Modelin verdiği yanıttır. Çok turlu sohbetlerde geçmişi hatırlatmak için bu rol kullanılır.

4. Gelişmiş Parametrelerin Kullanımı​

• Temperature (Sıcaklık): 0 ile 2 arasındadır. 0'a yakın değerler daha net ve odaklanmış yanıtlar verirken, 2'ye yakın değerler yaratıcılığı artırır.
• Max Tokens: Yanıtın maksimum uzunluğunu sınırlar. Gereksiz kredi harcamasını önler.
• Top-P: Çekirdek örnekleme (nucleus sampling) yöntemidir. Kelime havuzunun çeşitliliğini kontrol eder.

5. Hata Yönetimi (Error Handling)​

try:
    response = client.chat.completions.create(model="gpt-4o", messages=[...])
except openai.RateLimitError:
    print("Dakikalık istek limitine ulaşıldı!")
except openai.APIConnectionError:
    print("Sunucuya bağlanılamadı.")
except openai.AuthenticationError:
    print("API anahtarı geçersiz.")

6. Token Yönetimi ve Maliyet Optimizasyonu​

Maliyeti Düşürme Stratejileri:​

• Kısa System Promptlar: Modelin her istekle birlikte okuduğu sistem talimatlarını optimize edin.
• Gereksiz Geçmişten Kaçının: Sohbet geçmişini modele gönderirken sadece son birkaç mesajı göndererek "token şişmesini" önleyin.
• Uygun Model Seçimi: Karmaşık olmayan görevler için daha ucuz olan gpt-4o-mini modelini tercih edin.

7. Uygulama Alanları ve Proje Fikirleri​

1. Müşteri Destek Botu: Şirketinizin dökümantasyonunu kullanarak soruları yanıtlayan bir asistan.
2. İçerik Otomasyonu: Belirli anahtar kelimelerden SEO uyumlu blog başlıkları ve taslakları oluşturan araçlar.
3. Veri Analizi: Karmaşık CSV dosyalarını analiz edip özetleyen bir sistem.
4. Kod İnceleme Aracı: Geliştiricilerin yazdığı kodlardaki güvenlik açıklarını bulan bir script.

8. Güvenlik ve En İyi Uygulamalar (Best Practices)​

• API Anahtarı Güvenliği: Anahtarlarınızı asla kodun içine gömmeyin. os.environ kullanın.
• Streaming (Akış): Uzun yanıtlarda kullanıcının beklememesi için stream=True parametresini kullanarak kelimelerin yazıldıkça ekrana gelmesini sağlayın.
• Moderasyon: Kullanıcı girdilerini client.moderations.create üzerinden geçirerek zararlı içerikleri filtreleyin.

9. Sonuç: Geleceği Python ile İnşa Etmek​