Python ile AI API Kullanımı: İlk Adımlar

Yapay zeka tabanlı uygulamalar geliştirmek için Python, en çok tercih edilen programlama dillerinden biridir. Açık API sistemleri sayesinde, büyük dil modellerine (LLM) Python ile kolayca erişebilir ve projelerinizde entegre edebilirsiniz. Bu rehberde, API anahtarınızı nasıl alabileceğinizi, Python ile temel istekleri nasıl yapacağınızı ve çıktıları nasıl işleyeceğinizi adım adım anlatacağız.

API Anahtarı ve Bakiye İşlemleri

Çoğu API platformu, güvenli erişim için API anahtarı kullanır. Sen Apicloud (apicloud.com.tr — OpenAI uyumlu, TL bakiyeli AI API platformu) gibi hizmetlerden de benzer bir anahtar elde edebilirsiniz. Platforma kayıt olduktan sonra kontrol panelinde API key oluşturma seçeneği sunularak, bu anahtar python kodlarınızda doğrulama amacıyla kullanılır.

API anahtarını güvenli bir şekilde saklamanız önemlidir. Kodunuza doğrudan yazmak yerine ortam değişkenleri (environment variables) ile yönetmek en iyi uygulamadır.

Temel Python İsteği (Request) Oluşturma

Python'da bir AI API'ye istek atmak için requests kütüphanesi yaygın olarak kullanılır. Öncelikle kütüphaneyi kurmanız gerekir:

pip install requests

Sonrasında örnek bir istek şu şekilde oluşturulabilir:

import os
import requests

api_key = os.getenv("API_KEY")
url = "https://api.apicloud.com.tr/v1/chat/completions"

headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

data = {
    "model": "gpt-3.5-turbo",
    "messages": [{"role": "user", "content": "Merhaba, nasılsın?"}],
    "max_tokens": 150
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

Yukarıdaki kodda API_KEY ortam değişkeniyle alınır, bu da anahtarınızın güvende kalmasını sağlar. İstek gövdesinde model adı, kullanıcı mesajı ve maksimum token sınırı gibi parametreler yer alır.

Yanıtı İşleme ve Hata Yönetimi

API'den dönen yanıt genellikle JSON formatındadır. Kullanışlı hale getirmek için şu şekilde işlenebilir:

if response.status_code == 200:
    result = response.json()
    assistant_message = result["choices"][0]["message"]["content"]
    print(assistant_message)
else:
    print(f"Hata: {response.status_code}")
    print(response.text)

200 OK kodu başarılı isteği gösterir. Başka bir kod dönerse, HTTP durum koduna göre hata mesajını inceler ve gerekli düzeltmeleri yaparsınız. Token tüketimini takip etmek için yanıt gövdesinde yer alan usage alanına da göz atabilirsiniz.

Gelişmiş Kullanım İpuçları

• Context window yönetimi: Uzun konuşmaları tek seferde göndermek yerine, mesaj listesini parçalara bölerek işlemek daha verimli olur.
• Rate limiting: API platformları genellikle istek sınırlaması uygular. Arka arkaya çoklu isteklerde bekleme süresi eklemek gerekebilir.
• Güvenlik: API anahtarınızı asla public bir repoya yüklemeyin. .env dosyası ve python-dotenv paketiyle yönetimi kolaylaştırın.

Sonuç olarak, Python ve bir AI API'si arasında köprü kurmak oldukça basittir. Anladığınız kadarıyla, OpenAI uyumlu bir API platformu üzerinden Python ile hızlıca entegrasyon kurabilir, projelerinizde yapay zekâ destekli özellikler barındırabilirsiniz.