Yapay Zeka

OpenAI API Nasıl Kullanılır? Modeller, API Anahtarı ve İlk Entegrasyon Rehberi

Talha Aslan 14 dakikalık okuma 1 görüntülenme

OpenAI API'yi nasıl kullanırsınız?

OpenAI API, OpenAI modellerini kendi yazılımınızdan HTTP istekleriyle çağırmanızı sağlayan ücretli bir geliştirici arayüzüdür. Kullanmak için platform hesabı açar, API anahtarı oluşturur, bakiye yükler ve resmi SDK ya da doğrudan HTTP ile Responses API uç noktasına istek gönderirsiniz.

Bu yazıda ilk entegrasyonu uçtan uca anlatıyorum: hesap, anahtar, model seçimi, ilk istek, maliyet, hatalar ve güvenlik. Ancak büyük dil modellerinin teorisine girmiyorum; odağım, bir web sitesine ya da iş sürecine ilk çalışan bağlantıyı kurmanız.

Ekibimle yaptığımız entegrasyonlarda gördüğüm şu: kod kısmı genelde bir saatte biter. Asıl zaman, anahtar güvenliği, maliyet kontrolü ve hata senaryolarını düşünmeye gider. Bu yüzden bu başlıklara da ayrıca yer veriyorum.

OpenAI API ile ChatGPT arasındaki fark nedir?

Birçok kişi bu ikisini aynı şey sanıyor. ChatGPT, OpenAI'ın son kullanıcıya sunduğu sohbet uygulamasıdır. OpenAI API ise geliştiricilerin aynı model ailelerini kendi uygulamalarına bağlamasını sağlayan arayüzdür.

Dolayısıyla faturalandırma da ayrıdır. ChatGPT Plus ya da Pro aboneliği API kullanımını kapsamaz. API tarafında kullandığınız kadar ödersiniz ve ücreti token sayısı belirler.

