Factory Droid

~/.factory/settings.json içindeki özelModels girdisi — model, baseUrl ve provider — Droid'i Anthropic Messages veya OpenAI Chat Completions konuşan herhangi bir uç noktaya bağlar.

// ~/.factory/settings.json  (Windows: %USERPROFILE%\.factory\settings.json)
{
  "customModels": [
    {
      "model": "claude-sonnet-5",
      "displayName": "Sonnet 5 [Kunavo]",
      "baseUrl": "https://api.kunavo.com",
      "apiKey": "${KUNAVO_API_KEY}",
      "provider": "anthropic"
    },
    {
      "model": "gpt-5-6-sol",
      "displayName": "GPT-5.6 Sol [Kunavo]",
      "baseUrl": "https://api.kunavo.com/v1",
      "apiKey": "${KUNAVO_API_KEY}",
      "provider": "generic-chat-completion-api"
    }
  ]
}

// Then, in the shell Droid starts from:
//   export KUNAVO_API_KEY=sk-kn-...
// ${VAR_NAME} expansion is a settings.json feature. It does NOT apply to the
// legacy ~/.factory/config.json, which Factory still loads and merges.

Adım adım

1. /app/keys adresinden bir anahtar oluşturup kopyalayın — yalnızca bir kez gösterilir. Anahtarın kendisi ayarlar dosyasına yazılmasın diye Droid'i başlattığınız kabukta KUNAVO_API_KEY olarak dışa aktarın.
2. ~/.factory/settings.json dosyasını açın (yoksa oluşturun) ve yukarıdaki customModels dizisini ekleyin. Factory yalnızca üç alanı zorunlu olarak işaretliyor: model, baseUrl ve provider. displayName, seçicide gösterilen etikettir.
3. provider yazımını kontrol edin. Değer tam olarak anthropic, openai veya generic-chat-completion-api olmalıdır; Factory'nin sorun giderme bölümü, "Invalid provider" hatasının nedeni olarak buradaki yazım yanlışını belirtiyor.
4. CLI'de /model komutunu çalıştırın. Girişleriniz Factory'nin kendi modellerinin altında, belirlediğiniz displayName ile etiketlenmiş ayrı bir Özel modeller bölümünde görünür. Factory ayarlar dosyasını izlediğinden kaydetmeniz yeterlidir; yeniden başlatmanız gerekmez.
5. Bir selamlama yerine dosya okuyup düzenleyen bir görev verin. Droid, yaptığı işlerin neredeyse tamamında araç çağrısına dayanır; basit bir sohbet turunun sınamayacağı kısım budur. Ardından /cost komutunu çalıştırın; Factory önbellek isabet oranlarını burada bildirir. Kunavo, Anthropic'in cache_control işaretleyicilerini doğrudan sunar. Factory'nin kendi notuna göre genel Chat Completions sağlayıcısında önbelleğe alma “sağlayıcıya göre değişir ve garanti edilemez”.

Factory Özel Modeller (BYOK) sayfası ile 21 Eylül 2026 tarihinde kontrol edilmiştir. Üçüncü taraf ayarları değişebilir; buradaki alan adı gördüğünüzle artık eşleşmiyorsa yetkili kaynak bu sayfa değil, ilgili sayfadır.

İstemcide hata ayıklamadan önce doğrulayın

Tek bir istek, hatanın uç noktadan mı, anahtardan mı yoksa yapılandırma dosyasından mı kaynaklandığını kesinleştirir. Bu JSON döndürürse aynı temel URL ve anahtar Factory Droid içinde çalışır.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/messages \
  -H "Authorization: Bearer sk-kn-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'

Alana hangi model kimliği yazılmalı

Her metin modeline model kimliğiyle erişilebilir — güncel liste GET /v1/models, fiyatları içeren katalog ise modeller sayfasında. Ücretler 1 milyon token başına USD cinsindendir; giriş / çıkış.

Droid'deki özel bir model neleri kapsamaz?

Üç sınır Factory'nin kendi sayfalarında belirtiliyor ve her biri, yukarıdaki yapılandırmanın çalışıp çalışmadığından ziyade ondan ne beklemeniz gerektiğini değiştiriyor.

• Yalnızca yerel arayüzlerde kullanılabilir. Factory'nin BYOK sayfasına göre özel modeller, yerel settings.json dosyanızı okuyan Droid CLI ve masaüstü uygulamasında kullanılabilir; “Factory'nin barındırdığı web veya mobil platformlarda görünmez”. Barındırılan ürün üzerinden devredilen işler, burada hangi anahtarı yapılandırmış olursanız olun Factory'nin faturalandırdığı çıkarım hizmetinde çalışmaya devam eder.
• Yönetici bu özelliği kapatabilir. Factory'nin kurumsal denetimler belgelerinde modelPolicy.allowCustomModels ve allowedBaseUrls açıklanıyor. Bunlar kullanıcıların BYOK kullanmasını tamamen devre dışı bırakır veya her özel modeli onaylanmış tek bir sunucuya sabitler. Yönetilen bir makinede dosyada sorun aramadan önce bunu kontrol edin.
• Plan ücreti devam eder. Buradaki anahtar, Factory'nin BYOK kotasının yerine geçmez; ona eklenir. Factory'nin BYOK kotasını aşan kullanım için ne kadar ücret aldığı ve kotanın ne olduğu maliyet kılavuzunun konusudur; bu sayfada yeniden hesaplanmıyor.

Başka bir yerden yapılandırma kopyalamadan önce bilmeniz gereken bir tuzak: Factory, eski ~/.factory/config.json dosyasını settings.json altına birleştirerek, snake_case biçimindeki custom_models ve base_url alanlarıyla yüklemeye devam ediyor; ayrıca ${VAR_NAME} genişletmesinin burada geçerli olmadığını belgeliyor. Bu dosyaya yer tutucu olarak yazılmış bir anahtar olduğu gibi gönderilir. settings.json kullanın.