Gemini Entegrasyonu

Gemini, yeni bir jekcms kurulumunda varsayılan AI sağlayıcısıdır. Groq ve Cohere ile birlikte ücretsiz katman grubundadır ve diğer sağlayıcılarda olmayan iki özelliği vardır. Birden fazla anahtar ekleyebilirsiniz ve jekcms bu anahtarlar arasında sırayla geçiş yapar. Bir model yoğun olduğunda istek hata vermeden önce alternatif modelleri dener.

Google Gemini anahtar satırları; Başka Anahtar Ekle ve her anahtar için Test düğmesi
Birden çok anahtar kabul eden tek sağlayıcı Gemini; istemci anahtarlar arasında döner.

Ücretsiz bir Google AI Studio anahtarı çok sayıda isteğe izin verir, ama iki durum onu durdurur: anahtar başına kota ve geçici olarak aşırı yüklenmiş bir model. Anahtar dönüşümü birinci sorunu, model yedek listesi ikinci sorunu çözer.

Anahtar almak

aistudio.google.com adresine gidin, bir Google hesabıyla oturum açın ve Get API key → Create API key seçeneğini kullanın. Bir Google Cloud projeniz varsa anahtarı ona bağlayabilirsiniz; yoksa AI Studio sizin için ücretsiz bir proje açar. Anahtar düz metin olarak yalnızca bir kez gösterilir.

Ücretsiz kullanım için faturalandırma kurmanız gerekmez. Ücretsiz kota aşıldığında beklenmedik bir fatura gelmez, istekler hız sınırı yanıtı alır. Gemini yalnızca projede ücretli katmanı açıkça etkinleştirdiyseniz ücret alır. Google güncel sınırları ai.google.dev/pricing adresinde yayımlar. Sınırlar sık değiştiği için başka bir yerde yazılı rakamlar yerine bu sayfaya bakın.

Anahtarları eklemek

Ayarlar → API ve Otomasyon ekranını açın ve AI İçerik Üretimi altındaki Gemini bloğunu bulun. Diğer sağlayıcılardan farklı olarak burada tek bir alan değil, bir liste vardır. Her satırda anahtarın kendisi, anahtarları ayırt etmek için isteğe bağlı bir etiket ve bir etkinlik kutusu bulunur. + Başka anahtar ekle yeni bir satır açar.

Anahtarlar saklanmadan önce şifrelenir ve kayıtlı bir satır yalnızca maskeli bir ipucu gösterir; anahtarın kendisi sayfaya geri yazılmaz. Kaydederken bir satırın giriş kutusunu boş bırakırsanız kayıtlı anahtar korunur. Bu yüzden bir anahtarın etiketini değiştirmek ya da onu kapatmak için anahtarı yeniden yazmanız gerekmez.

Kaydetmeden önce Test düğmesine basın. Test gerçek bir çağrı yapar ve hem anahtarın hem de seçili modelin durumunu gösterir.

Neden birden fazla anahtar

Bir istek kota ya da yetki hatası (429, 401 ya da 403) aldığında jekcms o anahtarı bir süre kullanılmaz olarak işaretler ve isteği hemen sıradaki etkin anahtarla yeniden gönderir. İsteği yapan özellik normal bir sonuç alır.

Ücretsiz anahtarla çalışan bir sitede bu özellik önemlidir. Toplu bir iş tek bir anahtarın günlük hakkını bitirebilir; üç anahtarla üç kat hakkınız olur ve jekcms anahtarlar arasında kendisi geçiş yapar.

Bir anahtar hata vermeye başlarsa onu silmek yerine satırını kapatın. Anahtar etiketiyle birlikte listede kalır ve tek bir kutuyu işaretleyerek yeniden açabilirsiniz.

Model seçmek

Aynı sekmenin aşağısındaki AI Entegrasyonu kartında Gemini'nin model listesi üç gruba ayrılmış olarak bulunur.

En güncel nesil grubunda güncel flash modelleri en yenisinden başlayarak sıralanır; grubun sonunda çok sayıda basit iş için hafif bir model bulunur. Varsayılan model en yeni flash modeli olan gemini-3.8-flash'tır. Bu model, güncel nesilde blog uzunluğundaki metin için en iyi fiyat/performans oranını sunar. Gemini Pro grubunda karmaşık yeniden yazımlar için daha kaliteli ama daha yavaş model bulunur. Otomatik grupta ise Google'ın değişen takma adları yer alır; bu adlar her zaman Google'ın o an en güncel saydığı flash ya da pro modeli kullanır.

