Adım adım resmi rehber · 2026

Kendi Gemini API Anahtarınızı Sıfırdan Alma Rehberi

UPGUN AI yapay zekâ asistanınızı kendi Google Gemini anahtarınızla çalıştırmak için anahtar oluşturma, kredi kartı ekleme ve faturalandırmayı doğru kurmanın tüm adımlarını birlikte yapacağız.

Google AI Studio'yu Aç Adımlara Geç

5 Dakikada Özet

Gemini API almak için gerekli adımlar.

1. Anahtar oluştur

AI Studio → Create API key. Ücretsiz tier'da hemen çalışır.

2. Kartı ekle

Set up billing → Cloud Billing hesabı. Böylece Tier 1'e geçersiniz.

3. Kredi + limit

Min $10 kredi yükle, otomatik-yükleme aç, aylık limit koy.

4. UPGUN'a yapıştır

Panel → Ayarlar → Yapay Zekâ → Gemini API Key.

Başlamadan Önce Bilmeniz Gerekenler

Yapın

Kartı ekleyip en azından Tier 1'e geçin — hem hız limiti açılır hem verileriniz gizli kalır.
Anahtarınızı gizli tutun; kimseyle paylaşmayın, ekran görüntüsünde göstermeyin.
Aylık harcama limiti (spend cap) koyun — sürpriz fatura olmaz.
Otomatik yükleme (auto-reload) açın — bakiye bitince servis durmasın.
Anahtarı oluşturduğunuz Google hesabını güvende tutun — 2 adımlı doğrulamayı açın.

Yapmayın

Anahtarı herkese açık bir yere (web sitesi, GitHub, sosyal medya) koymayın.
Ücretsiz tier'da yoğun/hassas müşteri verisi işlemeyin — gizlilik ve limit nedeniyle.
Bakiyenizi $0'da bırakmayın — sıfırlanınca TÜM anahtarlarınız aynı anda durur.
Tek anahtarı çok sayıda farklı sistemde paylaşmayın; karışır ve riskli olur.
Kredinin 12 ay sonra sona erdiğini unutmayın (kullanılmayan bakiye iade edilmez).

Adım Adım Kurulum

Her adımı sırayla takip edin; 10–15 dakika sürer.

Google AI Studio'ya giriş yapın

Bir Google hesabıyla aistudio.google.com adresine gidin. Şirket için ayrı, sade bir Google hesabı kullanmanızı öneririz (kişisel hesabınızla karışmasın).

İpucu

AI Studio ücretsizdir; sadece API kullanımının ücreti vardır — o da kartı ekleyip kullandığınız kadarına göredir.

API anahtarını oluşturun

Sol menüden “API Keys” sayfasına gidin ve sağ üstteki “Create API key” butonuna basın. Bir proje seçin ya da yeni proje oluşturun. Anahtarınız anında üretilir.

Oluşan uzun anahtarı (örn. AIza… ile başlar) kopyalayın ve güvenli bir yere kaydedin.

Anahtarınız bir şifre gibidir

Bu anahtarla yapılan tüm kullanım sizin hesabınıza faturalanır. Kimseyle paylaşmayın; sızdıysa AI Studio'dan silip yenisini oluşturun.

Ücretsiz (Free) tier ile deneyin

Anahtarınız kart eklemeden de çalışır — buna Ücretsiz Tier denir. Test etmek ve düşük hacimde başlamak için yeterlidir. Ancak iki önemli kısıtı vardır:

Düşük hız limiti: Yoğun mesaj trafiğinde “limit aşıldı” hataları alırsınız.
Gizlilik: Ücretsiz tier'da gönderdiğiniz veriler Google'ın ürünlerini geliştirmek için kullanılabilir.

Öneri

Gerçek müşteri yazışmaları için bir sonraki adımda kartı ekleyip Tier 1'e geçin. Hem limit açılır hem verileriniz gizli kalır.

Faturalandırmayı açın (kredi kartı ekleyin)

API Keys ya da Projects sayfasında projenizin yanındaki “Set up billing” bağlantısına tıklayın. Açılan ekranda:

