AI ve API anahtarları

Editördeki her AI ve stok içerik özelliği, kendinizin sağladığı anahtarlarla çalışır. Bu sayfa, bunları nereye gireceğinizi anlatır: sohbet asistanının kullandığı AI sağlayıcısı, Media sekmesinin kullandığı beş stok medya sağlayıcısı ve asistanın tasarım tariflerinin arkasındaki isteğe bağlı vektör arama bilgi tabanı.

Hızlı bakış

1. Settings, ardından AI Settings bölümünü açın.
2. Bir sağlayıcı sekmesi seçin, API anahtarınızı yapıştırın ve bir model seçin.
3. General Settings altında isteğe bağlı bir sistem istemi, sıcaklık ve maksimum jeton değeri belirleyin, sonra Save Settings düğmesine tıklayın.
4. Anahtara güvenmeden önce çalıştığını doğrulamak için Test Connection düğmesini kullanın.
5. Diğer iki anahtar seti için Knowledge Base bölümüne geçin veya Stock Media API Keys kısmına kaydırın.

Ayrıntılı referans

AI sağlayıcıları

Sağlayıcı	Notlar
Qwen (DashScope)	Varsayılan sağlayıcı
Kimi (Moonshot)
DeepSeek
GLM (Zhipu)
OpenAI
Google Gemini
Anthropic Claude
Özel uç nokta	OpenAI uyumlu herhangi bir sohbet tamamlama API'si

Her sekme, göster/gizle geçişli, parola gibi maskelenmiş bir API anahtarı alanı ve kartlardan oluşan bir ızgara biçiminde bir model seçici gösterir. Custom Endpoint sekmesi, seçilecek sabit bir model listesi olmadığı için model ızgarasını bunun yerine bir Base URL ve Model Name alanıyla değiştirir. Hangi sağlayıcıların görmeyi ve yerel görsel üretmeyi desteklediğini görmek için bkz. AI sohbet asistanı.

Genel ayarlar

Her sağlayıcı arasında ortaktır.

Ayar	Aralık	Notlar
Sistem istemi	Serbest metin	İsteğe bağlı özel yönergeler, örneğin asistanı belirli bir tasarım tarzına yönlendirme
Sıcaklık	0 ile 2 arası	Kaydırıcıyı hareket ettirdikçe Precise, Balanced, Creative veya Wild olarak etiketlenir
Maksimum jeton	100 ile 32768 arası	Tek bir yanıtın ne kadar uzun olabileceğini sınırlar

Save Settings etkin sağlayıcıyı, anahtarı ve modeli saklar; Test Connection ise gerçek bir sohbeti beklemeden anahtarın geçerli olduğunu doğrulamak için küçük bir istek gönderir.

Stok medya API anahtarları

Medya kütüphanesi içindeki aramayı besleyen, sohbet asistanının kendi anahtarıyla ilgisi olmayan ayrı bir anahtar listesi.

Sağlayıcı	Kullanım	Kayıt	Notlar
Unsplash	Görsel arama	unsplash.com/oauth/applications	Secret Key değil, Access Key kullanır; denetlenmemiş bir demo uygulamasında saatte yaklaşık 50 istek, uygulamanız üretim için onaylandığında çok daha fazla
Pexels	Görsel ve video arama	pexels.com/api	Anahtar, istekten hemen sonra verilir
Pixabay	Görsel, video ve ses arama	pixabay.com/api/docs	Tek bir anahtar üç medya türünü de kapsar; günlük yerine dakikalık sınırla
Freesound	Ses arama	freesound.org/apiv2/apply	İstekte ham anahtar değeri olarak değil, bir jeton olarak gönderilir
Jamendo	Ses arama	devportal.jamendo.com	Ticari olmayan kullanım için ücretsiz
GIPHY	GIF'ler ve çıkartmalar	developers.giphy.com	Ayrıca Emoji, GIF ve çıkartmalar paneli tarafından da kullanılır

Her alanda bir Show/Hide geçişi ve satır içi kayıt yönergeleri vardır. Bir Test Keys eylemi, yapılandırılmış her anahtarı tek seferde denetler ve sağlayıcı başına bir başarılı/başarısız sonucu, hatalarda HTTP durum kodu dahil olmak üzere raporlar; böylece bozuk ya da süresi dolmuş bir anahtarı, yalnızca çalışmayan bir sağlayıcıdan ayırmak kolaydır.

Bilgi tabanı

