Bir sağlayıcı bağlama

AI Studio, Settings, AI Settings altındaki Provider & Model sekmesinden bağlanan kendi sağlayıcı anahtarınız üzerinde çalışır. Sohbet edebilmek veya üretim yapabilmek için önce en az bir sağlayıcı bağlayın. Bunun ardındaki fikir için bkz. Kendi AI anahtarını getir.

Kısa özet

1. Settings, AI Settings'i açın ve bir sağlayıcı sekmesi seçin.
2. API anahtarınızı yapıştırın.
3. O sağlayıcının listesinden bir model seçin.
4. Bir muhakeme çabası ayarlayın, isteğe bağlı olarak bir sistem istemi, sıcaklık ve maksimum belirteç sayısı belirleyin.
5. Bağlantıyı test edin, ardından sağlayıcıyı sohbet için açın.

Kurulum akışı

Her sağlayıcı için adımlar aynı üç alan, artı isteğe bağlı gelişmiş ayarlardır.

Adım	Ayrıntı
API anahtarı	Parola maskeli bir alan. Kaydedildikten sonra yalnızca kısa bir ipucu olarak gösterilir, asla tam değer olarak değil
Model	O sağlayıcının kullanılabilir modellerinin bir açılır menüsü
Muhakeme çabası	Sağlayıcıya özgü bir düzey kümesi, yalnızca sohbet yeteneğine sahip sağlayıcılar için gösterilir
Test	Ona güvenmeden önce anahtarın çalıştığını doğrulamak için küçük bir istek gönderir
Sohbet için kullan	Bunu sohbet için etkin sağlayıcı yapan bir anahtar

Muhakeme çabası seçenekleri sağlayıcıya göre farklılık gösterir, örneğin Default, Low, Medium, High ve daha derin muhakemeyi destekleyen sağlayıcılarda bazen Extra High veya Max; bu yeteneğe sahip olmayan bir sağlayıcı, kontrolü tümüyle atlar. Değer, o sağlayıcıdaki her sohbet isteğine otomatik olarak uygulanır, bestecide mesaj başına bir geçiş yoktur.

Ayarlar ekranına bir bakış

Provider & Model sekmesi, solda her sağlayıcının bir listesini gösterir. Bir kalkan simgesi, zaten kaydedilmiş bir anahtarı olan her sağlayıcıyı işaretler ve şu anda sohbeti çalıştıran sağlayıcı Active olarak etiketlenir. Üstteki bir özet şeridi her zaman sohbetin şu anda hangi sağlayıcıyı ve modeli kullandığını ve bir anahtarın bağlı olup olmadığını söyler, böylece bir panel açmadan kurulumunuzu doğrulayabilirsiniz.

O listedeki bir sağlayıcıya tıklayarak panelini sağda açın, üç numaralı adım halinde düzenlenmiştir:

1. API Key, maskeli bir alan. Kaydettikten sonra bir Change düğmesine ve bir sil (çöp kutusu) kontrolüne daralır ve bir daha asla tam anahtarı göstermez.
2. Model, o sağlayıcının modellerinin bir açılır menüsü, mantıklı varsayılan recommended olarak işaretlidir.
3. Try it, Test connection düğmesi.

Sağlayıcı ayarlanabilir muhakemeyi destekliyorsa, Adım 2 ile Adım 3 arasında küçük bir satır içi Reasoning açılır menüsü bulunur. Üç adımın altında, ince ayarları tutan bir Advanced (optional) akordeonu vardır. Bir sağlayıcıyı sohbet için açmak, Use for chat anahtarıdır: o sağlayıcı etkin olanken bunu doğrudan kapatamazsınız, bunun yerine farklı bir sağlayıcıyı açarsınız, bu da Active etiketini otomatik olarak ona devreder.

Gelişmiş seçenekler

İsteğe bağlı, daraltılmış bir bölüm daha ince kontrol ekler.

Ayar	Aralık	Notlar
Sistem istemi	Serbest metin	Her yanıtın altına katmanlanan özel talimatlar
Sıcaklık	0 ile 1.5	Kaydırıcıyı hareket ettirdikçe Precise, Balanced veya Creative olarak etiketlenir
Maksimum belirteç	256 ile 16384	Varsayılan 2048. Tek bir yanıtın ne kadar uzun olabileceğini sınırlar

