Yapay zekâ kurulumu (kendi anahtarınızla)

Mass Custom Fields, oluşturulan sayfalarınız için yapay zekâ ile içerik yazabilir. BYOK ilkesiyle çalışır: kendi API anahtarınızı getirirsiniz: OpenAI, Anthropic veya Google'dan. İstekler sunucunuzdan doğrudan sağlayıcıya gider; hiçbir şey WPMass üzerinden geçmez ve kullanımın faturasını sağlayıcı size keser (bkz. Yapay zekâ gizliliği ve maliyetleri).

Yapay zekâ Pro ve üzeri planların parçasıdır. Plan olmadan AI sekmesi yoktur.

Ayarları açın

Şuraya gidin: WPM Fields › Settings › AI. AI provider kartı şöyle der: "Programmatic SEO uses this provider to write field content for each generated page. You bring your own API key."

1. Sağlayıcıyı ve modeli seçin

Önce Provider alanını, sonra Model alanını seçin. "Smaller models are cheaper and usually good enough for field content." Modeli seçmeden sağlayıcıyı değiştirirseniz yeni sağlayıcının varsayılanı kullanılır.

Bir anahtar kaydedildiğinde model listesi canlıdır: "%d model available to your API key." Hesabınızın kullanabileceği metin modellerini gösterir (OpenAI: sohbet modelleri; ses, görsel, arama veya embedding modelleri yok; Anthropic: kendi modelleri; Gemini: metin modelleri). Sağlayıcı başına 12 saat önbelleğe alınır ve anahtarı kaydettiğinizde, kaldırdığınızda veya Refresh list düğmesine tıkladığınızda yenilenir. Anahtar yokken "Suggested models. Save an API key to list every model your account can use." görürsünüz. Liste yüklenemezse: "Could not load the models of your account: …".

Seçin: Other model…, ardından Model id alanına "Exactly as the provider names it in its API documentation." yazın (harfler, rakamlar ve . _ : / -, en fazla 100 karakter).

Sağlayıcılar modelleri kaldırır ve ekler; bir model çalışmayı bırakırsa Refresh list kullanın veya yeni kimliği yazın.

2. API anahtarını ekleyin

Sağlayıcınızın konsolunda (OpenAI Platform, Anthropic Console, Google AI Studio) bir anahtar oluşturun, ardından:

A seçeneği (önerilen): wp-config.php içinde tanımlayın.

define( 'WPMCF_AI_OPENAI_KEY', 'sk-…' );
define( 'WPMCF_AI_ANTHROPIC_KEY', 'sk-ant-…' );
define( 'WPMCF_AI_GEMINI_KEY', '…' );

Anahtar veritabanına hiç girmez. Alan bu durumda Defined in wp-config.php rozetini ve "Set in wp-config.php with WPMCF_AI_OPENAI_KEY. Remove the constant to manage the key here." mesajını gösterir. Sabit her zaman kaydedilmiş anahtara üstün gelir.

B seçeneği: ayarlara yapıştırın. Anahtarı API key alanına yapıştırın ("Paste your API key") ve Save key düğmesine tıklayın ("API key saved."). Anahtarlar boşluk içeremez ve en fazla 500 karakter olabilir ("Paste the API key without spaces.").

Her sağlayıcının kendi anahtar alanı vardır (OpenAI API key, Anthropic API key, Google Gemini API key); sağlayıcıyı değiştirdiğinizde diğer sağlayıcıların kaydedilmiş anahtarları korunur.

Anahtarlar nasıl korunur

• Kaydedilen anahtarlar şifrelenmiş olarak (libsodium secretbox, sitenizin güvenlik tuzlarından türetilen bir anahtarla) wpmcf_ai_keys seçeneğinde saklanır; bu seçenek otomatik yüklenmez ve hiçbir zaman dışa aktarılmaz.
• Bir anahtar tarayıcıya asla gönderilmez. Kaydettikten sonra alan yalnızca "A key ending in …abcd is saved (encrypted). Paste a new key to replace it." gösterir (son dört karakter; daha kısa anahtarlarda hiçbir şey gösterilmez).
• Anahtarlar, sağlayıcıların hata mesajlarından temizlenir.
• Güvenlik tuzlarını değiştirirseniz (wp-config.php içinde ya da veritabanını başka tuzlara sahip bir siteye taşıyarak) kaydedilen anahtarın şifresi artık çözülemez: "The saved key can no longer be read (the site salts changed). Enter it again." Sabitler bundan etkilenmez.
• Remove, kaydedilmiş bir anahtarı siler ("API key removed.").
• Anahtarları yalnızca yöneticiler yönetebilir; diğer roller HTTP 403 alır.

3. Sınırlar ve yanıt uzunluğu

İstekler bir yanıt için en fazla 60 saniye bekler. Sağlayıcıyı, modeli ve sınırları kaydetmek için Save changes düğmesine tıklayın ("AI settings saved.").

4. Bağlantıyı test edin

Değişikliklerinizi kaydedin, ardından Test connection düğmesine tıklayın. Çok küçük bir istek gönderir (yaklaşık 64 çıktı belirteci, fark etmeyeceğiniz bir tutar) ve "Connected. The model gpt-5-mini answered." yanıtını ya da Connection failed sonucunu sağlayıcının mesajıyla verir. Önce sağlayıcıyı veya modeli değiştirdiyseniz sayfa sizden "Save your provider and model changes before testing the connection." ister.

Tipik hatalar:

Bir çalıştırma sırasında bir şey başarısız olursa ne olur

Bkz. Yapay zekâ brifingleri ve çalıştırmalar: hız sınırları çalıştırmayı duraklatır, reddedilen bir anahtar veya boş bir hesap çalıştırmayı bir mesajla durdurur, bozuk bir yanıt yalnızca o sayfayı başarısız kılar.

Geliştiriciler için

Sağlayıcılar wpmcf/ai/providers filtresinden gelir (sağlayıcı kimliği → eklentinin Provider arayüzünü uygulayan bir nesne); özel veya kendi barındırdığınız bir ağ geçidi bu şekilde eklenebilir. Eklenen sağlayıcıların anahtarları, sağlayıcı kimliği büyük harfle olmak üzere WPMCF_AI_{PROVIDER}_KEY sabit adını kullanır.