Asistanın yerleşik tasarım tarifleri üzerindeki anlamsal aramayı destekleyen, isteğe bağlı bir Qdrant vektör veritabanı. O olmadan asistan, yerel anahtar kelime eşleştirmesine geri döner; bu da yine çalışır ama daha az kesindir.

Alan	Amaç
Qdrant URL	Qdrant Cloud (veya kendi sunucunuzda barındırılan) uç noktanız
Qdrant API anahtarı	O uç noktaya karşı kimlik doğrular
Gömme sağlayıcısı	OpenAI, Qwen, Google veya GLM
Gömme modeli	Seçilen sağlayıcıya bağlıdır
Gömme API anahtarı	İsteğe bağlı; AI sohbet sağlayıcı anahtarınızı yeniden kullanmak için boş bırakın

Save & Enable Qdrant aramasını açar, Seed Qdrant yerleşik tarif setini içine gönderir, Disable Qdrant ise bağlantı ayrıntılarını kaybetmeden yerel aramaya döner.

Beceri yöneticisi

AI Settings'in üstündeki Customize / Skills düğmesi beceri düzenleyicisini açar; burada AI becerileri, yani bir eğik çizgi komutuyla tetiklenen özel yönerge profilleri oluşturur ve atarsınız. Bunları nasıl oluşturacağınız ve kullanacağınız için bkz. AI becerileri.

Bir beceri, küçük bir klasör gibi yapılandırılmıştır: bir ana SKILL.md yönergesi ile becerinin yararlanabileceği, her biri kendi başlığı ve içeriği olan isteğe bağlı bir referans belgeleri seti.

Öğe	Ayrıntı
Yerleşik beceriler	Editörle birlikte gelir; adları, açıklamaları ve SKILL.md dosyaları salt okunurdur, ancak yine de sağlayıcılara atayabilirsiniz
My Skills	Sizin oluşturduğunuz her şey; SKILL.md, referanslar, simge ve açıklama dahil tamamen düzenlenebilir
Sağlayıcı ataması	Bir onay kutusu ızgarası, bir beceriyi bir veya daha fazla sağlayıcı için bağımsız olarak açmanızı sağlar; böylece farklı sağlayıcılar farklı beceriler çalıştırabilir
Eğik çizgi komutu	Her becerinin adı bir sohbet komutuna dönüştürülür (adı düzenledikçe canlı gösterilir), örneğin "Brand Voice" adlı bir beceri /brand-voice olur
Çoğaltma	Hem yerleşik hem özel becerilerde çalışır; orijinali kilitli kaldığı için yerleşik bir beceriyi düzenlemeye başlamanın yolu onu çoğaltmaktır

Bilgi tabanı bağlantı ayrıntıları

