AI Ayarları

jekcms birkaç yerde AI kullanıyor: görsel alt metni üretmek, editörde içerik asistanlığı yapmak, toplu yazı üretmek, yorumları modere etmek. Bu sayfa o ayarların hepsinin tek elden yapıldığı paneli (admin/ai-settings.php) anlatıyor. API anahtarınızı buraya giriyor, hangi özelliğin hangi modeli kullanacağını seçiyor, bütçe uyarısı koyuyor, harcamayı izliyorsunuz.

API anahtarlarını bağlama

Panelin üst kısmında iki alan var:

OpenAI API anahtarı — sk-... ile başlıyor. GPT-4o, GPT-4o-mini ve o3-mini için kullanılıyor.
Gemini API anahtarı — AI... ile başlıyor. Gemini 1.5 Pro ve Flash için.

Her ikisinin yanında Test butonu var. Bu, anahtarı kaydetmeden önce tek bir token'lık ping atıp çalışıp çalışmadığını söylüyor — kaydedip sonra "niye iş görmüyor?" diye sorunu kovalamaktan iyi.

Anahtarlar config/secrets.php içinde kurulumun kendi APP_KEY'iyle AES-256 şifreli tutuluyor. Log'larda veya yedeklerde düz metin olarak görünmüyorlar. Rotasyon yapmak için yeni anahtarı yapıştırıp kaydetmeniz yeterli, eski silinir.

