Gemini Entegrasyonu

Google Gemini, çoğu jekcms AI özelliğinde OpenAI'ye doğrudan bir alternatif. Gemini'nin cazip yanı şu: Google hâlâ oldukça cömert bir ücretsiz katman sunuyor. Bu yazı yazılırken gemini-2.0-flash modeli için dakikada 15 istek ve günde 1.5 milyon token'a kadar ücretsiz. Mütevazı bir blog için bu, alt metin otomasyonunu ve editör asistanını hiç ödeme yapmadan çalıştırmaya yetiyor.

Gemini'yi üç farklı şekilde kullanabilirsiniz: tek başına, OpenAI'ye yedek olarak ya da "şu özellik Gemini, bu özellik OpenAI" diye bölüştürerek. Özelliklerin nasıl çalıştığına dair detay için OpenAI entegrasyonu sayfasına bakın; burada sadece Gemini'ye özgü kısımları anlatıyoruz.

API anahtarı almak

1. aistudio.google.com adresine Google hesabınızla girin.
2. Sol üstten Get API key → Create API key.
3. Mevcut bir GCP projeniz varsa seçin; yoksa AI Studio sizin için ücretsiz bir tane oluşturur.
4. Anahtarı kopyalayın — yalnızca bir kez düz metin olarak görüyorsunuz.

Ücretsiz katman kullanımı için fatura bilgisi girmek gerekmiyor. Kotayı aşarsanız sürpriz bir fatura gelmiyor, sadece hız sınırlı yanıtlar alıyorsunuz. Gemini ancak siz projede ücretli katmanı açıkça etkinleştirirseniz ücretlendiriyor.

Anahtarı jekcms'e ekleme

1. Admin → Settings → API Keys
2. Anahtarı Gemini API key alanına yapıştırın.
3. Kaydedin.

OpenAI ve Stripe anahtarları gibi, Gemini anahtarı da veritabanında AES-256 ile şifrelenmiş halde duruyor.

Hangi model hangi iş için

Settings → AI → Model preferences altında üç Gemini seçeneği var:

• gemini-2.0-flash — İçerik üretimi için varsayılan tercih. Hızlı, çok modlu (yani görseli de görebiliyor), 1M token'lık uzun bağlamı rahat idare ediyor. Ücretsiz katman için biçilmiş kaftan.
• gemini-2.0-flash-lite — Daha ucuz, daha düşük gecikmeli kardeş model. Yüksek hacimli basit işler — alt metin, özet — için ideal. Çok derin bir akıl yürütme istenmeyen her şey burada koşabilir.
• gemini-2.0-pro — Karmaşık yeniden yazımlarda daha iyi kalite, ama daha yavaş ve ücretsiz katman kotasını daha hızlı bitiriyor.

Önerilen eşleştirmeler:

| Özellik | Önerilen model | |---|---| | Editör içerik asistanı | gemini-2.0-flash | | Toplu yazı üretimi | gemini-2.0-flash | | Yüklenen görsellerde alt metin | gemini-2.0-flash-lite | | Özet üretimi | gemini-2.0-flash-lite | | Yorum moderasyonu | gemini-2.0-flash-lite |

OpenAI'deki gibi özellik başına farklı model seçebilirsiniz.

Ücretsiz katman ne kadar verir?

Bu yazı yazılırken Google AI Studio'nun ücretsiz katmanı (ai.google.dev/pricing — rakamlar zamanla değişebilir, oradan doğrulayın):

• Model başına dakikada 15 istek
• Dakikada 1 milyon token
• Flash'ta günde 1.500 istek, Pro'da oransal olarak daha az
• Flash'ta günde 1.5M token

Bağlam için söyleyelim: tipik bir blog yazısı 2-4k token girdi + 1-2k token çıktı. Bu katmanla rahatça günde yüzlerce yazı veya binlerce görsel alt metni üretebiliyorsunuz.

Gemini'yi ne zaman seçmeli