Bilgi tabanı bölümü (AI Settings'ten ayrı bir kenar çubuğu girişi), yukarıdaki tablodaki Qdrant URL'sinin, anahtarının ve gömme sağlayıcısının girilip kaydedildiği yerdir; Save & Enable, Seed Qdrant ve Disable Qdrant düğmelerinin hepsi o bölümde bulunur.

Adım adım

Bir AI sağlayıcı anahtarını uçtan uca bağlayın

1. Settings, ardından AI Settings bölümünü açın.
2. Bir sağlayıcı sekmesine (örneğin Qwen, DeepSeek veya Anthropic Claude) tıklayın.
3. Anahtarınızı API Key alanına yapıştırın, göster/gizle geçişini kullanarak iki kez kontrol edin, sonra kart ızgarasından bir model seçin (ya da Custom Endpoint'te bunun yerine bir Base URL ve Model Name girin).
4. İsteğe bağlı olarak General Settings altında bir sistem istemi, sıcaklık ve maksimum jeton değeri belirleyin.
5. Save Settings düğmesine, sonra bir sohbette güvenmeden önce anahtarın gerçekten çalıştığını doğrulamak için Test Connection düğmesine tıklayın.

Bir stok medya anahtarı ayarlayın ve doğrulayın

1. AI Settings'in aşağısındaki Stock Media API Keys kısmına kaydırın.
2. Yukarıda listelenen sağlayıcının sitesinde kaydolun ve verdiği anahtarı kopyalayın.
3. Onu eşleşen alana yapıştırın ve Save API Keys düğmesine tıklayın.
4. Test Keys düğmesine tıklayın; yapılandırılmış her sağlayıcı satır içinde OK ya da belirli bir HTTP hatası bildirir; böylece bir anahtarın düzeltilmesi gerekip gerekmediğini hemen anlarsınız.

Özel bir AI becerisi oluşturun ve tetikleyin

1. AI Settings'in üstündeki Customize / Skills düğmesine tıklayın.
2. New Skill düğmesine tıklayın, ona bir ad ve açıklama verin ve bir simge seçin.
3. Yönergelerinizi SKILL.md düzenleyicisine yazın; beceri, ana yönergenin ötesinde destekleyici materyale ihtiyaç duyuyorsa dosya ağacından bir veya daha fazla referans belgesi ekleyin.
4. Provider Assignment ızgarasında becerinin kullanılabilir olmasını istediğiniz sağlayıcıları işaretleyin, sonra kaydedin.
5. AI sohbetinde, tetiklemek için becerinin eğik çizgi komutunu (düzenleyicinin altındaki önizlemede gösterilir) yazın.

Qdrant bilgi tabanını açın

1. Settings, ardından Knowledge Base bölümünü açın.
2. Qdrant URL'nizi ve API anahtarınızı girin, bir gömme sağlayıcısı ve modeli seçin, isteğe bağlı olarak ayrı bir gömme API anahtarı belirleyin (AI sohbet sağlayıcı anahtarınızı yeniden kullanmak için boş bırakın).
3. Save & Enable düğmesine, sonra yerleşik tarif setini içine göndermek için Seed Qdrant düğmesine tıklayın.
4. Yerel anahtar kelime eşleştirmesine geri dönmek isterseniz Disable Qdrant düğmesine tıklayın; bağlantı ayrıntılarınız saklanır, bu yüzden daha sonra yeniden etkinleştirmek onları tekrar girmeyi gerektirmez.

Sık yapılan işler

İş	Adımlar
Diğer anahtarları kaybetmeden etkin sağlayıcıyı değiştir	Farklı bir sağlayıcı sekmesine tıklayın ve kaydedin; her sağlayıcının anahtarı bağımsız olarak saklanır
Bir beceriyi yalnızca en hızlı sağlayıcınıza ver	O becerinin Provider Assignment ızgarasında diğer her sağlayıcı için işareti kaldırın
Yerleşik bir beceriyi düzenlemeye başla	Onu açın, Duplicate düğmesine tıklayın, sonra My Skills içindeki kopyayı düzenleyin
Bir Custom Endpoint'in gerçekten çalıştığını doğrula	Kontrol edilecek bir model listesi olmadığından, kaydettikten sonra yalnızca Test Connection'a güvenmek yerine gerçek bir sohbet mesajı gönderin
Bir bilgi tabanı bağlantısını, içine gönderilen tarifleri kaybetmeden serbest bırak	URL ve anahtar alanlarını temizlemek yerine Disable Qdrant düğmesini kullanın

Sorun giderme

Eksik bir anahtar sessiz bir hata değil, bir uyarı gösterir

Her iki stok arama paneli ve GIF/çıkartma öğeleri paneli, gerekli bir anahtar eksik olduğunda boş sonuç döndürmek yerine, Settings'e geri bağlantı veren açık bir "anahtarınızı ekleyin" mesajı gösterir.

Test Keys sağlayıcı başına HTTP durumunu bildirir

Başarısız bir test, o sağlayıcının döndürdüğü gerçek HTTP durum kodunu gösterir (örneğin bozuk bir anahtar için 401, hız sınırlaması için 429); böylece bir yazım hatasını geçici bir sağlayıcı kesintisinden ayırt edebilirsiniz.

Yerleşik beceriler yerinde düzenlenemez veya silinemez

Adları, açıklamaları ve SKILL.md alanları salt okunurdur ve bir silme düğmesi yoktur. My Skills içinde düzenlenebilir, silinebilir bir kopya elde etmek için önce yerleşik bir beceriyi çoğaltın.

İpuçları

Sohbet ve stok anahtarlarını ayrı tutun

AI sağlayıcı anahtarı konuşmayı ve üretimi yürütür; stok medya anahtarları yalnızca Media sekmesindeki aramayı besler. Birini ayarlamak diğerini yapılandırmaz.

Güvenmeden önce test edin

Sağlayıcı API'leri, zamanla anahtar biçimlerini ve hız sınırlarını değiştirir. Bir yazım hatasını tasarımın ortasında keşfetmek yerine, bir anahtarı yapıştırdıktan sonra Test Connection veya Test Keys'i çalıştırın.

İlgili

• Her sağlayıcının neyi desteklediği için AI sohbet asistanı
• Özel becerileri oluşturmak ve tetiklemek için AI becerileri
• Stok anahtarlarının neyin kilidini açtığı için Medya kütüphanesi ve stok içerik
• Settings ekranının geri kalanı için Editör ayarları