OpenAI API'yi Uygulamanıza Nasıl Entegre Edersiniz

OpenAI API'yi entegre etmek için bir OpenAI projesinde bir API anahtarı oluşturun, bunu OPENAI_API_KEY adında bir sunucu tarafı gizli değer olarak saklayın ve API'yi asla tarayıcı kodundan değil, kendi sunucunuzdaki bir rotadan, OpenAI'ın resmi SDK'sını kullanarak çağırın. Eylül 2026 itibarıyla OpenAI'ın hızlı başlangıç rehberi, yeni projeler için başlangıç noktası olarak Responses API'yi sunar. Yayına almadan önce bir harcama limiti belirleyin, yanıt uzunluğunu sınırlayın, her kullanıcının özelliği ne sıklıkla çağırabileceğini kısıtlayın ve hız sınırı hatalarını yeniden denemelerle yönetin.

Bu rehber kurulumu, istek akışını, bir AI oluşturucu için istemleri ve anahtarları sızdıran ya da para yakan hataları kapsar. OpenAI ayrıntıları, Eylül 2026 itibarıyla resmi dokümantasyonundan alınmıştır. Genel kavramlar (token'lar, bağlam pencereleri, fiyatlandırma) için önce LLM API'leri nasıl kullanılır bölümünü okuyun.

Bununla neler yapabilirsiniz?

• Uygulamanızın içinde bir sohbet asistanı (AI sohbet robotu uygulaması nasıl yapılır)
• "Özetle", "yeniden yaz" veya "taslak yanıt hazırla" düğmeleri
• Serbest metinden yapılandırılmış veri çıkarma: bir e-postayı siparişe dönüştürme, destek taleplerini etiketleme
• Kendi içeriğiniz üzerinde arama ve soru yanıtlama
• Kullanılabilir modellere bağlı olarak görsel üretimi, ses ve diğer medya özellikleri

Daha fazla fikir için uygulamanıza AI özellikleri nasıl eklenir bölümüne bakın.

OpenAI hesabınızı kurmak

1. OpenAI platformunda bir hesap ve bir proje oluşturun. OpenAI'ın üretim en iyi uygulamaları, hazırlık ve üretim için ayrı projeler önerir; böylece her biri kendi anahtarlarına ve limitlerine sahip olabilir.
2. Bir proje API anahtarı oluşturun. OpenAI, bir son kullanma tarihi belirlemenizi ve anahtarları düzenli olarak yenilemenizi önerir.
3. Limitler sayfasında harcama uyarıları ve katı bir harcama limiti belirleyin. OpenAI'ın rehberi, kullanım bir tutarı geçtiğinde uyarıların sizi bilgilendirdiğini ve katı bir limitin aylık bir üst sınırı uyguladığını belirtir.
4. Faturalandırma ekleyin. OpenAI'ın hız sınırı dokümanları kullanım kademelerini açıklar: zamanla daha fazla harcadıkça limitleriniz otomatik olarak artar.

İstek akışı

Tarayıcı  ->  sunucu rotanız  ->  OpenAI API
          <-  (akan) yanıt   <-

1. Kullanıcı bir düğmeye tıklar veya bir mesaj gönderir.
2. Tarayıcı sizin rotanızı çağırır, örneğin POST /api/summarise.
3. Sunucunuz kullanıcının giriş yapmış olduğunu ve bu özelliği kullanmaya yetkili olduğunu kontrol eder.
4. Sunucu isteği oluşturur: talimatlar, kullanıcının girdisi ve görevin ihtiyaç duyduğu veritabanı verileri.
5. Ortamdaki anahtarla OpenAI'ı çağırır. OpenAI'ın SDK'ları OPENAI_API_KEY değerini otomatik olarak okur.
6. Yanıtı akıtır veya döndürür ve token kullanımını kaydeder.

OpenAI'ın resmi SDK paketleri hem JavaScript/TypeScript (npm) hem de Python (pip) için openai adını taşır.

Model seçimi

OpenAI, farklı fiyat ve hızlarda birkaç model sunar ve bu seçenekler sık değişir. Daha küçük ve daha ucuz bir modelle başlayın, kaliteyi gerçek örneklerde ölçün ve yalnızca gerekirse daha üst bir modele geçin. Model adını bir yapılandırma değerinde ya da gizli değerde tutun; böylece kodu yeniden yazmadan değiştirebilirsiniz. Güncel oranlar için OpenAI'ın fiyatlandırma sayfasını kontrol edin.

Seçenekler ve ödünleşimler

AI oluşturucunuza verilecek istemler

İlk bir özellik:

Bilet sayfasına bir "Özetle" düğmesi ekle. Kullanıcının giriş yapmış olduğunu kontrol eden, bileti yükleyen ve resmi openai SDK'sı ile OPENAI_API_KEY gizli değerini kullanarak OpenAI Responses API'sini çağıran bir sunucu rotası POST /api/summarise çağırsın. Model adını OPENAI_MODEL gizli değerinden okusun. Talimatlar: "3 madde işaretiyle özetle, ardından kısa bir yanıt öner. Sipariş numaraları uydurma." Çıktı uzunluğunu sınırla, yanıtı sayfaya akıt ve anahtarı asla tarayıcıya gönderme.

Korumalar:

Her kullanıcıyı saatte 30 AI isteğiyle sınırla; bu veritabanında saklansın. Her istekten giriş ve çıkış token'larını kullanıcı kimliği ve özellik adıyla kaydet. OpenAI 429 döndürürse Retry-After başlığına uy, üstel geri çekilme ve jitter ile en fazla 3 kez yeniden dene; bundan sonra "Yapay zeka meşgul, lütfen bir dakika sonra tekrar deneyin." göster. Diğer tüm hatalarda kullanıcı dostu bir hata göster ve sayfanın geri kalanının çalışmaya devam etmesini sağla.

Hataları ve limitleri yönetmek

OpenAI hız sınırlarını birkaç şekilde ölçer; dakikadaki istek sayısı ve dakikadaki token sayısı dahil, ve hangisi önce tükenirse ona takılırsınız. Birini aşarsanız API, bir Retry-After başlığı ile birlikte bir 429 döndürür. OpenAI'ın dokümanları bu değeri bir minimum olarak kabul etmenizi ve istemcilerin hepsinin aynı anda yeniden denemesini önlemek için küçük bir rastgele gecikme eklemenizi önerir.

Ayrıca şunlara da hazırlıklı olun:

• Uzun üretimlerde zaman aşımları. Akış yardımcı olur, makul bir çıktı üst sınırı da öyle.
• Sağlayıcı kesintileri. AI özelliği, sayfayı bozmadan zarifçe başarısız olmalıdır.
• Kötü çıktı. Yapılandırılmış çıktıyı kaydetmeden önce doğrulayın ve model çıktısının kodunuzda bir kontrol olmadan hassas eylemleri tetiklemesine izin vermeyin.

Sık yapılan hatalar

• Anahtarın ön yüzde ya da depoda olması. Tarayıcı kodu herkese açıktır ve sızan bir anahtar dakikalar içinde kötüye kullanılabilir. Bkz. API anahtarlarını güvende tutma.
• Harcama limitinin olmaması. Bir döngü ya da kötüye kullanan bir kullanıcı hızla büyük bir fatura çıkarabilir.
• Kullanıcı başına limitlerin olmaması. Sağlayıcı limitiniz cüzdanınızı korur, diğer kullanıcılarınızı değil.
• Güvenlik için isteme güvenmek. Kullanıcılar "önceki talimatları yok say" yazabilir. İzinler sunucu kodunda olmalıdır.
• Gerekenden fazlasını göndermek. Tüm belgeler ve uzun geçmişler maliyeti katlar. Görevin ihtiyaç duyduğunu gönderin.
• Model adını koda yazmak. Modeller güncellenir ve emekli edilir; bunu bir ayar yapın.
• Kişisel verileri düşünmeden göndermek. OpenAI'ın veri kullanım koşullarını okuyun ve yalnızca özelliğin ihtiyaç duyduğunu gönderin.

Kontrol listesi

• Test ve üretim için ayrı OpenAI projeleri (veya anahtarlar)
• Anahtar sunucu tarafı gizli değer olarak saklanıyor; tarayıcı kodunda ya da depoda asla değil
• Harcama uyarıları ve katı bir harcama limiti ayarlandı
• Tüm çağrılar sunucunuz üzerinden gidiyor ve kullanıcının izinlerini kontrol ediyor
• Çıktı uzunluğu sınırlı; model adı yapılandırılabilir
• Uygulamanızda kullanıcı başına hız sınırı var
• 429, Retry-After, geri çekilme ve jitter ile işleniyor
• Kullanıcı dostu bir hata durumu var; sayfa AI olmadan da çalışıyor
• Token kullanımı özellik başına kaydediliyor
• Uzun, boş ve kötü niyetli girdilerle test edildi

Mythex'te OpenAI API kullanımı

Mythex üzerinde oluşturduğunuz uygulamalardaki AI özellikleri, Mythex oluşturma kredileri yerine OpenAI hesabınıza faturalandırılan kendi OpenAI anahtarınızı kullanır. OPENAI_API_KEY değerini /secrets, proje ayarları veya agent'ın bir anahtara ihtiyaç duyduğunda gösterdiği gizli değerler kartı üzerinden bir proje gizli değeri olarak ekleyin, ardından özelliği yukarıdakilere benzer bir istemle tarif edin. Yayınlanmış bir uygulamada gizli değerleri değiştirdikten sonra, bunları alabilmesi için yeniden yayınlayın. Dokümanlardaki Kendi API anahtarlarınızla AI özellikleri ekleyin tarifi bir başlangıç istemi içerir ve Sohbette gizli değerler gizli değerler kartını açıklar. Sağlayıcıları karşılaştırıyor musunuz? Claude API nasıl entegre edilir bölümüne bakın.

Sorular