KonuChatGPTOpenAI API
Kimin için?Son kullanıcıGeliştirici ve işletme
ArayüzWeb, masaüstü, mobil uygulamaHTTP istekleri ve SDK
Ücret modeliAylık abonelikKullandıkça öde, token bazlı
ÖzelleştirmeSınırlı (ayarlar, GPT'ler)Tam kontrol: talimat, çıktı biçimi, araçlar
Veri akışıKullanıcı sohbetiSizin sisteminizden gelen veri

Kısacası ChatGPT bir ürün, OpenAI API ise o ürünün altındaki modellere açılan kapıdır. Kendi web sitenizde bir asistan, otomatik sınıflandırma ya da içerik taslağı istiyorsanız ihtiyacınız olan API'dir.

OpenAI API hesabını açıp faturalandırmayı nasıl ayarlarsınız?

İlk adım, OpenAI platform sitesinde hesap açmaktır. ChatGPT hesabınızla giriş yapabilirsiniz; ancak API tarafı ayrı bir kuruluş (organization) ve proje yapısıyla çalışır.

  1. Platform hesabına giriş yapın ve kuruluş adınızı belirleyin.
  2. Faturalandırma bölümünden ödeme yöntemi ekleyin ve ön ödemeli kredi yükleyin.
  3. Her uygulama için ayrı bir proje oluşturun; örneğin "web sitesi asistanı" ve "iç raporlama" gibi.
  4. Proje bazında harcama limiti ve bildirim eşiği tanımlayın.
  5. Ekip arkadaşlarınızı gerekli rollerle projeye davet edin.

Proje ayrımı ilk bakışta gereksiz görünebilir. Ama iki farklı uygulamanın maliyetini ve anahtarlarını ayrı izlemek, ileride "bu fatura nereden çıktı?" sorusunu saniyeler içinde yanıtlamanızı sağlar.

Bazı gelişmiş modeller kuruluş doğrulaması gerektirebilir. Bu nedenle beklediğiniz bir model listede yoksa önce kuruluş ayarlarını kontrol edin.

OpenAI API anahtarını nasıl oluşturur ve saklarsınız?

API anahtarını ilgili projenin API anahtarları sayfasından oluşturursunuz. Platform anahtarı yalnız bir kez tam olarak gösterir; bu yüzden hemen güvenli bir yere kopyalayın.

Resmi hızlı başlangıç belgesi, anahtarı OPENAI_API_KEY adlı ortam değişkeninde tutmanızı öneriyor. Resmi SDK'lar bu değişkeni otomatik okur, yani anahtarı koda yazmanız gerekmez.

  • Anahtarı asla kaynak koda, Git deposuna ya da ön yüz (tarayıcı) koduna koymayın.
  • Sunucuda ortam değişkeni ya da gizli anahtar yöneticisi kullanın; .env dosyasını depoya eklemeyin.
  • Her ortam için (geliştirme, canlı) ayrı anahtar kullanın.
  • Sızıntı şüphesinde anahtarı hemen iptal edin ve yenisini üretin.

Tarayıcı tarafı özellikle kritik. JavaScript ile ön yüzden doğrudan API çağırırsanız sayfa kaynağına bakan herkes anahtarınızı okur ve herkes sizin hesabınıza istek atabilir. Doğru mimari, isteği kendi sunucunuzdan yapmak ve tarayıcıya yalnız sonucu göndermektir.

Hangi OpenAI modelini seçmelisiniz?

Model seçimi hem kaliteyi hem maliyeti belirler. OpenAI'ın resmi model sayfası, Eylül 2026 itibarıyla genel amaçlı işler için GPT-6 ailesinde üç seçenek öneriyor: karmaşık akıl yürütme ve kodlama için GPT-6 Astra, zeka ve maliyet dengesi için GPT-6 Sol, yüksek hacimli ve maliyet hassas işler için GPT-6 Luna.

Bunların yanında görsel üretim, gerçek zamanlı ses, konuşmayı metne çevirme ve metni sese çevirme için OpenAI ayrı uzman modeller sunuyor. Model adları sık değiştiği için entegrasyon yapmadan önce güncel listeyi mutlaka kontrol edin.

İhtiyaçÖnerilen yönNeden?
Sınıflandırma, etiketleme, kısa özetMaliyet odaklı küçük model (ör. Luna)Yüksek hacim, basit görev
Müşteri destek asistanıDengeli model (ör. Sol)Kalite ve hız dengesi
Kod üretimi, çok adımlı analizEn güçlü model (ör. Astra)Derin akıl yürütme
Görsel üretimiGörsel modeliMetin modeli görsel üretmez
Ses ve canlı konuşmaRealtime ve ses modelleriDüşük gecikme gerekir

Benim önerim, en ucuz uygun modelle başlamak ve kaliteyi ölçerek yukarı çıkmaktır. Tersini yaparsanız gereksiz maliyetle başlarsınız ve bunu fark etmek zaman alır.

Ayrıca aynı uygulamada birden fazla model kullanmak da mümkündür. Örneğin gelen talebi küçük bir modelle sınıflandırıp yalnız karmaşık olanları güçlü modele yönlendirebilirsiniz.

Responses API nedir ve neden onunla başlamalısınız?

Responses API, OpenAI'ın metin üretimi için önerdiği güncel arayüzdür. Resmi belgeler, modellerin Responses API ve istemci SDK'ları üzerinden kullanılabildiğini belirtiyor ve hızlı başlangıç örneklerini bu uç noktayla veriyor.

Uç nokta POST https://api.openai.com/v1/responses adresidir. En basit istekte yalnız iki alan gönderirsiniz: model ve input. Yanıt nesnesindeki output_text alanı, modelin ürettiği metni doğrudan verir.

Responses API ayrıca araç kullanımı (web araması, dosya araması, fonksiyon çağırma gibi), yapılandırılmış çıktı ve çok turlu konuşma yönetimi gibi özellikleri tek arayüzde birleştirir. Böylece ileride özellik eklediğinizde farklı bir uç noktaya taşınmak zorunda kalmazsınız.

Yeni bir projeye başlıyorsanız doğrudan Responses API ile başlamanızı öneririm. Eski projelerde kullanılan Chat Completions arayüzüyle farkını ilerideki bölümde ayrıca anlatıyorum.

Python ile ilk OpenAI API isteğini nasıl gönderirsiniz?

Python için önce resmi kütüphaneyi kurun: pip install openai. Ardından ortam değişkeninizi tanımlayın. macOS ve Linux için terminalde export OPENAI_API_KEY=anahtariniz komutunu kullanabilirsiniz.

Resmi hızlı başlangıç belgesindeki ilk istek şu satırlardan oluşur:

from openai import OpenAI

client = OpenAI()

response = client.responses.create(model="gpt-6-astra", input="Bir cümlelik bir masal yaz.")

print(response.output_text)

Burada istemci anahtarı ortam değişkeninden okur. Modeli değiştirmek için yalnız model adını güncellersiniz. Örneğin maliyet hassas bir iş için daha küçük bir model adı yazabilirsiniz; güncel model kimliklerini model sayfasından kopyalayın.

İlk istekte hata alırsanız üç şeyi kontrol edin: anahtarın doğru projeye ait olması, hesapta bakiye bulunması ve model adının doğru yazılması. Vakaların büyük bölümü bu üçünden birine çıkar.

JavaScript ve curl ile ilk isteği nasıl yaparsınız?

Node.js tarafında kurulum komutu npm install openai şeklindedir. İstek mantığı Python ile aynıdır, yalnız sözdizimi değişir.

import OpenAI from "openai";

const client = new OpenAI();

const response = await client.responses.create({ model: "gpt-6-astra", input: "Merhaba" });

console.log(response.output_text);

Bu kodu yalnız sunucu tarafında (Node.js, Next.js API route, sunucu fonksiyonu gibi) çalıştırın. Aynı kodu tarayıcıda çalıştırmak, anahtarınızı herkese açmak demektir.

SDK kullanmadan test etmek isterseniz curl yeterlidir: https://api.openai.com/v1/responses adresine, Authorization: Bearer başlığında anahtarınızla ve JSON gövdede model ile input alanlarıyla POST isteği gönderirsiniz. PHP gibi resmi SDK'sı olmayan dillerde de mantık aynıdır; HTTP isteğini kendiniz kurarsınız.

Tüm parametrelerin ayrıntısını OpenAI hızlı başlangıç belgesinde bulabilirsiniz.

Talimatı ve girdiyi nasıl düzenlemelisiniz?

İlk istek çalıştıktan sonra kaliteyi belirleyen şey talimattır. Responses API, geliştirici talimatını ayrı bir alanda göndermenize izin verir; böylece kullanıcı girdisi ile sizin kurallarınız birbirine karışmaz.

  • Rol ve bağlam: Modelin kim olduğunu ve kime hizmet ettiğini yazın.
  • Kurallar: Uzunluk, ton, yasaklar (örneğin fiyat uydurmama) gibi sınırları net verin.
  • Çıktı biçimi: Düz metin mi, madde listesi mi, JSON mu, açıkça belirtin.
  • Örnek: Gerekirse kısa bir girdi çıktı örneği ekleyin.

Kullanıcıdan gelen metni ise talimattan ayrı tutun. Örneğin web sitenizdeki formdan gelen soruyu doğrudan talimata eklerseniz kötü niyetli biri "önceki talimatları yok say" gibi ifadelerle modeli yönlendirmeye çalışabilir. Buna istem enjeksiyonu denir ve tamamen önlemek zordur; ancak rol ayrımı riski azaltır.

Ayrıca talimatı kısa tutun. Her istekte tekrar gönderilen uzun bir talimat, girdi tokenı olarak faturanıza yansır.

Yapılandırılmış çıktıyı (JSON) nasıl alırsınız?

Web sitesi ya da veritabanı entegrasyonlarında serbest metin çoğu zaman işe yaramaz. Programınızın okuyabileceği sabit alanlara ihtiyaç duyarsınız.

OpenAI API, yapılandırılmış çıktı özelliğiyle modelin yanıtını belirlediğiniz JSON şemasına bağlar. Şemada alan adlarını, türlerini ve zorunlu alanları tanımlarsınız. Ayrıntıları yapılandırılmış çıktı rehberinde bulabilirsiniz.

Örneğin bir müşteri yorumu için "duygu", "konu" ve "ozet" alanlarını tanımlayabilirsiniz. Duygu alanına yalnız "olumlu", "olumsuz" ve "nötr" değerlerini izin verirseniz, model başka bir kelime üretemez.

  1. Şemayı olabildiğince sade tutun; gereksiz iç içe nesnelerden kaçının.
  2. İzin verilen değerleri enum olarak listeleyin.
  3. Yanıtı yine de kodunuzda doğrulayın; hiçbir dış veriye körü körüne güvenmeyin.

Böylece model çıktısı doğrudan veritabanına ya da arayüze aktarılabilecek temiz bir veri haline gelir.

Chat Completions ile Responses API arasındaki fark nedir?

İnternetteki eski örneklerin çoğu Chat Completions arayüzünü kullanır. Bu arayüz, mesajları rol bazlı bir liste halinde gönderdiğiniz daha eski bir yapıdır.

Responses API ise bu yapıyı genişletir. Araç kullanımı, konuşma durumunu sunucu tarafında sürdürme ve farklı çıktı türleri tek arayüzde buluşur. OpenAI yeni projeler için Responses API'yi öneriyor.

ÖzellikChat CompletionsResponses API
Girdi yapısıMesaj listesi (system, user, assistant)Tek girdi ya da mesaj listesi, ayrı talimat alanı
Metin çıktısıchoices dizisi içindeoutput_text ile doğrudan
Yerleşik araçlarSınırlıWeb ve dosya araması gibi araçlar
Önerilen kullanımMevcut eski projelerYeni projeler

Eski bir entegrasyonunuz sorunsuz çalışıyorsa hemen taşımak zorunda değilsiniz. Ancak yeni özellik ekleyecekseniz taşıma planını erken yapmak, ileride iki farklı yapıyı birlikte sürdürme yükünden kurtarır.

OpenAI API maliyetini nasıl hesaplarsınız?

OpenAI API maliyeti token bazlıdır. Token, modelin metni işlerken kullandığı parçalardır; kabaca bir kelime bir veya birkaç tokena karşılık gelir ve Türkçe gibi eklemeli dillerde bu oran İngilizceye göre genellikle daha yüksektir.

Faturanızı üç kalem belirler: gönderdiğiniz girdi tokenı, modelin ürettiği çıktı tokenı ve seçtiğiniz modelin birim fiyatı. Güncel fiyatları resmi fiyat sayfasından kontrol edin, çünkü fiyatlar model güncellemeleriyle değişiyor.

  • Talimatı kısaltın ve her istekte gereksiz bağlam göndermeyin.
  • Çıktı uzunluğunu en fazla token parametresiyle sınırlayın.
  • Basit işlerde küçük model kullanın.
  • Aciliyeti olmayan toplu işlerde toplu işlem (Batch) seçeneğini değerlendirin.
  • Aynı sabit talimatı tekrar tekrar gönderiyorsanız istem önbelleğinden yararlanan yapıyı araştırın.

Pratik yöntemim şudur: gerçek verilerle 50 istek gönderin, kullanım panelinden toplam maliyeti okuyun ve istek başına ortalamayı çıkarın. Bu rakamı aylık beklenen istek sayısıyla çarptığınızda tahmininiz gerçekçi olur.

Kullanım limitleri ve seviyeler (tier) nasıl işler?

OpenAI, her kuruluşa dakikalık istek ve token sınırları uygular. Bu sınırlar harcama geçmişinize göre yükselen kullanım seviyelerine bağlıdır. Yeni bir hesap düşük seviyeden başlar; ödeme yaptıkça ve zaman geçtikçe üst seviyelere çıkar.

Bu durum özellikle lansman günlerinde önem taşır. Örneğin yeni açtığınız hesapla binlerce kullanıcıya hizmet vermeye çalışırsanız kısa sürede hız sınırı hatası alırsınız.

Güncel seviyeleri ve sınırları hız sınırları rehberinden ve hesabınızın limitler sayfasından görebilirsiniz. Canlıya çıkmadan önce beklenen trafiği bu sınırlarla karşılaştırın.

Ayrıca kendi uygulamanızda da sınır koyun. Tek bir kullanıcının dakikada yüzlerce istek göndermesini engellemek, hem maliyetinizi hem de diğer kullanıcıların deneyimini korur.

Bunun yanında limitlerin model bazında farklı olabileceğini unutmayın. Örneğin küçük bir modelde rahat çalışan trafik, daha büyük bir modele geçtiğinizde sınıra takılabilir. Bu yüzden model değiştirdiğinizde limit tablosuna yeniden bakın ve yük testini tekrarlayın.

Hata kodları nelerdir ve onları nasıl yönetirsiniz?

Her API entegrasyonu hata alır. İyi bir entegrasyon, hatayı kullanıcıya çirkin bir ekran olarak değil, anlaşılır bir mesaj olarak yansıtır.

KodAnlamıNe yapmalısınız?
401Kimlik doğrulama hatasıAnahtarı ve projeyi kontrol edin
403Erişim reddiBölge, model erişimi ve izinleri kontrol edin
429Hız sınırı ya da kota aşımıBekleyip yeniden deneyin, bakiyeyi kontrol edin
500Sunucu tarafı hataKısa bekleme sonrası yeniden deneyin
503Aşırı yükArtan aralıklarla yeniden deneyin

Yeniden deneme için üstel geri çekilme (exponential backoff) yöntemini kullanın: ilk denemede kısa, sonrakilerde giderek artan sürelerle bekleyin ve deneme sayısına üst sınır koyun. Resmi SDK'lar bazı hatalarda otomatik yeniden deneme yapar; yine de kendi zaman aşımı ve deneme sınırınızı tanımlayın.

Son olarak her hatayı kayıt altına alın. Hangi uç noktada, hangi modelde, hangi saatte hata aldığınızı görmek, sorunun sizde mi yoksa servis tarafında mı olduğunu hızla anlamanızı sağlar.

OpenAI API ile güvenli bir mimariyi nasıl kurarsınız?

Güvenlik yalnız anahtarı saklamaktan ibaret değildir. Kullanıcı girdisi, model çıktısı ve maliyet de güvenlik konusudur.

  1. Sunucu aracı katmanı: Tarayıcı yalnız sizin sunucunuza konuşur; OpenAI API çağrısını sunucu yapar.
  2. Kimlik ve sınır: Kullanıcı başına istek limiti ve oturum kontrolü uygulayın.
  3. Girdi temizliği: Uzunluk sınırı koyun, gereksiz kişisel veriyi ayıklayın.
  4. Çıktı kontrolü: Model çıktısını HTML olarak basmadan önce kaçış işlemi uygulayın.
  5. İzleme: Harcama bildirimleri ve olağandışı trafik uyarıları kurun.

Ekipler çıktı kontrolünü sıkça atlar. Model bir yanıtın içinde HTML ya da bağlantı üretebilir; bunu doğrudan sayfaya basarsanız güvenlik açığı yaratırsınız. Dolayısıyla model çıktısını da kullanıcı girdisi kadar güvenilmez kabul edin.

Sitenizin genel güvenlik ve teknik altyapısını düşünürken yapay zeka sonrası teknik SEO yazımdaki kontrol listesi de işinize yarayabilir.

OpenAI gönderdiğiniz verileri ne için kullanıyor?

İşletmelerin en sık sorduğu soru budur. OpenAI, kurumsal gizlilik sayfasında API üzerinden gönderilen verileri varsayılan olarak modellerini eğitmek için kullanmadığını belirtiyor. Kötüye kullanımı izlemek amacıyla verileri sınırlı bir süre saklayabileceğini de ayrıca açıklıyor.

Bu yine de KVKK ve GDPR sorumluluklarınızı ortadan kaldırmaz. Kişisel veri gönderiyorsanız aydınlatma metninizde bunu açıklamanız, yurt dışı aktarım koşullarını değerlendirmeniz ve gerekiyorsa veri işleme sözleşmesi imzalamanız gerekir.

  • Modele gerçekten gerekmeyen kişisel verileri göndermeyin.
  • Kimlik bilgilerini mümkünse takma adlarla değiştirin.
  • Sağlık, finans gibi hassas alanlarda hukuk danışmanınızla birlikte karar verin.

Kısacası en güvenli veri, hiç gönderilmeyen veridir. Çoğu sınıflandırma ve özet işinde kişinin adına ya da telefonuna ihtiyaç yoktur.

OpenAI API web sitesinde hangi işler için kullanılabilir?

Teknik kurulum tamamlandıktan sonra asıl soru "ne için?" sorusudur. Sahada en çok değer ürettiğini gördüğüm kullanım alanları şunlar:

  • Site içi asistan: Sık sorulan sorulara kendi içeriğinizden yanıt veren bir destek asistanı.
  • Form ve talep özeti: İletişim formundan gelen mesajı özetleyip doğru ekibe yönlendirme.
  • İçerik taslağı: Ürün açıklaması ya da meta açıklama için editör kontrollü taslaklar.
  • Arama ve sınıflandırma: Yorumları, talepleri ya da ürünleri otomatik etiketleme.

Bu kullanım alanlarının kullanıcı deneyimine etkisini web sitesinde yapay zeka kullanımı yazımda ayrıntılı ele aldım. Kod yazmadan otomasyon kurmak isterseniz web tasarımında yapay zeka ve otomasyon yazısı da iyi bir başlangıçtır.

Önerim, tek bir net kullanım alanıyla başlamak ve ölçmektir. Beş özelliği aynı anda eklemek, hangisinin işe yaradığını görmenizi zorlaştırır.

Ürettiğiniz içeriği SEO açısından nasıl değerlendirmelisiniz?

OpenAI API ile içerik üretmek kolaydır; iyi içerik üretmek ise başka bir iştir. Arama motorları, içeriğin nasıl üretildiğinden çok, kullanıcıya gerçekten değer katıp katmadığına bakar.

Otomatik üretilen yüzlerce benzer sayfa, sitenizin genel kalite algısını düşürebilir. Bu nedenle model çıktısını taslak olarak görün; uzman kontrolü, özgün bilgi ve gerçek deneyim ekleyin.

Yayından önce metinleri SEO analiz aracıyla kontrol edebilir, yapılandırılmış veri için schema oluşturucuyu kullanabilirsiniz. Yapay zeka arama motorlarının sitenizi nasıl okuduğunu yönetmek için llms.txt oluşturucu da işinize yarar.

Yapay zeka destekli aramaların içerik stratejisine etkisini merak ediyorsanız AI Overviews için içerik yazımı yazıma göz atın.

Canlıya çıkmadan önce hangi kontrolleri yapmalısınız?

İlk entegrasyonu canlıya almadan önce aşağıdaki listeyi tek tek işaretlemenizi öneririm. Bu liste, ekibimle yaptığımız devreye alma toplantılarının özetidir.

  1. Anahtar yalnız sunucu ortam değişkeninde mi, depoda iz var mı?
  2. Proje bazlı harcama limiti ve bildirimleri tanımlı mı?
  3. Kullanıcı başına istek sınırı çalışıyor mu?
  4. 401, 429 ve 500 hataları için kullanıcı anlaşılır bir mesaj görüyor mu?
  5. Model çıktısı sayfaya basılmadan önce kaçış işleminden geçiyor mu?
  6. Aydınlatma metni yapay zeka işlemesini açıklıyor mu?
  7. En az 50 gerçekçi örnekle kalite testi yaptınız mı?

Bu listenin her maddesi, bir projede yaşanan bir sorundan doğdu. Özellikle harcama limiti ve kullanıcı başına sınır, küçük bir hatanın büyük bir faturaya dönüşmesini engeller.

Canlıya çıktıktan sonra ilk hafta günlük olarak kullanım panelini ve hata kayıtlarını inceleyin. Böylece beklenmedik davranışları erken yakalarsınız.

İlk entegrasyonda en sık yapılan hatalar nelerdir?

Danışmanlık yaptığım projelerde tekrar eden hataları şöyle özetleyebilirim:

  • ChatGPT aboneliğinin API kullanımını kapsadığını düşünmek.
  • API anahtarını ön yüz koduna ya da herkese açık depoya koymak.
  • İnternetteki eski örnekleri kopyalayıp güncel olmayan model adları kullanmak.
  • Harcama limiti koymadan canlıya çıkmak.
  • Model çıktısını doğrulamadan veritabanına yazmak.
  • Tek bir büyük model ile her işi yapmaya çalışmak.

Eski örnekler meselesi özellikle yaygın. Model adları ve önerilen arayüzler hızla değişiyor. Bu nedenle bir blog yazısından ya da forumdan kod kopyalarken, model kimliğini ve uç noktayı her zaman resmi belgelerle karşılaştırın.

Bu yazı için de aynı kural geçerli: buradaki model adları Eylül 2026 itibarıyla resmi sayfadaki bilgilere dayanıyor. Siz okuduğunuzda güncel listeyi yeniden kontrol edin.

Konuşma geçmişini ve bağlamı nasıl yönetirsiniz?

Bir destek asistanı kurduğunuzda model, önceki mesajları hatırlamalıdır. Ancak API, siz bir şey yapmadıkça her isteği bağımsız değerlendirir.

Bunun iki yolu var. Birincisi, önceki mesajları her istekte girdiye kendiniz eklemektir. İkincisi, Responses API'nin önceki yanıtın kimliğine atıf yaparak konuşmayı sürdürmenize izin veren yapısını kullanmaktır. Hangisini seçeceğinizi veri saklama politikanız belirler.

  • Uzun geçmişi sınırsız göndermeyin; her eski mesaj girdi tokenı olarak faturanızı büyütür.
  • Belirli bir uzunluktan sonra eski mesajları kısa bir özete dönüştürün.
  • Oturum bittiğinde geçmişi silme ya da saklama kuralınızı yazılı hale getirin.

Kısacası bağlam, kaliteyi artıran ama maliyeti de büyüten bir kaynaktır. Dolayısıyla onu bilinçli yönetin.

Kendi içeriğinizle yanıt veren bir asistanı nasıl beslersiniz?

Genel bir model, sizin ürünlerinizi, fiyat politikanızı ya da iade koşullarınızı bilmez. Bu bilgiyi modele vermezseniz tahmin yürütür ve yanlış bilgi üretebilir.

En basit yöntem, ilgili metni isteğe bağlam olarak eklemektir. Örneğin sık sorulan sorular sayfanızın ilgili bölümünü talimatın yanına koyarsınız. Daha büyük içerik setlerinde ise OpenAI API'nin dosya arama aracı ya da vektör tabanlı arama çözümleri devreye girer.

Hangi yöntemi seçerseniz seçin, iki kuralı unutmayın. Birincisi, modele "bilgi bağlamda yoksa bilmediğini söyle" talimatı verin. İkincisi, kaynak içeriğinizi güncel tutun; eski bir fiyat listesi, asistanın da eski fiyat söylemesi anlamına gelir.

Böylece asistanınız yaratıcı bir tahminci değil, sizin içeriğinize sadık bir yardımcı olur.

Yanıtları akış (streaming) ile göstermek neden önemlidir?

Uzun bir yanıtın tamamlanmasını beklemek, kullanıcıya birkaç saniyelik boş bir ekran demektir. Bu süre, özellikle sohbet arayüzlerinde sitenin yavaş ya da bozuk olduğu hissini yaratır.

OpenAI API, yanıtı parça parça göndermenize izin veren akış seçeneği sunar. Böylece model yazdıkça metin ekranda belirir ve kullanıcı ilk kelimeleri hemen görür. Toplam süre aynı kalsa bile algılanan hız belirgin biçimde artar.

  • Sohbet asistanı ve uzun metin üreten arayüzlerde akışı açın.
  • Arka planda çalışan toplu işlerde akışa gerek yoktur; tam yanıtı beklemek daha basittir.
  • Akış sırasında bağlantı koparsa kullanıcıya yeniden deneme seçeneği sunun.

Kısacası akış, kod tarafında küçük bir ek iş, kullanıcı deneyiminde ise büyük bir farktır. Ancak sunucu ile tarayıcı arasındaki katmanın da akışı desteklemesi gerekir; bu yüzden mimariyi baştan buna göre planlayın.

OpenAI API entegrasyonunda ne zaman profesyonel destek almalısınız?

Basit bir test ya da iç araç için çoğu geliştirici bu rehberle ilerleyebilir. Ancak entegrasyon müşteriye dokunuyorsa, kişisel veri işliyorsa ya da web sitesinin arama görünürlüğünü etkiliyorsa, işin teknik kısmı kadar strateji kısmı da önem kazanır.

Ekibimle yürüttüğümüz projelerde entegrasyonu web tasarım ve SEO danışmanlığı süreçleriyle birlikte ele alıyoruz. Böylece asistan ya da içerik aracı yalnız çalışmakla kalmıyor, sitenin hedefleriyle de uyumlu çalışıyor.

Yapay zeka arama motorlarında markanızın nasıl göründüğü de bu resmin parçası. Bu konuda markanızın ChatGPT ve Gemini içinde nasıl göründüğü yazımı okuyabilirsiniz.

Özetle OpenAI API, doğru kurulduğunda küçük bir ekibe büyük bir kapasite kazandırır. Yanlış kurulduğunda ise sessizce maliyet ve risk üretir. Farkı yaratan, ilk günden güvenlik, ölçüm ve kalite kontrolünü düşünmektir.

Sıkça Sorulan Sorular

OpenAI API ücretsiz mi?
Hayır, OpenAI API kullandıkça ödeme modeliyle çalışır. Ücreti gönderdiğiniz ve aldığınız token sayısı ile seçtiğiniz modelin birim fiyatı belirler. Hesaba ön ödemeli kredi yüklemeniz gerekir. Küçük bir modelle yapılan testler genellikle düşük maliyetlidir, yine de proje bazlı harcama limiti tanımlamanızı ve kullanım panelini düzenli izlemenizi öneririm.
ChatGPT Plus aboneliğim OpenAI API kullanımını kapsıyor mu?
Kapsamıyor. ChatGPT aboneliği yalnız sohbet uygulaması içindir. OpenAI API ise platform hesabı üzerinden ayrı faturalanır ve ayrı bakiye ister. İki hesabı aynı e-posta ile açabilirsiniz, ancak ödeme ve kullanım takibi birbirinden bağımsız ilerler. Bu ayrımı bilmemek, ilk kurulumda en sık yaşanan kafa karışıklığıdır; bu yüzden ikisini baştan ayrı düşünün.
OpenAI API için hangi programlama dilini kullanmalıyım?
OpenAI, Python ve JavaScript için resmi SDK sunar ve hızlı başlangıç örneklerini bu dillerle verir. Ancak API HTTP tabanlı olduğu için PHP, Go ya da Java gibi herhangi bir dilden istek gönderebilirsiniz. Ekibinizin zaten kullandığı sunucu dilini seçmek, bakım açısından genellikle en doğru karardır; yeni bir dil öğrenmeye gerek kalmaz.
API anahtarımı tarayıcı tarafında kullanabilir miyim?
Kullanmamalısınız. Tarayıcıda çalışan koddaki anahtar, sayfa kaynağını inceleyen herkes tarafından görülebilir ve hesabınız adına istek atılabilir. Doğru yöntem, isteği kendi sunucunuzdan göndermek ve tarayıcıya yalnız sonucu iletmektir. Anahtarı sunucuda ortam değişkeninde saklayın ve sızıntı şüphesinde vakit kaybetmeden iptal edip yenisini oluşturun.
OpenAI gönderdiğim verilerle modelini eğitiyor mu?
OpenAI, kurumsal gizlilik sayfasında API üzerinden gönderilen verileri varsayılan olarak model eğitimi için kullanmadığını belirtiyor. Ancak kötüye kullanım izleme amacıyla sınırlı süre saklama olabilir. Kişisel veri gönderiyorsanız KVKK ve GDPR kapsamındaki aydınlatma ve aktarım yükümlülüklerinizi ayrıca değerlendirmeniz gerekir. Gereksiz kişisel veriyi hiç göndermemek en güvenli yoldur.
429 hatası alıyorum, ne yapmalıyım?
429, hız sınırını ya da kotanızı aştığınızı gösterir. Önce hesabınızda bakiye olup olmadığını kontrol edin. Bakiye varsa istekleri üstel geri çekilme ile, yani giderek artan bekleme süreleriyle yeniden deneyin. Sorun sürüyorsa kullanım seviyenizin limitlerini inceleyin ve uygulamanızda kullanıcı başına istek sınırı tanımlayın.
  • OpenAI API
  • Responses API
  • API Anahtarı
  • Yapay Zeka Entegrasyonu
  • Python
  • JavaScript
  • GPT
Paylaş:
Talha Aslan

Google Partner dijital pazarlama uzmanı. 2012’den beri SEO, Google Ads, web tasarım ve e-ticaret projelerinde sahada; bu blogda gördüğünüz her yazı o deneyimden çıkar.

Sıradaki proje

Projenizi konuşalım.

Talebiniz doğrudan Talha Aslan ve ekibine ulaşır: stratejiyi Talha kurar, uygulamayı deneyimli ekip yürütür. İlk istişare ücretsizdir; hedefinizi dinler, net bir yol haritasıyla döneriz.