Gemini entegrasyonu: model, fiyat, veri gizliliği ve panel kurulumu
Gemini entegrasyonu, Google'ın Gemini modellerini Google AI Studio'da oluşturduğunuz API anahtarıyla Yox İş Ortağım paneline bağlayıp ürün başlığı, açıklama, kategori önerisi ve satış analizlerini kendi Google hesabınızdaki modelle çalıştırmaktır. Bu rehberde Ekim 2026 itibarıyla güncel model ailesini, Google'ın resmî fiyat sayfasındaki token ücretlerini, 1.000 ürünlük örnek maliyet hesabını ve en sık gözden kaçan konuyu, yani ücretsiz katmanla ücretli katman arasındaki veri kullanımı farkını Google'ın kendi koşullarına dayanarak anlatıyoruz.
Gemini entegrasyonu nedir, pazaryeri satıcısına hangi işlerde yarar?
Google Gemini, Google'ın metin, görsel, ses, video ve PDF belgelerini girdi olarak işleyebilen yapay zekâ model ailesidir; geliştiricilere Gemini Developer API (kısaca Gemini API) ve Google AI Studio üzerinden sunulur. Satıcı açısından asıl fark, modelin bir sohbet penceresinde değil, ürün kartının ve sipariş verisinin bulunduğu panelde çalışmasıdır: bilgiyi kopyalayıp yapıştırmazsınız, sonucu da elle taşımazsınız.
Yox İş Ortağım'da Gemini modeli şu işlerde kullanılır:
- Pazaryeri kurallarına uygun ürün başlığı ve açıklama önerisi; öneri siz onaylamadan ilana yazılmaz.
- Bağlı satış kanallarınız için kategori eşleme önerisi ve reddedilen ilanlarda eksik zorunlu özellik (öznitelik) önerisi.
- Yurt dışı kanallar için ürün çevirisi; örneğin Amazon entegrasyonu ile Avrupa mağazalarına açılırken.
- Alış faturası PDF'inden ya da görselinden bilgi okuma.
- Hazır analiz görevleri: günlük işletme brifi, sipariş analizi, kâr ve ciro yorumu, stok risk raporu, katalog kalite analizi, fiyatlandırma analizi, rekabet stratejisi, iade kök-neden analizi, kargo analizi ve müşteri sorusuna yanıt taslağı.
Gemini'yi satıcı işlerinde öne çıkaran özellikler
Google, Flash-Lite modellerini yüksek hacimli işler, çeviri ve basit veri işleme için konumlandırıyor; bu tanım toplu başlık, açıklama ve çeviri işine doğrudan uyar. Belge anlama desteği sayesinde aynı model alış faturası PDF'ini de okur. Gemini API'nin ücretsiz bir katmanı var, ancak veri koşulları farklıdır (aşağıda anlatıyoruz). Aynı görevleri Anthropic'in Claude modelleriyle ya da ChatGPT ile de çalıştırabilirsiniz; sağlayıcı AI Yönetimi ekranından değiştirilir.
Ekim 2026 Gemini modelleri: hangi iş için hangi model?
Ekim 2026 itibarıyla Gemini API'deki güncel metin modelleri Gemini 3.8 Flash, 3.6 Flash, 3.5 Flash-Lite, 3.1 Flash-Lite ve önizleme durumundaki 3.1 Pro'dur; Google yeni projeler için 3.5 Flash-Lite ya da 3.8 Flash kullanılmasını öneriyor. Aşağıdaki tablo Google'ın model sayfasındaki tanımları satıcı işlerine çeviriyor.
| Model | API adı | Durum | Google'ın tanımı (özet) | Satıcı işinde uygun kullanım |
|---|---|---|---|---|
| Gemini 3.8 Flash | gemini-3.8-flash | Kararlı | Google'ın en yetenekli Flash modeli; uzun ve karmaşık iş akışları | Kâr ve ciro yorumu, fiyatlandırma ve rekabet analizi |
| Gemini 3.6 Flash | gemini-3.6-flash | Kararlı | Önceki nesil Flash; hız ve çok kipli denge | Genel işler; fiyatı 3.8 Flash ile aynı olduğu için 3.8 daha mantıklı |
| Gemini 3.5 Flash-Lite | gemini-3.5-flash-lite | Kararlı | 3.5 ailesinin en hızlı ve en düşük maliyetli modeli; çeviri ve basit veri işleme | Toplu başlık ve açıklama, çeviri, kategori önerisi |
| Gemini 3.1 Flash-Lite | gemini-3.1-flash-lite | Kararlı | Düşük maliyetli, yüksek hacimli işler | Bütçesi en sıkı toplu içerik işleri |
| Gemini 3.1 Pro | gemini-3.1-pro-preview | Önizleme | Karmaşık problem çözme ve çok kipli anlama | Zor analizler; ücretsiz katmanda kullanılamaz |
Düşünme (thinking) seviyesi maliyeti nasıl etkiler?
Gemini modelleri yanıttan önce "düşünür"; Google'ın belgesine göre varsayılan düşünme seviyesi 3.8 Flash'ta orta, 3.5 Flash-Lite'ta en düşük (minimal), 3.1 Pro'da yüksektir. Düşünme token'ları çıktı token'ı olarak faturalanır ve çıktı sınırı düşünme ile yanıtın toplamına uygulanır; sınır düşükse yanıt kesilebilir. 300 kelimelik bir ürün açıklaması için Pro seçmek bu yüzden pahalı ve gereksizdir.
Önizleme modeller ve 2.5 ailesi hakkında not
Önizleme modellerinde oran sınırları daha dardır. Gemini 2.5 ailesi kullanımdan kaldırılmadı, ancak erişim bu modelleri daha önce aktif kullanmış hesaplarla sınırlandı. Panel hesabınızın erişebildiği modelleri listeler; 2.5 modellerini görmüyorsanız neden Google'ın erişim kuralıdır.
Gemini API fiyatları: ücretsiz katman, ücretli katman ve Batch
Gemini API'nin ücretsiz katmanı token ücreti almaz; ücretli katman ise 1 milyon token başına ABD doları cinsinden girdi ve çıktı ücreti alır ve çıktı fiyatına düşünme token'ları da dahildir. Aşağıdaki rakamlar Google'ın 9 Ekim 2026'da güncellenen resmî fiyat sayfasındaki standart (anlık) fiyatlardır.
| Model | Ücretsiz katman | Girdi (1M token, USD) | Çıktı (1M token, USD) | Batch / Flex (girdi – çıktı) |
|---|---|---|---|---|
| Gemini 3.8 Flash | Var | 0,75 (31 Aralık 2026'ya kadar), 1,50 (1 Ocak 2027'den) | 3,75 (2026), 7,50 (2027'den) | 0,375 – 1,875 (2026) |
| Gemini 3.6 Flash | Var | 0,75 (2026), 1,50 (2027'den) | 3,75 (2026), 7,50 (2027'den) | 0,375 – 1,875 (2026) |
| Gemini 3.5 Flash-Lite | Var | 0,30 | 2,50 | 0,15 – 1,25 |
| Gemini 3.1 Flash-Lite | Var | 0,25 (metin, görsel, video) | 1,50 | 0,125 – 0,75 |
| Gemini 3.1 Pro (önizleme) | Yok | 2,00 (200 bin token'a kadar istem), 4,00 (üstü) | 12,00 (200 bin token'a kadar), 18,00 (üstü) | 1,00 – 6,00 (200 bin token'a kadar) |
Batch ve Flex neden yarı fiyatına?
Google, Batch API için yüzde 50 maliyet indirimi uygular; karşılığında istekler toplu iş olarak sıraya alınıp sonradan işlenir. Flex de benzer bir indirimli seçenektir. Yox İş Ortağım'daki yapay zekâ işlemleri anlık yanıt bekleyen standart isteklerdir; panel kullanımınızı standart sütunlarla hesaplayın.
1.000 ürün açıklaması Gemini ile kaç dolar tutar? Örnek hesap
1.000 ürün için başlık ve açıklama üretmek, aşağıdaki varsayımlarla Gemini 3.5 Flash-Lite'ta yaklaşık 1,74 dolar, Gemini 3.8 Flash'ta 2026 fiyatıyla yaklaşık 2,85 dolar tutar. Rakamlar bir örnektir; kendi ürün kartınızın uzunluğu ve talimatınız sonucu değiştirir.
- Google'a göre Gemini modellerinde 1 token ortalama 4 karaktere denk gelir. Bu genel bir ortalamadır; Türkçe metindeki gerçek sayıyı kullanım kaydı gösterir.
- Girdi: talimat ve ürün kartı alanları yaklaşık 3.200 karakter, yani ürün başına yaklaşık 800 token.
- Çıktı: başlık ve açıklama yaklaşık 1.600 karakter (400 token) ve buna eklenen yaklaşık 200 düşünme token'ı; ürün başına yaklaşık 600 token.
- 1.000 ürün: 800 bin girdi token'ı ve 600 bin çıktı token'ı; standart fiyat, kur ve vergi hariç.
| Model | Girdi maliyeti (800 bin token) | Çıktı maliyeti (600 bin token) | 1.000 ürün toplamı (örnek) |
|---|---|---|---|
| Gemini 3.1 Flash-Lite | 0,20 $ | 0,90 $ | yaklaşık 1,10 $ |
| Gemini 3.5 Flash-Lite | 0,24 $ | 1,50 $ | yaklaşık 1,74 $ |
| Gemini 3.8 Flash (2026 fiyatı) | 0,60 $ | 2,25 $ | yaklaşık 2,85 $ |
| Gemini 3.8 Flash (1 Ocak 2027'den) | 1,20 $ | 4,50 $ | yaklaşık 5,70 $ |
| Gemini 3.1 Pro (önizleme) | 1,60 $ | 7,20 $ | yaklaşık 8,80 $ ve üstü |
Hesabı kendi kataloğunuzla doğrulamak
Pro satırındaki "ve üstü" bilinçli: varsayılan düşünme seviyesi yüksek olduğu için çıktı varsayımımızı aşabilir. En güvenilir yöntem 10 üründe deneme yapıp gerçek token sayısını görmektir. AI Studio'da Dashboard altındaki Usage ekranı proje bazında kullanımı, panelde AI Yönetimi'ndeki kullanım kaydı kendi anahtarınızla yapılan harcamayı gösterir; ürün başına maliyeti katalog büyüklüğüyle çarpın.
Google AI Studio'da Gemini API anahtarı nasıl alınır?
Gemini API anahtarı Google AI Studio'nun (aistudio.google.com) API Keys sayfasında oluşturulur ve her anahtar bir Google Cloud projesine bağlıdır; yeni kullanıcılar için Google, şartları kabul ettiğinizde varsayılan bir proje ve anahtar oluşturur. Gemini API Ek Hizmet Şartları'na göre hizmeti kullanmak için 18 yaşını doldurmuş olmanız gerekir ve hizmet tüketici kullanımı için değil, profesyonel ya da ticari amaçlı geliştirme içindir.
- Şirketinizin kullandığı Google hesabıyla aistudio.google.com adresine girin ve Gemini API Ek Hizmet Şartları'nı okuyup kabul edin.
- Sol menüde Dashboard altındaki Projects ekranını açın. Mevcut bir Google Cloud projeniz varsa Import projects düğmesiyle içe aktarın; yoksa varsayılan projeyi kullanın.
- API Keys sayfasında Create API key ile anahtarı oluşturun. 28 Mayıs 2026'dan beri AI Studio'da açılan yeni anahtarlar, bir hizmet hesabına bağlı yetkilendirme anahtarı (authorization key) olarak oluşturulur.
- Projenin Billing Tier sütunundaki Set up billing bağlantısıyla faturalandırma hesabını bağlayın ve en az 5 dolarlık ön ödeme (Prepay) yapın.
- Anahtarı kopyalayıp Yox İş Ortağım'da AI Yönetimi ekranında sağlayıcı olarak Google Gemini'yi seçerek yapıştırın, ardından listelenen modellerden birini seçin.
Eski tip, kısıtlamasız standart anahtarlar Gemini API tarafından reddediliyor. AI Studio'da anahtar listesinde Unrestricted etiketi görüyorsanız etiketin üzerine gelip Add restrictions ile anahtarı yalnız Gemini API'ye kısıtlayın.
Gemini API faturalandırması, kullanım kademeleri ve oran sınırları
Gemini API'de yeni hesaplar ücretsiz katmanla başlar; faturalandırma hesabı bağlayıp ön ödeme yaptığınızda ücretli kademelere geçersiniz ve harcama arttıkça kademe kendiliğinden yükselir. Kademe, aylık harcama tavanını ve 10 dakikalık harcama hızı sınırını belirler.
Kullanım kademeleri ve harcama tavanı
| Kademe | Geçiş koşulu | Aylık harcama tavanı | 10 dakikalık harcama sınırı |
|---|---|---|---|
| Free | Aktif proje ya da ücretsiz deneme | Yok | Yok |
| Tier 1 | Etkin bir faturalandırma hesabı bağlamak | 250 $ | 10 $ |
| Tier 2 | 100 $ ödeme ve ilk başarılı ödemeden 3 gün sonra | 2.000 $ | 50 $ |
| Tier 3 | 1.000 $ ödeme ve ilk başarılı ödemeden 30 gün sonra | 20.000 – 100.000 $ ve üstü | 200 $ |
Ön ödemede (Prepay) en düşük kredi alımı 5 dolardır. Kullanılmayan krediler 12 ay sonra sona erer ve iade edilmez. Bakiye sıfıra düştüğünde o faturalandırma hesabına bağlı tüm projelerdeki anahtarlar aynı anda durur; bunu önlemek için otomatik yükleme (auto-reload) ve aylık üst sınır tanımlanabilir. Aylık tavana ulaşılırsa hizmet ayın 1'ine kadar duraklatılır.
Oran sınırları ve hata kodları
Oran sınırları dakikadaki istek (RPM), dakikadaki girdi token'ı (TPM) ve günlük istek (RPD) üzerinden ölçülür ve anahtar başına değil, proje başına uygulanır. Günlük kota Pasifik saatiyle gece yarısı, yani Türkiye saatiyle yaz döneminde 10.00'da, kış döneminde 11.00'de sıfırlanır. Güncel sınırlarınızı yalnız AI Studio'da görebilirsiniz; Google bu değerleri sabit bir tabloda vermiyor.
- 429 RESOURCE_EXHAUSTED: oran ya da harcama hızı sınırı aşıldı; bir süre bekleyip yeniden deneyin.
- 402 Payment Required: ön ödeme bakiyeniz bitti; AI Studio Billing sayfasından kredi yükleyin.
- Aynı faturalandırma hesabına bağlı başka projeler de aynı tavanı paylaşır; panel için ayrı proje açmak takibi kolaylaştırır.
Ücretsiz ve ücretli katmanda Gemini verilerinizi nasıl kullanır?
Gemini API'nin ücretsiz katmanında gönderdiğiniz içerik ve üretilen yanıtlar Google ürünlerini ve makine öğrenmesi teknolojilerini geliştirmek için kullanılabilir ve kalite amacıyla insan değerlendiriciler tarafından okunabilir; ücretli katmanda ise istemler ve yanıtlar ürün geliştirmede kullanılmaz. Avrupa Ekonomik Alanı, İsviçre ve Birleşik Krallık için tanınan istisna Türkiye'yi kapsamaz. Kritik ayrıntı şu: Google'ın şartlarına göre Gemini API erişimi yalnız etkin bir faturalandırma hesabına bağlı Cloud projesi üzerinden yapıldığında ücretli hizmet sayılır. Panele bağladığınız anahtarın projesinde faturalandırma yoksa, panelden giden ürün ve rapor verileri ücretsiz katman koşullarına tabidir.
| Konu | Ücretsiz katman | Ücretli katman (faturalı proje) | Gemini Enterprise Agent Platform (eski Vertex AI) |
|---|---|---|---|
| Ürün geliştirme ve eğitimde kullanım | Evet | Hayır | Hayır; izniniz ya da talimatınız olmadan eğitim yok |
| İnsan incelemesi | Kalite için okunabilir (hesap ve anahtardan ayrıştırılarak) | Yalnız kötüye kullanım tespiti için | Kötüye kullanım tespiti için istem kaydı; istisna talep edilebilir |
| Saklama | Ürün geliştirme amacıyla kullanılır, süre belirtilmez | Kötüye kullanım tespiti için 55 gün | Varsayılan 24 saatlik önbellek kapatılabilir; sıfır veri saklama seçenekleri var |
| Geçerli sözleşme | Google API Hizmet Şartları ve Gemini API Ek Şartları | Ek olarak Google'ın veri işleyen olduğu Veri İşleme Eki | Google Cloud Hizmet Şartları ve Cloud Veri İşleme Eki |
Vertex AI, yeni adıyla Gemini Enterprise Agent Platform ne zaman gerekir?
Google, Vertex AI platformunun adını Gemini Enterprise Agent Platform olarak değiştirdi. Aynı Gemini modelleri burada Google Cloud projesi, erişim yönetimi (IAM), bölge seçimi ve sıfır veri saklama gibi kurumsal denetimlerle sunulur; Google'ın önerisi, kurumsal denetim ihtiyacı yoksa Gemini Developer API'yi kullanmaktır. Yox İş Ortağım'daki Gemini bağlantısı AI Studio'da oluşturulan Gemini API anahtarıyla çalışır; Agent Platform hizmet hesabı kimlik bilgileri kullanılmaz.
KVKK açısından satıcıya pratik notlar
- Panel yalnız başlattığınız işlem için gereken veriyi gönderir: ürün kartı alanlarını ya da rapor görevlerinde özetlenmiş verileri.
- Prompt Merkezi talimatlarına müşteri adı, telefon, adres gibi kişisel veri yazmayın; yanıt taslağı görevinde müşterinin soru metni modele gider.
- Ek Şartlar'a göre ücretli hizmette istem ve yanıtlar Google'ın tesisi bulunan herhangi bir ülkede geçici olarak saklanabilir. Yurt dışına aktarım 6698 sayılı Kanun'un 2024'te değişen 9. maddesinde düzenlenir; hukuk danışmanınıza danışın.
Türkçe ürün içeriğinde Gemini kullanırken dikkat edilecekler
Gemini'ye Türkçe ürün metni yazdırırken asıl risk dil değil, kurallardır: model pazaryerinin karakter sınırlarını, kategoriye özel yasakları ve reklam mevzuatındaki iddia sınırlarını kendiliğinden bilmez. Bu yüzden talimat ve onay adımı sonucu belirler. Sık karşılaşılan riskler şunlar:
- Karakter sınırı: n11'e gönderilen ürünlerde başlık ve alt başlık en az 15, en çok 65 karakter olmak zorundadır. Sınırı aşan başlıkları başlık optimizasyon aracı ile kontrol edebilirsiniz.
- Kanıtlanamayan iddia: Ticari Reklam ve Haksız Ticari Uygulamalar Yönetmeliği'nin 7. maddesi reklamların doğru ve dürüst olmasını ister ve tüketiciyi yanıltabilecek ifadeleri yasaklar; 9. maddeye göre doğrulanabilir iddiaların kanıtlanması gerekir. "En dayanıklı", "yüzde 100 doğal", "hastalığa iyi gelir" gibi ifadeleri talimatla yasaklayın.
- Uydurma özellik: model, ürün kartında olmayan ölçü, malzeme ya da uyumluluk bilgisi ekleyebilir. Talimata "yalnız verilen alanları kullan" kuralını yazın.
- Benzer metin: Google üretilen içerik üzerinde sahiplik iddia etmez, ancak aynı ya da benzer içeriği başkaları için de üretebileceğini belirtir. Aynı kategorideki rakiplerle birebir benzeyen açıklamalar ilanınızı ayırt etmez.
Prompt Merkezi'nde talimatı kanala göre ayarlamak
Yox İş Ortağım'ın Prompt Merkezi'nde her yapay zekâ görevinin talimatını düzenleyebilir ya da görevi tamamen kapatabilirsiniz. Başlık ve açıklama görevine kanalın karakter sınırını, kullanmak istemediğiniz ifadelerin listesini ve markanızın tonunu yazmak, Gemini'nin önerilerini ilk denemede kullanılabilir hale getirir. Trendyol ve n11 gibi birden fazla kanalda satıyorsanız kuralları kanal bazında ayrı tutun. Öneri her durumda siz onaylayana kadar ürün kartına yazılmaz; düzenleyip onayladığınız metin kanala gider.
Yox İş Ortağım'da Gemini entegrasyonu: ekran, görevler ve paket şartı
Yox İş Ortağım'da Gemini entegrasyonu AI Yönetimi ekranından kurulur: sağlayıcı olarak Google Gemini'yi seçer, API anahtarını girer ve panelin hesabınız için listelediği modellerden birini seçersiniz. Seçtiğiniz model ürün içeriği, kategori önerisi, belge okuma ve analiz görevlerinde çalışır; kendi anahtarınızla yapılan kullanım token limitinden muaftır ve harcama AI Yönetimi'ndeki kullanım kaydında görünür.
| Paket | Aylık fiyat | Yapay zekâ kullanımı | Kendi Gemini anahtarı |
|---|---|---|---|
| Başlangıç | ₺499 | Yok | Yok |
| Büyüme | ₺999 | Yok | Yok |
| Profesyonel | ₺1.999 | Platform token'ıyla ürün açıklaması, başlık ve kategori önerisi | Yok |
| Kurumsal | ₺3.999 | Platform token'ı ya da kendi anahtarınız | Var |
| Enterprise | ₺7.999 | Kurumsal kapsamı ve sınırsız limitler | Var |
Yıllık ödemede paketlerde yüzde 20 indirim uygulanır; kanal, ürün ve sipariş limitleriyle birlikte paketleri karşılaştırabilirsiniz.
Platform token'ı mı, kendi Gemini anahtarınız mı?
Platform token'ıyla kullanımda model Yox'un yapılandırmasından gelir ve harcama token bakiyenizden düşer; başlamak için en kısa yol budur. Modeli bilinçli olarak Gemini seçmek, harcamayı kendi Google hesabınızda görmek ve verilerin sizin imzaladığınız ücretli katman koşullarıyla işlenmesini istiyorsanız kendi anahtarınızı bağlarsınız. Yüksek hacimde toplu içerik üretiyorsanız Flash-Lite modelleriyle kendi anahtarınız token limitine takılmadan çalışır. İsterseniz kurulumu birlikte yapıyoruz; 3 günlük ücretsiz deneme için Yox İş Ortağım'a başvurun.
Gemini entegrasyonu kontrol listesi ve sık yapılan hatalar
Gemini entegrasyonunu kurmadan önce bu listeyi gözden geçirmek, veri koşullarında ve maliyette sürprizleri önler.
Bağlamadan önce kontrol listesi
- Anahtarın bağlı olduğu projede faturalandırma etkin mi? Değilse veriler ücretsiz katman koşullarıyla işlenir.
- Panel için ayrı bir Google Cloud projesi açtınız mı? Harcama ve oran sınırı takibi ayrı proje ile kolaylaşır.
- Otomatik yükleme ve aylık otomatik yükleme üst sınırı tanımlı mı?
- Anahtar AI Studio'da Unrestricted görünüyorsa Gemini API'ye kısıtlandı mı?
- Prompt Merkezi'nde başlık görevine kanal karakter sınırı ve yasaklı ifade listesi yazıldı mı?
Sık yapılan hatalar
- Kısa metin işleri için 3.1 Pro önizleme modelini seçmek: varsayılan düşünme seviyesi yüksektir, maliyet örneğimizde 3.5 Flash-Lite'ın yaklaşık beş katı çıkar.
- 3.8 Flash bütçesini 2026 fiyatıyla yapıp 1 Ocak 2027'deki iki katlık artışı hesaba katmamak.
- Google AI Pro aboneliğinin API kullanımını karşıladığını sanmak; abonelik avantajları yalnız AI Studio arayüzünde geçerlidir.
- Kullanılmayan ön ödeme kredisinin 12 ay sonra yandığını unutup yüksek tutar yüklemek.
- Önerileri okumadan onaylamak: Gemini ürün kartında olmayan bilgiyi ekleyebilir.
Hangi modelin kataloğunuza uyduğundan emin değilseniz iletişim sayfamızdan bize yazın, birkaç ürünle birlikte deneyelim.
Son kontrol: 13 Ekim 2026
Claude
ChatGPT
Grok
DeepSeek
Meta Llama
Mistral AI
Perplexity
Azure OpenAI
Qwen
Cohere
Amazon Bedrock
OpenRouter
Kimi
Together AI