Listedeki her model canlı API üzerinde denendi. Bir model Google'ın dokümanında listelenip yine de 404 döndürebilir, bu yüzden jekcms yalnızca gerçekten yanıt veren modelleri sunar. Kayıtlı modeliniz sonradan kullanımdan kaldırıldıysa listede özel grupta görünmeye devam eder; böylece hangi modeli değiştirmeniz gerektiğini görürsünüz. jekcms ayrıca bilinen bazı eski model adlarını güncel karşılıklarına çevirir, böylece eski bir kurulum güncellemeden sonra da çalışır.

Model adını elle yazmak yerine listeden seçin. Liste üründeki bütün sağlayıcılar için tek kaynaktır ve listede olmayan bir ad denenmemiştir.

Yedek model listesi

Yoğun bir model, dolmuş bir kotadan farklı bir sorundur. En yeni flash modeli "yoğun talep" mesajıyla 503 döndürdüğünde (bu durum ücretsiz anahtarlarda sık görülür, bazen üç modelde aynı anda) başka bir anahtar işe yaramaz, çünkü anahtarda bir sorun yoktur. jekcms bu durumda aynı anahtarla sırasıyla şu modelleri dener: seçtiğiniz model, bir önceki ara neslin kararlı flash modeli, Google'ın flash-latest takma adı ve son olarak bir önceki büyük nesil.

Google en yeni modeli sunduğu sürece bu modeli kullanırsınız; sunmadığı zaman daha eski bir modelden yanıt alırsınız. Böylece kullanıcı 503 hatasını görmez. Bu davranış yalnızca Gemini'de vardır; diğer dört sağlayıcı seçtiğiniz modeli çağırır ve onun yanıtını döndürür.

En yeni flash modelinden gelen bir 503, anahtarınızın bozuk ya da model seçiminizin yanlış olduğunu göstermez ve hata bildirimi yapmanız gerekmez.

jekcms'in kendi seçtiği modeller

Seçtiğiniz model metin üretiminde kullanılır. Bazı işler ise her zaman belirli bir Gemini modelini kullanır:

Kapak görselleri ve yazı içi görseller güncel flash görsel modeliyle, hızlı denemeler ise bu modelin daha hafif sürümüyle üretilir. Sesli makaleler flash metin-konuşma (TTS) modelini kullanır. Bir görsel üretmek için kullanılan tek cümlelik açıklama gibi kısa yardımcı istekler hafif modeli kullanır.

Google Arama destekli çağrılar (rakip araştırması ve Google Search kullanan diğer sorgular) bir önceki neslin flash modelini kullanır. On sekiz anahtarla yapılan denemelerde güncel nesil, ücretsiz anahtarlarla yapılan her arama destekli isteğe 429 döndürdü. Eski model, bu özelliklerin ücretsiz anahtarla da çalışmasını sağlar.

Kota alanları ne yapar

Aynı karttaki günlük kota, kullanıcı kotası, önbellek süresi, sıcaklık ve azami çıktı jetonu alanları jekcms'in kendi sınırlarıdır ve her sağlayıcıya uygulanır. Bu alanlar, hatalı bir otomasyonun ya da çok yoğun çalışan bir yazarın hakkınızı tüketmesini önler. İki sayacın kalan hakkı kullanım tablosunun üstünde gösterilir.

Ücretsiz anahtarda en çok tasarruf önbellek süresinden gelir: aynı SEO analizi bu süre içinde tekrarlanırsa yanıt önbellekten gelir ve Google kotanızdan düşmez.

Bir şey ters gittiğinde

API anahtarı geçersiz. Sebep genellikle bir kopyalama hatasıdır; örneğin sonda boşluk kalmıştır ya da anahtarın yalnızca bir kısmı kopyalanmıştır. Anahtarı AI Studio'dan yeniden kopyalayın ve Test düğmesine basın.

Kaynak tükendi. Anahtar dakikalık ya da günlük kotasını doldurdu. Dönüşümün bu durumu karşılaması için ikinci bir anahtar ekleyin, kotanın sıfırlanmasını bekleyin ya da anahtarın bağlı olduğu Google Cloud projesinde ücretli katmanı açın.

Her şey yavaş ama istekler başarısız olmuyor. Bu durumda yedek model listesi çalışıyordur: en yeni model yoğun olduğu için istekler eski modellere gidiyordur. Durum kendiliğinden düzelir; bir ayarı değiştirmeniz gerekmez.

Alt metin kalitesi düşük. Alt metin görsele bakılarak değil, bağlamdan yazılır: yazı başlığı, odak ifadesi, görselin çevresindeki cümle ve dosya adı. Bir istekte yirmi görsele kadar gönderilir. Sonuçlar çok genel kalıyorsa yazıya daha belirgin bir odak ifadesi verin ya da bir üst kademedeki modeli seçin.

Yeniliklerden ilk sen haberdar ol

Yeni özellikler, sürüm notları ve CMS rehberleri. Ayda birkaç e-posta gönderiyoruz.