Bir Cloud Billing (faturalandırma) hesabı seçin veya yeni oluşturun.
Ülke, iletişim bilgisi ve kredi kartı bilgilerini girin.
Ödeme modelini seçin: çoğu kullanıcı için Prepay (ön ödeme).

Kart başarıyla bağlandığında hesabınız otomatik olarak Tier 1'e geçer. Bu genellikle anında etkinleşir.

Prepay nedir?

Önceden bir miktar kredi yüklersiniz (en az $10, işlem başına en fazla $5.000). Kullandıkça bu bakiyeden gerçek zamanlıya yakın düşülür. Postpay (sonradan fatura) seçeneği yalnızca Tier 3'te açılır.

Kredi yükleyin + otomatik yükleme + limit

Servisin hiç durmaması ve maliyetin kontrolde kalması için üç ayarı birlikte yapın:

Başlangıç kredisi: Min. $10 yükleyin (mesajlaşma için uzun süre yeter).
Otomatik yükleme (auto-reload): Bakiye belli seviyenin altına inince otomatik tamamlansın — böylece servis kesilmez.
Aylık otomatik-çekim limiti: “Ayda en fazla şu kadar çekilsin” diyerek sürpriz maliyeti önleyin.

Çok önemli

Prepay bakiyeniz $0'a düşerse, o hesaptaki tüm projelerdeki tüm API anahtarları aynı anda çalışmayı durdurur. Otomatik yüklemeyi mutlaka açın.

Aylık harcama tavanı (spend cap) koyun

AI Studio'da Spend sayfasından projeniz için aylık bir harcama tavanı belirleyebilirsiniz. Bu, beklenmedik yüksek kullanımda fren görevi görür. (Proje sahibi/editör yetkisi gerekir.)

Önerilen başlangıç

Tek bir işletmenin WhatsApp/Instagram yazışmaları için aylık küçük bir tavan (ör. birkaç dolar) genelde fazlasıyla yeterlidir. Kullanımı görüp artırabilirsiniz.

Harcamanızı takip edin

İki yerden izleyebilirsiniz:

AI Studio → Usage / Spend: Günlük ve aylık kullanım, model bazında maliyet.
Cloud Billing konsolu: Resmî fatura kaydı (24 saate kadar gecikmeli güncellenir).

Anahtarı UPGUN AI paneline ekleyin

Son adım: İşletme panelinizde Ayarlar → Yapay Zekâ Asistanı bölümündeki Gemini API Key alanına anahtarınızı yapıştırıp kaydedin. Asistanınız artık kendi anahtarınızla çalışır.

Hazırsınız 🎉

Bir test mesajı gönderip asistanın yanıt verdiğini doğrulayın. Sorun olursa anahtarın doğru kopyalandığını ve faturalandırmanın açık olduğunu kontrol edin.

Kademeler (Tier) Nasıl Çalışır?

Harcadıkça ve zaman geçtikçe hesabınız otomatik olarak üst kademeye çıkar. Üst kademe = daha yüksek hız limiti.

Bu rakamlar aylık ücret DEĞİLDİR 👇

Aşağıdaki tutarlar, her kademede “en fazla ne kadar harcayabileceğinizi” gösteren bir güvenlik üst sınırıdır — ödeyeceğiniz sabit bir bedel değildir. Gerçekte yalnızca kullandığınız kadar ödersiniz ve çoğu işletme ayda sadece birkaç dolar harcar. Dilerseniz kendiniz çok daha düşük bir aylık tavan da koyabilirsiniz.

Ücretsiz (Free)

Nasıl geçilir

Sadece API anahtarı oluştur — kart gerekmez

Aylık harcama tavanı

Ödeme yok

kart eklemezsiniz

Hız limitiEn düşük

Veri gizliliği Açık

Test ve düşük hacim için. Verileriniz Google ürünlerini geliştirmek için kullanılabilir.

ÖNERİLEN BAŞLANGIÇ

Tier 1

Nasıl geçilir

Faturalandırma hesabı bağla (kredi kartı ekle)

Aylık harcama tavanı

en fazla $250 / ay

ücret değil — üst sınır

Hız limitiOrta

Veri gizliliği Gizli

Kartı ekler eklemez geçilir. Verileriniz artık eğitimde KULLANILMAZ. Çoğu işletme için doğru başlangıç.

