By HOLOGRAM AI
NASIL ALINIR
Rehber · 5 dakikada kurulum · Test komutu dahil

OpenAI API Key nasıl alınır?

Bu rehberde OpenAI API anahtarını (API key) sıfırdan alacağız ve tek komutla test edeceğiz. En kritik nokta: API key bir şifredir. Paylaşma, repoya koyma, ekrana açık bırakma.

Kısa cevap
Özet
  • OpenAI hesabı aç / giriş yap.
  • Faturalama (billing) tarafını aktif et (API key kullanım için gerekir).
  • API Keys sayfasından yeni key üret.
  • Key’i bir kez kopyala ve güvenli yere kaydet (sonradan tam hali görünmez).
  • Terminalde tek komutla test et (aşağıda var).
API key’i asla WhatsApp/DM ile paylaşma, ekran görüntüsü alma, GitHub’a koyma. Sızdıysa hemen iptal et ve yenisini üret.

Adım adım

Hedef: Key al → Test et
1

OpenAI hesabına giriş yap

Tarayıcıdan OpenAI hesabına giriş yap. Daha önce hesabın yoksa kayıt ol.

İpucu: Tek hesapla hem ChatGPT hem de API tarafını yönetebilirsin.
2

Billing (faturalama) aktif mi kontrol et

API kullanımı için faturalama tarafının aktif olması gerekebilir. Ödeme yöntemi ekleyip hesabı hazır hale getir.

Not: Bazı hesaplarda API erişimi, bölge/hesap doğrulama adımlarına takılabilir. Panelde uyarı görürsen oradaki adımı tamamla.
3

API Keys sayfasına git

Geliştirici panelinde “API Keys” bölümünü aç. Burada mevcut key’leri görürsün.

İpucu: Aynı projeye birden fazla key üretmek mümkündür (ekip/servis ayrımı için).
4

Yeni API key oluştur

“Create new secret key” gibi bir butonla yeni key üret. Açıklama/etiket varsa anlamlı bir isim ver (örn: “nasil-alinir-site-test”).

Key yalnızca 1 kez tam haliyle gösterilir. Kopyalayıp güvenli yere kaydet.
5

Key’i environment variable olarak kaydet (önerilen)

Key’i kodun içine yazmak yerine işletim sistemine environment variable olarak ekle.

# macOS / Linux
export OPENAI_API_KEY="BURAYA_KEY"

# Windows PowerShell
setx OPENAI_API_KEY "BURAYA_KEY"
Bu sayede key’i yanlışlıkla GitHub’a atma riskin çok azalır.
6

Tek komutla test et

Aşağıdaki komut, basit bir istek atarak key’in çalıştığını doğrular.

curl https://api.openai.com/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY"
Çıktıda model listesi ya da JSON response görürsen tamamdır. “401/invalid” görürsen key yanlış/kısıtlı/iptal edilmiş olabilir.
7

Güvenlik: key’i kısıtla ve izle

Mümkünse kullanım limitleri/rotasyon planı uygula. Ekipte paylaşıyorsan kişi/servis bazlı ayrı key kullan.

En iyi pratik: düzenli aralıkla key yenile (rotate) ve kullanılmayanları iptal et.

Akış şeması

1 sayfada özet
Hesap / Giriş Billing aktif API Keys → Yeni Key Env var’a kaydet OPENAI_API_KEY cURL ile test
Eğer testte 401 görürsen: key yanlış / iptal / billing kapalı / erişim kısıtı olabilir.

Görseller

Ekran görüntüsü alanı
Buraya 1–2 ekran görüntüsü koyacağız (ör: “API Keys sayfası”, “Create key modal”).
Önerilen format: WEBP (assets/img/...)

Sık sorulanlar

FAQ
OpenAI API key ile ChatGPT şifresi aynı şey mi?

Hayır. API key ayrı bir geliştirici anahtarıdır ve “şifre” gibi korunmalıdır. ChatGPT hesabınla giriş yapsan bile API key’i ayrıca oluşturursun.

API key’i sonradan tekrar görebilir miyim?

Genelde hayır. Key yalnızca oluştururken tam haliyle gösterilir. Kaybettiysen iptal edip yeni key üretmek en temiz yoldur.

“401 Unauthorized” hatası alıyorum, ne demek?

Çoğunlukla key yanlış/eksik, iptal edilmiş ya da billing/erişim kısıtı vardır. Önce key’i doğru taşıdığını kontrol et, sonra panelde key’in aktif olduğundan emin ol.