Kendi model anahtarınızı bağlayın

Bağlantı bilgilerini hazırlayın

Çağırmayı planladığınız hizmetten alınmış bir API anahtarına, hizmetin API temel URL’sine, kullanılabilir bir model ID’sine ve uyumlu bir protokole veya ön ayara ihtiyacınız vardır. Bir tüketici sohbet sitesindeki hesap, tek başına API erişimi veya API kredisi sağlamaz.

Free dâhil her plan BYOK’u destekler. Sağlayıcı anahtarınız, OpenDesign bakiyesi yerine ilgili sağlayıcının faturalandırmasını ve kullanım hakkını kullanır.

Sağlayıcıyı ekleyin

1. Settings → Models & providers → API providers bölümünü açın.
2. Anahtarınızı veren hizmete ait ön ayarı seçin. Custom provider için ilgili hizmetin belgelerinde belirtilen protokolü kullanın.
3. API Key alanına yalnızca gizli anahtarı yapıştırın. Bearer, tırnak işareti veya JSON yapılandırma sarmalayıcısı eklemeyin.
4. Base URL değerini kontrol edin. Ön ayardaki adres kilitliyse başka bir uç nokta girmeden önce özel URL seçeneğini kullanın.
5. Kullanılabilir listeden bir model seçin veya Custom altında tam API model ID’sini girin. Modellerin yüklenmesi hizmete ve hesaba bağlıdır.
6. Test işlemini çalıştırın. Yanıtını okuyun: Başarılı bir test, tüm araçları, medya modellerini veya gelecekteki istekleri değil, bu küçük isteği doğrular.
7. Kaydedildi onayını bekleyin. Sağlayıcıyı, adresi ve modeli kontrol etmek için ayarları yeniden açın; ardından projeye dönün ve küçük bir görev göndermeden önce bu bağlantıyı seçin.

Anahtarı gizli tutun. Yerel olarak incelemek için alanı Show ile görünür hâle getirebilirsiniz; ekran görüntüsü paylaşmadan önce anahtarı karartın.

Örnek: DeepSeek

DeepSeek Platform üzerinden bir anahtar oluşturun. Temel URL olarak https://api.deepseek.com kullanın ve hesabınızın çağırabildiği bir model seçin. Sağlayıcının güncel model listesindeki bir ID’yi kullanın; örneğin deepseek-flash; yüklü istemcinin ekran görüntüsünde hâlâ daha eski bir ön ayar diğer adı bulunuyor. Gerektiğinde güncel ID’yi özel model olarak girin. Yüklü 0.25.0 sürümündeki Get key kısayolu yanlış sağlayıcı sayfasını açabilir. İlgisiz bir OpenAI anahtarı oluşturmak yerine sağlayıcının kendi konsolunu kullanın.

Eski bir ekran görüntüsündeki görünen ad yerine güncel DeepSeek API belgelerinden tam ID’yi kopyalayın. Bu OpenAI protokolü örneğinde ayrı /anthropic uç noktasını kullanmayın.

Örnek: OpenRouter

OpenRouter anahtar ayarları üzerinden bir anahtar oluşturun. https://openrouter.ai/api/v1 kullanın. Sağlayıcı ön eki dâhil olmak üzere OpenRouter’ın kullanılabilir modeller listesinden bir model ID’si kopyalayın. Doğrudan Anthropic veya OpenAI anahtarını OpenRouter ön ayarına girmeyin. Anahtar, isteği alan ağ geçidine ait olmalıdır.

1. API providers bölümünde OpenRouter’ı seçin ve OpenRouter tarafından verilmiş bir anahtarı yapıştırın.
2. Base URL olarak https://openrouter.ai/api/v1 kullanın.
3. Sağlayıcı ön eki dâhil olmak üzere tam model ID’sini OpenRouter model dizininden kopyalayın.
4. Bağlantıyı test edin, kaydedilmesini bekleyin ve bir istek çalıştırmadan önce projede bu bağlantıyı seçin.

Başka bir sağlayıcıyı kontrol edin

Anahtar, yürütme ortamının tamamı değildir

BYOK görevleri, ajanın dosya ve araç işlemlerini gerçekleştiren desteklenen çalışma zamanına yine de ihtiyaç duyar. Uygulama çalışma zamanının kullanılamadığını bildirirse ilgili çalışma zamanının kurulum veya yeniden tarama talimatlarını izleyin. Anahtarı değiştirmek, yürütülebilir bir dosya yüklemez.

Faturalandırmayı anlayın

BYOK istekleri, girdiğiniz anahtarın ait olduğu sağlayıcı veya ağ geçidi tarafından faturalandırılır. OpenDesign aboneliği ile harici sağlayıcının bakiyesi birbirinden ayrıdır. Geçerli bir anahtar hâlâ görev çalıştıramıyorsa faturalandırma ve bağlantı sorunlarını giderme bölümlerine bakın.

Test sonucunu okuyun ve sorunu giderin

Başarılı bir testten sonra mevcut projede küçük bir istek gönderin; yanıtı ve oluşturulan dosyaları inceleyin. Test başarılı olduğu hâlde dosya işlemleri başarısız olursa yürütme ortamı bölümünde açıklanan çalışma zamanını kontrol edin; çalışan bir anahtarı tekrar tekrar değiştirmeyin.