Her gelişmiş alan, üzerinden ayrıldığınız anda (odak kaybında) kendi başına kaydedilir, küçük bir onay bildirimiyle, dolayısıyla bu üçü için ayrı bir Kaydet düğmesi yoktur. Bağlandıktan sonra anahtarınız maskeli gösterilir ve onu istediğiniz zaman değiştirebilir veya silebilirsiniz. Aynı anda istediğiniz kadar sağlayıcı bağlayabilirsiniz, her biri kendi anahtarını, modelini ve muhakeme çabasını bağımsız olarak tutar, dolayısıyla hangisinin etkin olduğunu değiştirdiğinizde yeniden yapılandıracak bir şey olmaz.

Sağlayıcıya göre muhakeme çabası düzeyleri

Tam düzey kümesi sağlayıcıya göre farklılık gösterir, bazıları diğerlerinden daha ileri gider.

Sağlayıcı	Düzeyler
OpenAI	Default, Off, Low, Medium, High, Extra High
Anthropic Claude	Default, Low, Medium, High, Extra High, Max
DeepSeek	Default, Off, High, Max (Low veya Medium kademesi yok)
Qwen	Default (kapalı, önerilen), Low, Medium, High
Kimi	Default, Off, On (basit bir açık ya da kapalı, kademeli düzey yok)
GLM	Default, Off, On; üst düzey bir GLM modeli ayrıca temel açık ya da kapalının üstüne Low, High ve Max kilidini açar
Google Gemini	Default, Minimal, Low, Medium, High

Ayarlanabilir çabayı desteklemeyen, muhakeme kontrolü hiç olmayan bir sağlayıcı bu alanı basitçe atlar.

Adım adım

Ekran her sağlayıcı için aynı görünür, dolayısıyla bir kez yaptığınızda gerisi hızlı olur. Bu adım adım anlatımlar tam tıklamaları ve konumları kullanır.

Bir OpenAI anahtarı bağlayın ve sohbete hazırlanın

1. Settings, AI Settings'i açın ve Provider & Model sekmesinde kalın.
2. Soldaki sağlayıcı listesinde OpenAI'a tıklayın. Paneli sağda açılır.
3. Step 1, API Key altında anahtarınızı maskeli alana yapıştırın. Henüz bir anahtarınız yoksa, sağlayıcının adının yanındaki küçük harici bağlantıyı kullanarak OpenAI'ın kendi geliştirici konsolunu açın ve API keys sayfasında bir anahtar oluşturun, ardından geri dönüp yapıştırın. Save düğmesine tıklayın.
4. Step 2, Model altında açılır menüden bir model seçin veya zaten recommended olarak işaretli olanı bırakın.
5. Step 2 ile Step 3 arasında bir Reasoning açılır menüsü görünürse, bir düzey seçin veya Default olarak bırakın.
6. Step 3, Try it altında Test connection düğmesine tıklayın ve "Connection successful, key is valid." mesajını bekleyin.
7. OpenAI zaten Active olarak etiketli değilse Use for chat anahtarını açın. Bu, onu sohbetin kullandığı sağlayıcı yapar.
8. İsteğe bağlı: Asistan talimatları (bir sistem istemi) eklemek, Yaratıcılığı (sıcaklık) ayarlamak veya Maksimum yanıt uzunluğunu sınırlamak için Advanced (optional) akordeonunu açın. Bu alanların her biri, üzerinden ayrıldığınızda kendi başına kaydedilir, dolayısıyla basacak başka bir şey yoktur.

fal.ai gibi yalnızca video sağlayan bir sağlayıcıyı kurun

1. Settings, AI Settings, Provider & Model sekmesini açın ve soldaki listede fal.ai'a tıklayın.
2. fal.ai anahtarınızı (iki nokta üst üste ile birleştirilmiş bir anahtar kimliği ve gizli anahtar biçiminde) API Key alanına yapıştırın ve Save düğmesine tıklayın. Onu, sağlayıcı adının yanındaki harici bağlantıdan ulaşılan fal.ai kontrol panelinin Keys sayfasından alırsınız.
3. Burada bir model açılır menüsü ve bir Use for chat anahtarı olmadığına dikkat edin. fal.ai bir üretim motorudur, dolayısıyla kartı bunun yerine bir Video engine rozeti gösterir ve gerçek modelin daha sonra, üretim zamanında seçildiğini açıklar.
4. Test düğmesine tıklamak, onu gerçekten doğrulamak yerine "Key saved (this provider has no live test)" döndürür, çünkü bu sağlayıcının pingleyecek ucuz bir uç noktası yoktur. Bu bir hata değil, beklenen bir durumdur.
5. Modeli üretim yaparken seçin: bestecinin Video modunda (Seedance 2.0, Seedance 2.0 Fast, Veo 3.1, Veo 3.1 Fast veya Kling 2.6) ya da Marketing Studio içinde. Modun kontrolleri için bkz. Video üretme. BytePlus da aynı şekilde çalışır, bir Video + image engine rozetiyle ve modelini yine üretim zamanında seçer.

