Gemini Entegrasyonu
Taze bir jekcms kurulumunun beklediği sağlayıcı Gemini'dir. Groq ve Cohere ile birlikte ücretsiz katman grubunda durur. Diğer sağlayıcılarda olmayan iki mekanizma yalnız onda var. Birincisi: birden fazla anahtar tanımlarsınız, jekcms aralarında döner. İkincisi: yoğun bir modele denk gelen istek hata vermeden alternatiflere geçer.
İkisi de aynı sebeple var. Ücretsiz bir Google AI Studio anahtarı cömerttir ama dalgalıdır; onu durduran iki şey anahtar başına kota ve geçici olarak yüklenmiş bir modeldir. Bunlar farklı sorunlardır, dolayısıyla jekcms ikisini farklı ele alır.
Anahtar almak
aistudio.google.com adresine gidin, bir Google hesabıyla oturum açın ve Get API key → Create API key deyin. Zaten 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 bir kez gösterilir.
Ücretsiz kullanım için faturalandırma kurmanız gerekmez. Ücretsiz kotayı aşmak sürpriz fatura değil, hız sınırlı yanıtlar üretir - Gemini yalnız arkadaki projede ücretli katmanı açıkça etkinleştirdiyseniz ücretlendirir. Güncel sınırları Google ai.google.dev/pricing adresinde yayımlıyor; başka bir yerde yazılı bir rakama güvenmek yerine oradan okumaya değecek kadar sık değişiyorlar.
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ıların aksine burası tek bir alan değil, bir listedir. Her satır anahtarın kendisini, sonradan ayırt edebilmeniz için isteğe bağlı bir etiketi ve bir etkinlik kutusunu alır. + Başka anahtar ekle yeni satır açar.
Anahtarlar saklanmadan önce şifrelenir ve mevcut bir satır yalnız maskeli bir ipucu gösterir - düz metin sayfaya geri basılmaz. Kaydederken bir satırın giriş kutusunu boş bırakmak orada saklı olanı korur; yani bir anahtarı yeniden etiketlemek ya da kapatmak için onu tekrar yazmanız gerekmez.
Kaydetmeden önce Test düğmesine basın. Gerçek bir çağrı yapar ve anahtar ile seçili model hakkında birlikte rapor verir.
Neden birden fazla anahtar
Bir istek kota ya da yetki hatasıyla döndüğünde - 429, 401 ya da 403 - jekcms o anahtarı şimdilik kullanılmaz işaretler ve hemen sıradaki etkin anahtarla yeniden dener. Çağıran taraf açısından hiçbir şey olmamıştır: üretim başarıyla döner.
Ücretsiz bir anahtarı çalışan bir site için pratik kılan şey budur. Tek anahtarın günlük hakkı, toplu bir koşuda çarpacağınız bir tavandır; üç anahtar üç tavandır ve geçiş, fark edip düzelttiğiniz bir şey değil, otomatiktir.
Bir anahtar sorun çıkarmaya başladığında doğru hamle onu silmek değil kapatmaktır - listede, etiketiyle kalır ve bir kutu işaretiyle geri getirirsiniz.
Model seçmek
Aynı sekmenin aşağısındaki AI Entegrasyonu kartı, Gemini'nin model listesini üç gruba ayrılmış hâlde taşır.
En güncel nesil grubu, en yenisi başta olmak üzere güncel flash modellerini tutar ve yoğun hacimli basit işler için hafif bir kardeşle biter. Varsayılan, en yeni flash olan gemini-3.8-flash'tır - güncel nesilde blog uzunluğundaki metin için en iyi fiyat/performans. Gemini Pro, karmaşık yeniden yazımlar için daha kaliteli ve daha yavaş seçeneği tutar. Otomatik grup ise Google'ın kendi hareketli takma adlarını taşır; bunlar her zaman Google'ın o an en güncel saydığı flash ya da pro modele çözülür.
Bu listedeki her giriş canlı API'ye karşı denendi. Bir model Google'ın dokümanında listeli olup yine de 404 dönebiliyor, bu yüzden jekcms yalnız gerçekten yanıt veren adları sunuyor. Kayıtlı modeliniz aradan geçen sürede emekliye ayrıldıysa listede bir özel grupta görünmeye devam eder. Sessizce başka bir modelle değiştirilmez; neyi değiştirmeniz gerektiğini görürsünüz - ayrıca jekcms, bilinen emekli adlardan bir kısmını geçerken güncel karşılıklarına çevirir, böylece eski bir kurulum yükseltmeden sonra da çalışmaya devam eder.
Model adını elle yazmayın. Kayıt defteri, üründeki her sağlayıcı için tek doğruluk kaynağıdır ve onun dışındaki bir ad, kimsenin denemediği bir addır.
Yedek zinciri
Kota bir arıza biçimidir; yoğunluk başka biri ve ikisi zıt tepkiler ister.
En yeni flash modeli "yoğun talep" mesajıyla 503 döndüğünde - ücretsiz anahtarlarda defalarca, bazen üç modelde aynı anda ölçüldü - anahtar değiştirmek işe yaramaz, çünkü anahtarda sorun yoktur. Bu yüzden jekcms anahtarı değiştirmez, model zincirinde aşağı iner. Sıra şöyle: yapılandırdığınız model, bir önceki ara neslin kararlı flash'ı, Google'ın flash-latest takma adı ve son çıkış olarak bir önceki büyük nesil.
Sonuç: Google verdiği sürece en yeni modeli alırsınız, vermediğinde çalışan bir yanıt alırsınız. Kullanıcı 503'ü hiç görmez. Bu davranış yalnız Gemini'ye özeldir; diğer dört sağlayıcı seçtiğiniz modeli çağırır ve ne dönerse onu verir.
Şunu akılda tutun: yoğunluk hata değildir. En yeni flash modelinden gelen bir 503, anahtarınızın bozuk ya da model seçiminizin yanlış olduğu anlamına gelmez ve hata bildirimi gerektirmez.
jekcms'in kendi seçtiği modeller
Metin için seçtiğiniz modelin ötesinde birkaç iş, doğru cevap aynı model olmadığı için belirli Gemini modellerine sabitlenmiştir.
Kapak ve içerik görseli üretimi güncel flash görsel modelini, hızlı geçişler için daha hafif kardeşini kullanır. Sesli makalelerin metin-konuşma dönüşümü flash TTS modelini kullanır. Tek cümlelik yardımcı çağrılar - örneğin bir görselin görsel brifi - tek satır için tam bir flash çağrısı yakmak yerine hafif modeli kullanır.
İnsanları şaşırtanı arama destekli çağrılardır. Rakip araştırması ve diğer web destekli sorgular bir önceki neslin flash modeline sabitlenmiştir; çünkü ücretsiz anahtarlarda güncel nesil, her destekli istek için 429 dönüyor - on sekiz anahtarla ölçüldü. Bu sabitleme bilinçlidir ve en yeni modelin çalışmayacağı yerde destekli özelliklerin ücretsiz anahtarla çalışmaya devam etmesinin sebebidir.
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 yalnız Gemini'ye değil her sağlayıcıya uygulanır. Kontrolden çıkmış bir döngünün ya da fazla hevesli bir yazarın hakkınızı yakmaması için vardır; iki sayacın kalan hakkı da kullanım tablosunun üstüne yazılır.
Ücretsiz anahtarda sessizce en değerli olanı önbellek süresidir: aynı SEO analizini o pencere içinde tekrarlamak hiçbir şeye mal olmaz, çünkü istek Google'a hiç ulaşmaz.
Bir şey ters gittiğinde
API anahtarı geçersiz. Neredeyse her zaman bir kopyala-yapıştır sorunu - sonda boşluk ya da anahtarın yalnız bir kısmı. AI Studio'dan yeniden kopyalayın ve Test düğmesine basın.
Kaynak tükendi. Anahtar dakikalık ya da günlük kotaya çarptı. Bu durumda dönüşüm işe yaramaz. Üç seçeneğiniz var: ikinci bir anahtar ekleyin, kotanın sıfırlanmasını bekleyin ya da anahtarın arkasındaki Google Cloud projesinde ücretli katmanı açın.
Her şey yavaş ama hiçbiri düşmüyor. Bu, yedek zincirinin çalışmasıdır. Bir şeyi değiştirmeden önce hangi modellere ulaşıldığına bakın; en yeni modeldeki "yoğun talep" dalgası kendi kendine geçer.
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ı. İstekler de yirmi görsele kadar toplu gider. Sonuçlar genel geçer okunuyorsa çare genellikle yazıya daha özgül bir odak ifadesi vermek ya da bir kademe üst modele çıkmaktır.