OpenAI Entegrasyonu

OpenAI'yi jekcms'e bağladığınızda üç büyük iş sizin için kolaylaşıyor: editörde yanınızda bir yardımcı bulunuyor, arka planda toplu yazı ürettirebiliyorsunuz ve yüklediğiniz her görsele otomatik alt metin geliyor. Bu sayfa API anahtarını nereden alacağınızı, jekcms'e nasıl ekleyeceğinizi, hangi modeli ne zaman seçmeniz gerektiğini ve bütçenizi nasıl koruyacağınızı anlatıyor.

Aynı özelliklerin büyük çoğunluğunu ücretsiz bir alternatif olarak Gemini ile de yapabilirsiniz. Her iki anahtarı birden bağlarsanız, hangi özelliği hangi sağlayıcının yöneteceğini özellik başına seçebilirsiniz (bkz. Gemini Entegrasyonu).

API anahtarını almak

platform.openai.com adresine gidin ve hesabınızla giriş yapın.
API keys → Create new secret key seçin.
Açılan anahtarı kopyalayın — sadece bir kez görüyorsunuz, kapattıktan sonra aynı anahtarı tekrar göremezsiniz.
Fatura bilgilerinizi ekleyin. Ücretsiz deneme kredisi yalnızca birkaç bin token'lık, yani ciddi bir kullanım için kartınızı eklemeniz gerekecek.

Anahtarı jekcms'e ekleme

Admin → Settings → API Keys
Kopyaladığınız anahtarı OpenAI API key alanına yapıştırın.
Kaydedin.

Anahtar veritabanında AES-256 ile şifrelenmiş halde duruyor. Sadece veritabanını eline geçiren biri anahtarı çözemez — şifreleme anahtarı config.php içinde tutuluyor, ikisinin birden ele geçmesi lazım.

Hangi modeli seçmeliyim?

Settings → AI → Model preferences altında üç model seçeneğiniz var. Kaba özet:

gpt-4o-mini — Varsayılan model. Ucuz (~0.15 $/M girdi token), hızlı, çoğu blog içeriği için yeterince akıllı. Günlük iş yükünün %80'i buna uyuyor.
gpt-4o — Daha akıllı, ama on kat pahalı. Karmaşık yeniden yazımlar, teknik açıklamalar, uzun biçimli yazım için değer.
o3-mini — Akıl yürütme odaklı model. Çok adımlı mantık, veri analizi, kod üretimi gibi işlerde parlıyor. Yukarıdaki ikisi arası maliyette ama daha yavaş cevap veriyor.

Özellik bazında ayrı ayrı seçim yapabilirsiniz — örneğin alt metin gibi basit işler için gpt-4o-mini, uzun makale üretimi için gpt-4o. Pratik bir taktik: ucuz modelle başlayın, çıktı yeterince iyiyse orada kalın. Kaliteden memnun değilseniz o özelliği daha yüksek modele çekin.

Editörde asistan butonları

OpenAI anahtarı kaydedildiğinde yazı editörünün kenar çubuğunda AI Assist paneli beliriyor. İçindeki butonlar:

Continue writing — İmleç konumundan itibaren bir-iki paragraf üretir.
Improve — Seçili metni, anlamı koruyarak daha iyi dil bilgisi ve akışla yeniden yazar.
Shorten — Önemli bilgileri kaybetmeden sıkıştırır.
Expand — Detay, örnek ekleyerek genişletir.
Rewrite formally / casually — Resmi / samimi üsluba çevirir.
Explain this — Teknik bir paragrafı herkesin anlayacağı şekilde açıklar.

Her çağrı sonucu token token akıyor — metin yazılırken gözünüzün önünde doğuyor. Beğenmezseniz akış sürerken iptal edebilirsiniz.

Toplu içerik üretimi

Diyelim ki 50 farklı anahtar kelime için SEO yazısı yazmak istiyorsunuz. Tek tek oturup prompt yazmak yerine toplu kuyruk kullanın.

Admin → Content → Bulk Queue → New batch

CSV yükleyin ya da satır satır konu listesi yapıştırın.
Bir şablon seçin — örn. "800 kelime, 3 H2 bölümü, sonunda SSS bulunan nasıl yapılır makalesi".
Sınırları belirleyin — yazı başına azami token, toplam bütçe tavanı, dakika başına üretim sayısı.
Başlat.

Kuyruk arka planda (cron işçisi üzerinden) çalışıyor. İlerlemeyi canlı izleyebilirsiniz — her öğe pending → generating → done durumlarında görünür ve her biri Taslaklara düşmeden önce önizlenebilir.

Bütçe tavanı konusunda dikkat

Toplu üretime başlamadan önce kesin bir bütçe tavanı koyun — örn. parti başına $10. Tavan koymadan çalışan bozuk bir şablon döngüsü, siz uyurken yüzlerce dolar kredi yakabilir. Acı tecrübeyle söylüyoruz.

Alt metin otomasyonu

Her görsele elle alt metin yazmak insanın gözünün korktuğu bir iş. AI bunu üstlenebiliyor:

Admin → Settings → AI → Image alt-text → Auto-generate on upload açın.
Ya da tek tek manuel: Media → görsel seç → Generate alt text.

Model görseli gerçekten "görüyor", ekran okuyucuya uygun bir açıklama yazıyor. Yazdığı metni medya satırını düzenleyip istediğiniz gibi değiştirebilirsiniz. Hem erişilebilirlik puanınız yükseliyor hem de SEO için görsel alt metin boşluğu kalmıyor.

Maliyet takibi

Admin → AI → Usage size şunları gösteriyor:

Özellik başına günlük token tüketimi (assist / bulk / alt-text)
Güncel OpenAI fiyatlarına göre tahmini dolar maliyeti
En çok token yakan 10 yazı
Aylık harcama uyarı eşiği — belirli bir sınırı geçtiğinizde e-posta gelir

Aylık başlangıçta uyarı eşiğini kendi rahat olduğunuz rakama ayarlayın. İlk ay gözlem, sonraki aylarda ince ayar — bu genelde iyi bir yaklaşım.

Sorun giderme

"Rate limit exceeded." OpenAI yeni hesapları düşük dakika başı limitlerle başlatıyor. Ya mesajda söylediği süreyi bekleyin ya da OpenAI hesap seviyenizi (tier) yükseltin.

"Invalid API key." Anahtar silinmiş, iptal edilmiş ya da sonunda boşluk var. OpenAI panelinden yeniden yapıştırın, etraftaki tırnak işaretlerini almayın.

Toplu kuyruk "generating" aşamasında takıldı. Automation → Scheduled tasks altına bakın. ai_bulk_worker görevinin her dakika çalışması lazım. Çalışmıyorsa hostunuzda cron kurulu değil demektir. Yedek olarak web isteklerinin yaklaşık %2'si bir kuyruk öğesini ilerletiyor — yani iş durmaz ama yavaş ilerler.

Üretilen içerik kalitesiz. Şablonu iyileştirin — örnek çıktılar koyun, üslup kısıtlaması ekleyin, okuma seviyesini belirtin. OpenAI iyi talimatı iyi takip ediyor; kalitesizliğin çoğu prompt'tan kaynaklanıyor.