Diğer anahtarlarınızı kaybetmeden etkin sohbet sağlayıcınızı değiştirin

1. Settings, AI Settings, Provider & Model sekmesini açın.
2. Soldaki listede, bir kalkan simgesiyle gösterilen, zaten kaydedilmiş bir anahtarı olan farklı bir sağlayıcıya tıklayın.
3. Onun Use for chat anahtarını açın. Hemen Active sohbet sağlayıcısı olur ve önceki, Active etiketini kendiliğinden kaybeder (eskisini asla elle kapatmazsınız).

Diğer her sağlayıcı anahtarını, seçtiği modeli ve muhakeme düzeyini kaydedilmiş olarak tutar, dolayısıyla daha sonra geri geçmek hiçbir yeniden yapılandırma gerektirmez. Hangisinin etkin olduğunu değiştirerek bağladığınız hiçbir şey kaybolmaz.

Kendi sunucunuzda barındırılan veya OpenAI uyumlu özel bir uç noktayı bağlayın

1. Settings, AI Settings, Provider & Model sekmesini açın ve listede Custom Endpoint'e tıklayın.
2. Sabit bir model açılır menüsünden seçmek yerine bir Base URL ve bir Model Name girin.
3. Burada canlı bir Test connection yoktur: düğme alanında bunun yerine "No test for a custom provider, try it in chat" yazar. Çalıştığını doğrulamak için sohbette bir mesaj gönderin.
4. Etkinleştirmek için Use for chat'i açın.

Özel bir uç nokta, anahtarı sunucuda şifrelenmeyen ve proxy'lenmeyen tek sağlayıcıdır, çünkü yönlendirilecek sabit bir ana bilgisayar yoktur. Anahtarı tarayıcınızda kalır ve istekler doğrudan tarayıcıdan yazdığınız Base URL'e gider, dolayısıyla yalnızca güvendiğiniz bir uç noktayı kullanın. Bu, aşağıda Özel uç nokta altında belirtilen davranışın aynısıdır.

Anahtarlarınız güvende

Anahtarlar sunucuda saklanır

Anahtarınız sunucuda beklerken şifrelenir ve asla tarayıcıya geri gönderilmez. Her sağlayıcı çağrısı sizin adınıza sunucudan yapılır, dolayısıyla sayfanın kendisi gerçek anahtarınızı asla tutmaz, yerinde yalnızca bir yer tutucu bulunur.

Her sağlayıcı canlı test edilemez

Test Connection çoğu sağlayıcı için gerçek bir istek yapar. Yalnızca video sağlayan birkaç sağlayıcı, canlı bir test için uygun bir uç nokta sunmaz, dolayısıyla oradaki anahtarı kaydetmek, çalıştığını değil yalnızca saklandığını doğrular.

Hangi sağlayıcılar

Farklı sağlayıcılar farklı şeyleri destekler: bazıları yalnızca sohbeti çalıştırır, bazıları yalnızca görsel veya video üretir, birkaçı da ikisini birden yapar. Moda göre tam dökümü için bkz. Sağlayıcı ve model matrisi.

Özel uç nokta

Sağlayıcınız OpenAI uyumlu sohbet tamamlama biçimini konuşuyorsa, sabit bir listeden seçmek yerine bir Base URL ve bir Model Name vererek onu bir Custom Endpoint olarak bağlayın. Bu, kendi sunucunuzda barındırılan bir modeli veya daha az yaygın bir sağlayıcıyı kullanmanın yoludur.

Özel uç noktalar sunucu proxy'sini atlar