Tier 2

Nasıl geçilir

Toplam $100 harca + ilk ödemeden 3 gün geç

Aylık harcama tavanı

en fazla $2.000 / ay

ücret değil — üst sınır

Hız limitiYüksek

Veri gizliliği Gizli

Otomatik yükselir. Yüksek hız limiti, yoğun kullanım için.

Tier 3

Nasıl geçilir

Toplam $1.000 harca + 30 gün geç

Aylık harcama tavanı

en fazla $20.000+ / ay

ücret değil — üst sınır

Hız limitiEn yüksek

Veri gizliliği Gizli

En yüksek limitler + Postpay (sonradan ödeme) seçeneği bu kademede açılır.

Kademe geçişleri otomatiktir

Ücretsiz → Tier 1 genelde anında olur. Tier 2 ($100 + 3 gün) ve Tier 3 ($1.000 + 30 gün) koşulları sağlandığında ~10 dakika içinde otomatik yükselir. Ayrıca her kademede 10 dakikalık harcama-bazlı bir sınır da vardır (Tier 1: $10/10dk, Tier 2-3: $200/10dk).

Maliyet Ne Kadar Olur?

Sadece kullandığınız kadar ödersiniz — token (kelime parçası) başına. UPGUN AI işlemleri arka planda ekonomik modellerle çalıştığı için maliyet çok düşüktür.

Çok düşük birim fiyat

Sistemin kullandığı ekonomik modeller sayesinde 1 milyon token (yaklaşık 750 bin kelime) işlem birkaç sente gelir.

Kullanıma göre

Sabit ücret yok. Az mesaj = az maliyet. Çoğu küçük işletme ayda birkaç dolarda kalır.

Kontrol sizde

Aylık tavan + otomatik-yükleme limiti ile harcamayı tamamen siz belirlersiniz.

Güncel ve modele özel fiyatlar için: Google resmî fiyatlandırma sayfası

Sık Sorulan Sorular

Ücretsiz tier yeterli mi?

Test ve çok düşük hacim için evet. Ancak gerçek müşteri yazışmalarında düşük hız limiti ve veri gizliliği nedeniyle kartı ekleyip Tier 1'e geçmenizi öneririz.

Tier 1'de ayda $250 ödemek zorunda mıyım?

Hayır. $250 yalnızca o kademede izin verilen en yüksek harcama tavanıdır — sabit bir ücret değildir. Sadece gerçekten kullandığınız kadar ödersiniz ve çoğu işletme ayda birkaç dolarda kalır. İsterseniz kendiniz çok daha düşük bir aylık tavan da koyabilirsiniz.

Kartı ekleyince hemen para çekilir mi?

Prepay modelinde önceden yüklediğiniz krediden kullandıkça düşülür. Otomatik yükleme ve aylık limit ayarlarını siz belirlersiniz; kontrol tamamen sizdedir.

Tier 2'ye nasıl çıkarım?

Toplam $100 harcama yapıp ilk başarılı ödemenizden 3 gün geçtiğinde hesabınız otomatik olarak Tier 2'ye yükselir. Ayrıca bir şey yapmanıza gerek yoktur.

Anahtarımı UPGUN AI nasıl kullanıyor?

Anahtarınız yalnızca sizin işletmenizin asistanı için kullanılır, güvenli biçimde saklanır ve dilediğiniz zaman panelden değiştirebilir veya kaldırabilirsiniz.

Bakiyem biterse ne olur?

Prepay bakiyesi $0'a düşerse o hesaptaki tüm anahtarlar çalışmayı durdurur. Bunu önlemek için otomatik yüklemeyi açık tutun.

'Rate limit / limit aşıldı' hatası alıyorum?

Hız limitine takılıyorsunuz demektir. Kartı ekleyip üst kademeye geçtikçe limitler yükselir. AI Studio'daki Rate Limit sayfasından mevcut limitlerinizi görebilirsiniz.

Takıldığınız bir yer mi var?

Anahtar oluşturma veya faturalandırma adımlarında yardıma ihtiyacınız olursa ekibimiz size adım adım eşlik eder.

AI Studio'yu Aç Destek Al