Sadece biri yeterliyse diğerini boş bırakabilirsiniz. Yapılandırılmamış sağlayıcıyı kullanacak şekilde ayarlanmış bir özellik olursa, jekcms otomatik olarak mevcut anahtarı olan sağlayıcıya düşer (admin banner'ında küçük bir uyarı çıkarır).

Hangi model hangi iş için iyi

Her özellik kendi modelini seçiyor. Bu kasıtlı bir karar — basit bir alt metin üretmek için GPT-4o'nun tam gücüne ihtiyaç yok, ama uzun makale yazımında fark ediyor. Varsayılanlar maliyet dengeli:

| Özellik | Varsayılan | Alternatifler | |---------|-----------|---------------| | Görsel alt metni | gpt-4o-mini | gpt-4o, gemini-1.5-flash | | Editör içerik asistanı | gpt-4o-mini | gpt-4o, o3-mini, gemini-1.5-pro | | Toplu üretim | gpt-4o | o3-mini, gemini-1.5-pro | | Özetleme | gpt-4o-mini | gemini-1.5-flash | | Çeviri | gpt-4o-mini | gemini-1.5-pro | | Yorum moderasyonu | gpt-4o-mini | gemini-1.5-flash |

Kaba özet: gpt-4o-mini ucuz ve hızlı, blog işlerinin %80'ine yeter. gpt-4o on kat pahalı ama karmaşık yeniden yazımlarda ya da teknik metinlerde farkı hissedersiniz. o3-mini akıl yürütme odaklı, çok adımlı mantık gerektiren işler için. Gemini Flash ise hem ucuz hem hızlı, büyük hacimli önemsiz işlerde (alt metin otomasyonu) parlıyor.

Açılır menüden seçip Save bastığınızda yeni model bir sonraki çağrıda devreye giriyor, yeniden başlatma yok.

Maliyet takibi

Panelin ortasında canlı kullanım göstergesi duruyor:

Tüketilen token'lar — giriş + çıkış, sağlayıcıya göre bölünmüş
Tahmini maliyet — her modelin resmi fiyatına göre hesaplanıyor, fiyat tablosu günlük güncelleniyor
Çağrı sayısı — toplam API çağrısı, özellik başına kırılım
Uyarı eşiği — siz bir dolar tavanı koyuyorsunuz, tahmini maliyet onu geçince panel kırmızıya dönüyor ve admin'e e-posta gidiyor

Sayaç varsayılan olarak her ayın 1'inde sıfırlanıyor. Fatura döneminiz takvim ayıyla aynı değilse yuvarlanan 30 günlük pencereye çevirebilirsiniz.

Herhangi bir satıra tıkladığınızda son 30 günün günlük harcama grafiği açılıyor. Kontrolden çıkmış bir iş akışı varsa (örn. bir cron bug'ı yüzünden her dakika alt metin üretme) grafikteki sivrilme o anda göze batıyor.

Bütçe uyarısı — bunu mutlaka kurun

Uyarı eşiği alanına bir rakam yazın. Aylık $20, $50, $100 — her neyse sizin için makul olan. Tahmini maliyet o eşiği geçtiği an hem admin panelinde kırmızı banner çıkıyor hem de yönetici e-posta adresine uyarı mailı gidiyor.

Bu ayar, siz uyurken bir şablon döngüsünün yüzlerce dolarlık kredi yakmasını engelleyen tek kalkan. Boş bırakmayın.

Özellik anahtarları

Her özelliğin açık/kapalı anahtarı var. Kapattığınız anda tüm çağrılar arayüzde açık bir hatayla reddediliyor, API'ye istek gitmiyor — yani maliyet anında duruyor.

Görsel alt metni otomatik üret — Açıksa her yüklenen görsel için otomatik öneri çıkıyor, kaydetmeden önce düzenleyebiliyorsunuz.
İçerik asistanı — Yazı editöründeki AI kenar panelini (anahat, yeniden yaz, genişlet, özetle) açar.
Toplu üretim — Toplu taslak aracını aktif eder.
Yorum moderasyonu — Yeni yorumları spam / ok / inceleme-gerekli olarak sınıflandırır.
Çeviri — Desteklenen diller için yazılara çeviri butonu ekler.

Alt metin otomasyonu

Görsel alt metni otomatik üret anahtarı muhtemelen en sevdiğiniz olacak. Açtığınız anda şu oluyor: medya kütüphanesinden bir görsel yükler yüklemez AI ona bakıyor, ekran okuyucular için uygun bir açıklama yazıyor ve alt metin alanını dolduruyor. Siz kaydetmeden önce istediğiniz gibi düzenleyebilirsiniz.

Erişilebilirlik açısından çok büyük bir iş — yüzlerce görseli tek tek alt metin yazmakla uğraşmadan SEO ve ekran okuyucu uyumu sağlıyorsunuz.

Üretim parametreleri (Advanced)

Advanced altında özellik başına üretim parametrelerini ayarlayabiliyorsunuz:

Temperature (0.0 – 2.0) — Düşük değer daha deterministik, yüksek değer daha yaratıcı. Alt metinde 0.2, içerikte 0.7, özetlerde 0.5 tutuyoruz.
Max tokens — Çıktı tavanı. Alt metin için 60, asistan için 2000, toplu için 4000.
Stop sequences — Üretimi sonlandıran stringler (en fazla 4 tane). Yapılandırılmış çıktıyı zorlamak için işe yarıyor.

Bir sebebiniz yoksa buraya dokunmayın — varsayılanlar test edilerek seçildi. Max tokens'ı çok düşük yaparsanız cümlenin ortasında kesiliyor, çok yüksek yaparsanız bütçe şişiyor.

Çağrı log'ları

Her AI çağrısı zaman damgası, özellik, model, token sayıları, gecikme ve durum ile storage/logs/ai.log dosyasına yazılıyor. AI → Logs altındaki panel son 1.000 girdiyi özellik ve duruma göre (success / error / rate_limited) filtreleyerek gösteriyor.

"Bu istek neden 30 saniye sürdü", "Bu hafta token harcamasını hangi istek patlattı", "Rate limit'e takılmaya başladık mı" gibi soruları bu log cevaplıyor.

Lisans katmanına göre erişim

Kullanabileceğiniz AI özellikleri lisansınıza bağlı:

DEV / PER — ai_basic: alt metin, içerik asistanı (gpt-4o-mini ve gemini-flash ile sınırlı), yorum moderasyonu
STD — PER'deki her şey + çeviri
PRO / AGC / ENT — ai_pro: her şey, tüm modeller, toplu üretim, özel prompt şablonları, dahili hız tavanı yok

Bir özellik lisansınız yüzünden kapalıysa anahtar gizlenmiyor — griye alınıp yanına Upgrade bağlantısı koyuyoruz, neyin kilitli olduğunu görebiliyorsunuz.