Maliyet. İş yüklerin ücretsiz katmana sığıyorsa Gemini gerçekten sıfır dolar. Haftada birkaç yazı yayınlayan, her görsele otomatik alt metin isteyen bir içerik sitesi için mükemmel.

Görüntü işleme. Gemini'nin görüntü anlama yeteneği GPT-4o seviyesinde ve çağrı başına daha ucuz. Alt metin otomasyonu, görsel sınıflandırma ("bu görselde metin var mı?") gibi işler için doğal bir tercih.

Uzun bağlam. Gemini 1M token pencere sunuyor, OpenAI gpt-4o 128k'da kalıyor. Modele tüm bir belgeyi yeniden yazdırmak, bir kategorinin tüm yazılarını birlikte değerlendirmek istiyorsanız Gemini parçalamadan yapıyor.

OpenAI'de kalmanız daha iyi olan durumlar. Karmaşık akıl yürütme (hukuki/teknik yeniden yazımlar, içerik içinde kod), function calling güvenilirliği ve prompt'larınızı zaten GPT-4o'nun spesifik davranışına göre ince ayar yaptığınız durumlar. "Çalışan bir şeyi bozma" prensibi.

Yedek (fallback) zinciri kurmak

İki anahtarı da kaydetmişseniz jekcms'e dayanıklı bir zincir kurdurabiliyorsunuz. Settings → AI → Fallback altında:

Primary:   OpenAI (gpt-4o-mini)
Fallback:  Gemini (gemini-2.0-flash)

jekcms önce birincil sağlayıcıyı çağırıyor. 429 (rate limit), 5xx veya timeout dönerse aynı prompt'la yedek sağlayıcıyı deniyor. Kullanıcı başarılı tek bir üretim görüyor; logları açmadıkça yedeğe geçildiğini fark etmiyorsunuz.

Sırayı ters çevirmek de güzel bir strateji — Gemini'yi birincil (ücretsiz) yapın, OpenAI'yi yedek (Gemini kotanızı doldurduğunda devreye girer). Orta hacimli siteler için kalite başına en ucuz düzen bu oluyor.

Özellik başına yönlendirme

Global zincirin ötesinde, özellik bazında da farklı sağlayıcı seçebilirsiniz. Örnek bir düzen:

| Özellik | Sağlayıcı | Model | |---|---|---| | İçerik asistanı | OpenAI | gpt-4o-mini | | Toplu üretim | Gemini | gemini-2.0-flash | | Alt metin | Gemini | gemini-2.0-flash-lite | | Özetler | Gemini | gemini-2.0-flash-lite |

Bu kurulum kaliteyi önemli olduğu yerde (canlı editör) OpenAI'de tutarken, önemsiz olduğu yerde (arka planda binlerce görselin alt metni) Gemini'nin ücretsiz hacmini kullanıyor.

Sorun giderme

"API key not valid." Büyük ihtimalle kopyala-yapıştır hatası — anahtarın sonunda boşluk var ya da sadece bir kısmı yapıştırılmış. AI Studio'dan anahtarı tekrar alın.

"Resource has been exhausted." Dakika başı veya gün başı kotayı doldurdunuz. Bekleyin (kotalar sıfırlanır), Google Cloud projesinde ücretli katmanı etkinleştirin ya da o özelliği geçici olarak OpenAI'ye taşıyın.

Alt metin kalitesi düşük. gemini-2.0-flash-lite iyi ama harika değil. O özelliği gemini-2.0-flash'a çıkarın ya da alt metin için OpenAI'ye yönlendirin, geri kalan her şey Gemini'de kalsın.

Yedek tetiklenmiyor. Admin → AI → Usage → Logs bölümüne bakın. Yedek sadece belirli hata kodlarında (429, 5xx, timeout) devreye giriyor. 400 dönen bozuk prompt kullanıcı hatası sayılıyor, sağlayıcı kesintisi değil, bu yüzden yedek atılmıyor.