Adlandırılmış sağlayıcılar sunucudan çağrılır, dolayısıyla tarayıcınız onlarla asla doğrudan konuşmaz. Özel bir uç nokta tek istisnadır: keyfi bir URL için yerleşik bir proxy yolu olmadığından, ona giden istekler doğrudan tarayıcınızdan sağladığınız adrese gönderilir ve anahtarı sunucuda şifrelenmek yerine tarayıcıda kalır.

Bir anahtarı değiştirme veya kaldırma

Eskisinin üzerine yeni bir anahtar yapıştırmak veya onu tümüyle silmek için istediğiniz zaman aynı sağlayıcı sekmesine dönün. Bir anahtarı silmek, onunla zaten kullandığınız modelleri veya konuşmaları silmez, yalnızca yeniden bir anahtar ekleyene kadar o sağlayıcının kullanılabilir olmasını durdurur. Sildiğiniz sağlayıcı etkin sohbet sağlayıcısıysa, sohbete geri dönmeden önce bağlı farklı bir sağlayıcıyı açın.

Bir anahtar çalışmazsa

Başarısız bir Test Connection neredeyse her zaman birkaç şeyden birini gösterir: anahtar yanlış yazılmıştır veya sonunda boşluk vardır, anahtar aynı şirketin farklı bir ürününe aittir ya da anahtarın arkasındaki hesabın sağlayıcının kendi tarafında henüz kotası veya faturalandırması ayarlanmamıştır. Sağlayıcı tarafından döndürülen hata mesajı olduğu gibi gösterilir, dolayısıyla uygulamanın hatalı olduğunu varsaymadan önce onu kontrol edin.

Sorun giderme

Muhakeme çabası yeni bir tarayıcıda veya cihazda sıfırlanır

Şifrelenip sunucuda saklandığı için oturum açtığınız her cihaza sizi takip eden API anahtarınızın aksine, sağlayıcı başına seçtiğiniz muhakeme çabası düzeyi yalnızca geçerli tarayıcının yerel deposunda kaydedilir. Farklı bir tarayıcıya, farklı bir bilgisayara veya özel bir pencereye taşınmaz, orada yeniden Default değerinde başlar. Makine değiştirdikten sonra yanıtlarınız aniden daha yüzeysel geliyorsa, muhakeme düzeyini orada yeniden seçin. Anahtarınız, modeliniz ve gelişmiş ayarlarınız etkilenmez, yalnızca muhakeme düzeyi tarayıcıya özeldir.

Her Test connection mesajının anlamı

Test connection, ham bir sağlayıcı hatasını kısa, sade bir mesaja eşler ve hesap başına dakikada 10 testle sınırlanır.

Mesaj	Ne anlama gelir
Connection successful, key is valid.	Anahtar çalıştı ve sağlayıcı yanıt verdi.
Key saved (this provider has no live test)	fal.ai ve BytePlus'ın pingleyecek ucuz bir uç noktası yoktur, dolayısıyla yalnızca anahtarın kaydedildiği doğrulanır.
No test for a custom provider, try it in chat	Özel bir uç noktanın test eylemi yoktur; kontrol etmek için bir sohbet mesajı gönderin.
Key is invalid, you may have copied it incompletely	Sağlayıcı anahtarı reddetti (401 veya 403 türü bir hata). Onu tam olarak yeniden kopyalayın.
Provider is busy (429), try again shortly	Sağlayıcı bir hız sınırı (429) döndürdü. Bir an bekleyip yeniden deneyin.
Could not reach the provider (network/CORS)	Bir ağ veya CORS hatası, isteğin ulaşmasını engelledi.
Save your key first.	Test edilecek henüz kaydedilmiş bir anahtar yok.
Too many tests, try again in a minute.	Bir dakikada 10 testi aştınız; kısaca durup yeniden deneyin.

Bir anahtarı silmek, yaptıklarınızı kaldırmaz

Bir sağlayıcının anahtarını kaldırmak, yalnızca ona yeni istekleri durdurur. Ürettiğiniz görsellerin ve kliplerin galerisi ve zaten yaptığınız konuşmalar yerinde kalır. Tam adımlar için yukarıdaki Bir anahtarı değiştirme veya kaldırma bölümüne bakın.

İlgili

• Kendi AI anahtarını getir
• Sağlayıcı ve model matrisi
• AI sohbetini kullanma
• AI sohbet asistanı, aynı kurulumun editör içi sürümü için