ChatBot Ajanı İçin OpenAI API Anahtarı Alma

ChatBot ajanınızın yapay zeka yanıtları üretebilmesi için kendi OpenAI hesabınızdan alınmış bir API anahtarına ihtiyacınız vardır. OpenAI ücretlendirmesi doğrudan kendi hesabınız üzerinden yürür; BulutPress aracı olmaz, fatura sizin OpenAI hesabınıza düşer.
Bu rehber sıfırdan başlayıp panele yapıştırabileceğiniz sk-... ile başlayan bir API anahtarı edinmeniz için gereken tüm adımları anlatır. Ortalama tamamlanma süresi 5-10 dakikadır.
Not: OpenAI panel arayüzü zaman zaman güncellenebilir; menü adları değişirse "API Keys" benzeri kelimeleri arayarak ilerleyebilirsiniz.
1. OpenAI Hesabı Açın
- Tarayıcınızdan https://platform.openai.com/signup adresine gidin.
- E-posta + şifre ile veya Google / Microsoft / Apple hesabınızla kayıt olun.
- Doğrulama e-postasını onaylayın.
- Sizden bir telefon numarası doğrulaması istenir — SMS ile gelen kodu girin. (Aynı telefon numarası birden fazla OpenAI hesabında kullanılamaz.)
- Hesap oluşturma adımında bir organizasyon adı belirleyin (örn. firmanızın adı).
Zaten hesabınız varsa https://platform.openai.com/login üzerinden giriş yapın.
2. Ödeme Yöntemi Tanımlayın
OpenAI'ın API hizmeti kullanım başına ücretlendirilir; ödeme yöntemi tanımlanmadan oluşturulan API anahtarları çalışmaz. (ChatGPT Plus aboneliği API kullanımını kapsamaz; ayrı bir ücretlendirmedir.)
- Sol alttaki avatar simgesine tıklayın → Settings seçeneğini açın.
- Sol menüden Billing sekmesine geçin.
- Payment methods altından Add payment method düğmesine basın.
- Kredi kartı bilgilerinizi ve fatura adresinizi girin.
- Add to credit balance düğmesi ile hesabınıza ön ödeme yükleyin (minimum 5 USD). Yüklediğiniz tutar bittikçe API çağrıları reddedilir, otomatik kesinti olmaz.
İpucu: Aynı sayfadaki Usage limits alanından aylık harcama tavanı belirleyebilirsiniz — beklenmedik faturalardan korunmak için 10-20 USD gibi düşük bir tavanla başlamanız tavsiye edilir.
3. API Anahtarı Oluşturun
- Sol menüden API keys sekmesine geçin (doğrudan adres: https://platform.openai.com/api-keys).
- Sağ üstteki Create new secret key düğmesine basın.
- Açılan pencerede:
- Name alanına ayırt edici bir ad girin (örn.
BulutPress ChatBot - Site Adı). Birden fazla anahtarınız olduğunda hangisinin nerede kullanıldığını ayırt etmenize yardımcı olur. - Project alanı için varsayılan projeyi (Default project) bırakabilirsiniz.
- Permissions alanını All olarak bırakın (embeddings + chat completions izinleri gereklidir).
- Name alanına ayırt edici bir ad girin (örn.
- Create secret key düğmesine basın.
- Açılan ekranda
sk-...ile başlayan anahtarı hemen kopyalayın ve güvenli bir yerde saklayın.
⚠️ Çok Önemli: Anahtar yalnızca bu ekranda bir kez gösterilir. Pencereyi kapatırsanız bir daha göremezsiniz; yeni anahtar oluşturmak zorunda kalırsınız.
4. (İsteğe Bağlı) Organizasyon ID'si
Birden fazla OpenAI organizasyonunuz varsa BulutPress paneline organizasyon ID'sini de tanımlayabilirsiniz. Tek organizasyonunuz varsa bu alanı boş bırakın.
- Sol alttaki avatar → Settings → Organization sekmesine girin.
- Organization ID satırındaki
org-...ile başlayan değeri kopyalayın.
5. Modelin Erişilebilirliğini Kontrol Edin
ChatBot ajanınız soru-cevap üretimi için seçtiğiniz modeli kullanır. BulutPress paneli API anahtarınıza tanımlı modelleri otomatik listeler; aşağıdaki modellerden en az birinin erişilebilir olması gerekir:
gpt-5veyagpt-5-mini— günümüzde önerilen, en iyi sonuçları verirgpt-4oveyagpt-4o-mini— uygun maliyet/kalite dengesigpt-4-turbo,gpt-3.5-turbo— daha eski ama çalışır
Yeni hesaplarda bazı modellere erişim için harcama eşiği geçilmesi gerekebilir (örn. ödeme geçmişinde 5 USD birikmesi). Listelenen herhangi bir model işinizi görür; çoğu kullanıcı için gpt-4o-mini veya gpt-5-mini uygun maliyetli başlangıçtır.
Not: Embedding modeli (
text-embedding-3-small) BulutPress ChatBot tarafından sabit kullanılır; bu modeli ayrıca seçmeniz gerekmez ama OpenAI hesabınızda erişilebilir olmak zorundadır (yeni hesaplarda otomatik açıktır).
6. BulutPress Panelinde Tanımlayın
- ChatBot ajanınızın Ayarlar sayfasına girin.
- OpenAI API Anahtarı alanına
sk-...ile başlayan anahtarı yapıştırın. - (Varsa) OpenAI Organizasyon ID alanına
org-...değerini yapıştırın. - OpenAI Model alanından kullanmak istediğiniz modeli seçin (boş bırakırsanız varsayılan model uygulanır).
- Kaydet düğmesine basın.
Anahtarınız panel tarafından doğrulanır; geçersizse veya kotanız yoksa form üzerinde hata olarak gösterilir.
Maliyet Tahmini
OpenAI ücretlendirmesi tüketim bazlıdır; 2026 başı itibarıyla yaygın modellerin kabaca aylık maliyeti şu ölçeklerde gerçekleşir:
- Düşük trafik (~ayda 1.000 mesaj, gpt-4o-mini): 1-3 USD
- Orta trafik (~ayda 10.000 mesaj, gpt-4o-mini): 10-30 USD
- Yüksek trafik veya gpt-5/gpt-4o modelleri ile: yukarıdaki rakamların 5-10 katı
Güncel fiyatlar için https://openai.com/api/pricing adresine bakabilirsiniz.
Sorun Giderme
- "Invalid API key" hatası — Anahtarı baştan kopyalamayı, başında veya sonunda boşluk bırakmamayı kontrol edin. Hâlâ olmuyorsa OpenAI panelden anahtarı silip yenisini oluşturun.
- "You exceeded your current quota" hatası — Hesabınıza kredi yüklemeniz veya harcama tavanını yükseltmeniz gerekir (Settings → Billing).
- Model listesi BulutPress panelinde boş geliyor — Anahtarınızda hiç model erişimi yoktur. OpenAI panelinden ödeme tanımlayın, gerekiyorsa hesabınıza biraz bakiye yükleyin; modeller birkaç dakika içinde aktifleşir.
Tüm adımlar tamamlandıktan sonra ChatBot ajanınız OpenAI üzerinden yanıt üretmeye hazırdır. Bilgi bankası senkronizasyonu için ayrıca Pinecone hesabınızı yapılandırmanız gerekir — bunun için sağ menüdeki Pinecone Index Oluşturma rehberine bakabilirsiniz.