ChatGPT API, geliştiricilerin uygulamalarına gelişmiş AI yeteneklerini entegre etme şeklini devrim niteliğinde değiştirdi. Bu kapsamlı rehber, ChatGPT API'sini etkili bir şekilde uygulama ve kullanma hakkında bilmeniz gereken her şeyi size anlatacak.
ChatGPT API ile Başlarken
ChatGPT API'sini kullanmaya başlamadan önce, OpenAI hesabınızı oluşturmanız ve API kimlik bilgilerinizi almanız gerekir.
Ön Koşullar
- API erişimi olan OpenAI hesabı
- OpenAI panonuzdan API anahtarı
- Temel programlama bilgisi (Python, JavaScript, vb.)
- HTTP istekleri ve JSON anlayışı
Ortamınızı Kurma
Gerekli Kütüphaneleri Yükleme
Python geliştiricileri için:
pip install openai requests
Node.js geliştiricileri için:
npm install openai axios
Kimlik Doğrulama
API anahtarınızı her zaman güvenli tutun ve asla istemci tarafı kodda açığa çıkarmayın. Kimlik bilgilerinizi saklamak için ortam değişkenlerini kullanın:
OPENAI_API_KEY=your_api_key_here
İlk API Çağrınızı Yapma
Python Örneği
import openai
import os
# API anahtarınızı ayarlayın
openai.api_key = os.getenv('OPENAI_API_KEY')
# Basit bir sohbet tamamlama isteği yapın
response = openai.ChatCompletion.create(
model="gpt-3.5-turbo",
messages=[
{"role": "user", "content": "Merhaba, nasılsın?"}
]
)
print(response.choices[0].message.content)
JavaScript Örneği
const { Configuration, OpenAIApi } = require('openai');
const configuration = new Configuration({
apiKey: process.env.OPENAI_API_KEY,
});
const openai = new OpenAIApi(configuration);
async function getChatResponse() {
const response = await openai.createChatCompletion({
model: 'gpt-3.5-turbo',
messages: [
{ role: 'user', content: 'Merhaba, nasılsın?' }
],
});
console.log(response.data.choices[0].message.content);
}
API Parametrelerini Anlama
Temel Parametreler
- model: gpt-3.5-turbo, gpt-4, vb. arasından seçim yapın
- messages: Konuşma mesajları dizisi
- max_tokens: Üretilecek maksimum token sayısı
- temperature: Rastgeleliği kontrol eder (0-2)
- top_p: Nucleus örneklemesi için temperature alternatifi
Mesaj Rolleri
- system: Asistan için davranış ve bağlam belirler
- user: Kullanıcıdan gelen mesajlar
- assistant: AI'dan önceki yanıtlar
En İyi Uygulamalar
Prompt Mühendisliği
- Talimatlarınızda spesifik ve net olun
- Bağlam belirlemek için sistem mesajlarını kullanın
- Gerektiğinde örnekler sağlayın
- Karmaşık görevleri daha küçük adımlara bölün
Hata Yönetimi
API çağrıları için her zaman uygun hata yönetimi uygulayın:
- Hız sınırlaması (429 hataları)
- Kimlik doğrulama hataları (401)
- Token limiti aşıldı (400)
- Ağ zaman aşımları
Maliyet Optimizasyonu
- Kullanım durumunuz için uygun modeli seçin
- Makul max_tokens limitleri belirleyin
- Mümkün olduğunda yanıtları önbelleğe alın
- Yüksek hacimli uygulamalar için istek kuyruğu uygulayın
Gelişmiş Kullanım Durumları
Konuşma Uygulamaları
API çağrılarınıza önceki mesajları dahil ederek konuşma bağlamını koruyun.
İçerik Üretimi
Makale, özet, çeviri ve yaratıcı içerik üretmek için API'yi kullanın.
Kod Yardımı
Kod inceleme, hata ayıklama ve programlama yardımı için ChatGPT'den yararlanın.
Müşteri Desteği
Müşteri hizmetleri uygulamaları için akıllı chatbot'lar oluşturun.
Hız Limitleri ve Fiyatlandırma
Üretim uygulamaları için OpenAI'ın hız limitleri ve fiyatlandırma yapısını anlamak çok önemlidir:
- Farklı modeller için farklı limitler
- Token tabanlı fiyatlandırma
- Dakika başına istek sınırlamaları
- Kullanım izleme ve uyarıları
Güvenlik Değerlendirmeleri
- API anahtarlarını asla istemci tarafı kodda açığa çıkarmayın
- Kullanıcı kimlik doğrulaması ve yetkilendirmesi uygulayın
- Kullanıcı girdilerini temizleyin
- Olağandışı desenler için API kullanımını izleyin
- Tüm API iletişimleri için HTTPS kullanın
Test Etme ve Hata Ayıklama
Etkili test etme için ipuçları:
- Basit test durumları ile başlayın
- API isteklerini ve yanıtlarını günlüğe kaydedin
- Deneyim için OpenAI'ın playground'unu kullanın
- Kapsamlı hata günlüğü uygulayın
Türkçe Kullanım İpuçları
ChatGPT API'sini Türkçe içerik için kullanırken:
- Sistem mesajında Türkçe yanıt verme talimatı verin
- Türkçe karakter kodlamasına dikkat edin
- Kültürel bağlam sağlayın
- Türkçe dil yapısına uygun promptlar hazırlayın