Factory Droid + JoinGonka Gateway: Gonka ağ modellerinde BYOK

1. Adım: Droid'i kur. Factory belgelerindeki resmî yollar:

# macOS and Linux\ncurl -fsSL https://app.factory.ai/cli | sh\n\n# Homebrew\nbrew install --cask droid\n\n# Windows (PowerShell)\nirm https://app.factory.ai/cli/windows | iex\n\n# via npm\nnpm install -g droid

Betik, ikili dosyayı ~/.local/bin içine koyar ve dizini PATH'e nasıl ekleyeceğini söyler; Linux'ta belgeler ayrıca xdg-utils paketini kurmanı ister. Kontrol — droid --version.

2. Adım: anahtar al. gate.joingonka.ai/register adresinden kaydol, adresini doğrula ve „API anahtarları“ bölümünde jg- önekli bir anahtar oluştur. Tek anahtar ve tek bakiye, ağdaki tüm modeller için geçerlidir.

3. Adım: kurulum betiğini çalıştır.

npx @joingonka/setup --tool droid

Kurulum betiği anahtarı sorar — komut satırı argümanı olarak iletilmez, böylece kabuk geçmişine düşmez — ve dört şey yapar:

• ~/.factory/settings.json dosyasının (Windows'ta %USERPROFILE%\.factory\settings.json) customModels dizisine ağdaki her model için bir kayıt ekler: ağ geçidi adresi, sağlayıcı tipi generic-chat-completion-api, anahtar düz metin olarak, gerçek bağlam penceresi ve yanıt üst sınırı; dosya 600 izinlerini alır;
• Varsayılan modeli — sessionDefaultSettings.model — DeepSeek V4 Flash olarak ayarlar, ama yalnızca hiç model seçilmemişse ya da seçili model ağdan çıkmış bir modeli gösteriyorsa. Factory kataloğundan bir modeli veya başkasının BYOK kaydını ele geçirmez, nasıl geçiş yapacağını söyler;
• Önceki dosyanın bir kopyasını saklar; customModels içindeki başka kayıtlara, diğer ayarlara ve yorumlara dokunmaz; ayrıştırılamayan bir dosyanın üzerine yazmaz, neyin düzeltilmesi gerektiğini söyler;
• Sonunda ağ geçidine canlı bir istek gönderir ve anahtarın, adresin ve modelin kabul edilip edilmediğini doğrudan söyler.

Başka bir varsayılan modeli --model bayrağı deepseek, glm veya minimax kısaltmasıyla belirler — açıkça belirtilen model her zaman yazılır. Dotfile'lar ve sunucular için soru sormayan bir mod var; bu modda anahtar ortam değişkeninden alınır:

JOINGONKA_API_KEY=jg-your-key npx @joingonka/setup --tool droid --model glm --non-interactive

Droid'i yeniden başlatmak gerekmez: settings.json değişikliklerini kendisi fark eder. Sonundaki 429 yanıtlı ! Could not verify right now satırı, yapılandırma hatası değil meşgul bir model anlamına gelir — yapılandırma çoktan yazılmıştır.

Yükleyicinin yaptığı her şeyi elle de yazabilirsiniz. Droid'in kullanıcı ayarları ~/.factory/settings.json dosyasında tutulur; dosya yoksa Droid onu ilk çalıştırmada oluşturur. Gonka ağı için customModels dizisi ve varsayılan bir model gerekir:

{
  "customModels": [
    {
      "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
      "id": "custom:deepseek-ai/DeepSeek-V4-Flash-0731",
      "displayName": "DeepSeek V4 Flash (Gonka)",
      "baseUrl": "https://gate.joingonka.ai/v1",
      "apiKey": "jg-your-key",
      "provider": "generic-chat-completion-api",
      "maxOutputTokens": 32768,
      "maxContextLimit": 380000,
      "noImageSupport": true
    },
    {
      "model": "zai-org/GLM-5.3-Flash",
      "id": "custom:zai-org/GLM-5.3-Flash",
      "displayName": "GLM 5.3 Flash (Gonka)",
      "baseUrl": "https://gate.joingonka.ai/v1",
      "apiKey": "jg-your-key",
      "provider": "generic-chat-completion-api",
      "maxOutputTokens": 8192,
      "maxContextLimit": 390000,
      "noImageSupport": true
    },
    {
      "model": "MiniMaxAI/MiniMax-M2.7",
      "id": "custom:MiniMaxAI/MiniMax-M2.7",
      "displayName": "MiniMax M2.7 (Gonka)",
      "baseUrl": "https://gate.joingonka.ai/v1",
      "apiKey": "jg-your-key",
      "provider": "generic-chat-completion-api",
      "maxOutputTokens": 8192,
      "maxContextLimit": 200000,
      "noImageSupport": true
    }
  ],
  "sessionDefaultSettings": {
    "model": "custom:deepseek-ai/DeepSeek-V4-Flash-0731"
  }
}

Varsayılan model sessionDefaultSettings.model içinde saklanır ve kayda id'si üzerinden başvurur. Factory dokümantasyonu dosyanın kökünde bir de model anahtarından söz eder, ancak bizim denememizde droid exec, -m bayrağı olmadan modeli tam da sessionDefaultSettings içinden aldı — değer değiştirildikten sonra da öyle yaptı.

Anahtar dosyada düz metin olarak durur: dosyayı chmod 600 ~/.factory/settings.json komutuyla koruyun ve anahtar içeren kayıtları projenin .factory/settings.json dosyasına taşımayın — o dosya genellikle depoya dahil olur. Droid başlatıldıktan sonra dosya farklı görünüyorsa bu normaldir: herhangi bir ayarı kaydederken Droid dosyayı baştan yazar — anahtarları sıralar, kayıtlara index alanını ekler ve yorumları saklamaz. 600 izinleri bu sırada korunur ve yükleyici bu tür kayıtları sorunsuz günceller.

Droid kendi kayıtlarını katalogdan ayrı gösterir: belgelere göre etkileşimli modda /model komutu bunları Custom models bölümünde listeler, Ctrl+N ise doğrudan giriş alanında modeller arasında geçiş yapar. Tek seferlik modda modeli id alanındaki değerle birlikte -m bayrağı belirler, eğik çizgiler olduğu gibi yazılır: droid exec -m custom:zai-org/GLM-5.3-Flash "…".

İsmi yanlış yazarsanız Droid Invalid model yanıtını verir ve gördüğü tüm modelleri listeler – kendi kayıtlarınız da custom:… (display name) biçiminde görünür: böylece kayıtların yüklendiğini de anlarsınız. Factory belgelerindeki tarzda, etiket ve numaradan oluşan bir isim (custom:DeepSeek-V4-Flash-(Gonka)-0) açık id varken işe yaramaz – bizim denememizde aynı Invalid model sonucunu verdi.

Factory hesabı nerede gerekiyor. Kendi modelleriniz token ödeme sorununu ortadan kaldırır, ama ürünün kendisine girişi değil. Droid 0.225.1 ile hesaba giriş yapmadan yaptığımız denemede şunlar görüldü:

Arayüzde çalışmak için bir Factory hesabı açın ve tarayıcı üzerinden giriş yapın – Login seçeneği ya da /login komutu; tarayıcısı olmayan bir makinede belgeler, hesap ayarlarından alınan bir anahtarı FACTORY_API_KEY değişkenine koymayı önerir. droid exec'in girişsiz çalışması denemek için pratiktir, ama resmî olarak belgelenmemiştir – CI'da buna güvenmeyin. Factory'nin fiyatlandırma sayfasına göre BYOK, ücretsiz limitli tüm bireysel planlara dahildir ve limitin üzerindeki BYOK kullanımı planın koşullarına göre ücretlendirilir; güncel koşullar factory.ai/pricing adresinde. Ağdaki modellerin token'ları ise ayrıca ödenir – JoinGonka bakiyesinden.

Hangi model seçilmeli. Ağdaki tüm modellerin fiyatı aynı, yani seçim davranışla ilgili. Tek bir görevde – bir dosyayı okuyup hatayı bulma – droid exec denememizde şöyle performans gösterdiler:

-r bayrağı (akıl yürütme düzeyi), Factory belgelerine göre BYOK modellerine uygulanmaz. Varsayılan olarak neden DeepSeek V4 Flash seçildiği model incelemesinde ele alınmıştır.

Boş bir dizine belirgin bir hata içeren calc.py dosyasını koyun — örneğin kenarların çarpılmak yerine toplandığı bir dikdörtgen alanı — ve Droid'den bunu bulmasını isteyin:

droid exec "Read the file calc.py in the current project directory and tell me in one sentence whether it has a bug."

Bayrak olmadan droid exec salt okunur modda çalışır: dosyalara bakılabilir, değiştirilemez. Ajan okuma aracını kendisi çağırır ve hatalı ifadeyi belirterek özünde yanıt verir. -o json bayrağıyla yanıt, betikle ayrıştırmaya uygun tek bir nesne olarak gelir (çıktı kısaltılmıştır):

{"type":"result","subtype":"success","is_error":false,"duration_ms":2239,"num_turns":2,
 "result":"Yes, the file has a bug: the rectangle area is computed as the sum of the side lengths, but it should be their product (width * height). …",
 "usage":{"input_tokens":19016,"output_tokens":146,"factory_credits":0,"ttft_ms":747}}

factory_credits: 0 alanı, işin Factory kredilerinde değil sizin modelinizde yürütüldüğünü doğrular. Ajanın dosyaları düzenleyebilmesi için bir özerklik seviyesi ekleyin: droid exec --auto low "Fix the bug in calc.py and change nothing else." — bizim çalıştırmamızda DeepSeek V4 Flash dosyayı okudu, toplamayı çarpmayla değiştirdi ve 12 yazdırıldığından emin olmak için betiği kendisi çalıştırdı.

Üçüncü kontrol ağ geçidi tarafında: panelde „Kullanım" bölümünde istek „Modellere göre" dağılımında görünür, „Anahtarlara göre" bloğunda ise son isteğin zamanı güncellenir.

Bir şeyler ters gittiyse Droid'in bir özelliğini unutmayın: konsolda droid exec yalnızca Error during droid execution: Exec failed yazar (JSON'da — "result":"Exec failed"), gerçek sebep ise günlükte kalır. Onu tek bir komutla çıkarabilirsiniz:

grep agent_error_count ~/.factory/logs/droid-log-single.log | grep -o '"errorMessage":"[^,]*' | tail -1

Ajan aracı, tokenleri sohbetten farklı harcar: Droid, her cümlenize bir sistem istemi, araç açıklamaları ve çalışma dizininin bir anlık görüntüsünü ekler ve görev birkaç adım sürer. Çalışmamızda, her adım sorunuzdan önce bile yaklaşık 9,5 bin giriş tokeni tüketti: "dosyayı oku ve hatayı bul" görevi iki adım ve yaklaşık 19 bin token, "düzelt ve kontrol et" ise dört adım ve yaklaşık 44 bin token harcadı. Bu nedenle, token başına maliyet burada belirleyicidir.

JoinGonka Gateway üzerinden tokenler girişte milyon başına $0.0069 ve çıkışta milyon başına $0.021 maliyetindedir; fiyat tüm ağ modelleri için aynıdır ve bu sayfaya canlı bir kaynaktan çekilir.

Sağ sütundaki tahminler Eylül 2026 fiyatlarına göredir. Karşılaştırma için, Droid'deki modeller için nasıl ödeme yapabileceğinize dair genel bir bakış:

Droid arayüzündeki /cost komutu oturum istatistiklerini gösterir; BYOK modelleri için kesin tüketim ve kalan bakiye ise ağ geçidi panelindeki "Kullanım" ve "Faturalandırma" bölümlerinden görülebilir. Droid için ayrı bir anahtar oluşturun — trafiği ayrı bir satır olarak görünecektir.

Özerklik. Tek seferlik modda Droid varsayılan olarak yalnızca okur; yetkileri seviyeler genişletir: --auto low — dosya düzenlemeleri, --auto medium — ayrıca bağımlılık kurulumu, derleme, testler ve yerel commit'ler, --auto high — push ve deploy'a kadar. --skip-permissions-unsafe bayrağı tüm denetimleri kaldırır — yalnızca tek kullanımlık konteynerler için. Etkileşimli modda seviyeyi Ctrl+L değiştirir, başlangıç seviyesini ise sessionDefaultSettings.autonomyLevel belirler; orada varsayılan olarak off — her şey onaylıdır.

Commit'lerde imza. includeCoAuthoredByDroid ayarı varsayılan olarak etkindir: Droid commit mesajlarına bir ortak yazar satırı ekler. Gerekmiyorsa settings.json dosyasına "includeCoAuthoredByDroid": false yazın.

Oturumlar nerede saklanır. Hesaba giriş yaptıktan sonra Droid varsayılan olarak CLI oturumlarını Factory'nin web sürümüne yansıtır — bundan cloudSessionSync sorumludur. BYOK anahtarları, belgelere göre yerel kalır; yazışmanın da makinede kalması gerekiyorsa "cloudSessionSync": false yapın. Ağ geçidi kendi tarafında prompt ve yanıt içeriklerini saklamaz — istatistiklerde yalnızca tüketim toplamları kalır.

Güncellemeler. Betikle kurulum kendini günceller; sürümü FACTORY_DROID_AUTO_UPDATE_ENABLED=false değişkeniyle veya droid update --version <version> komutuyla sabitleyebilirsiniz; npm'den gelen derlemeler kendini güncellemez. Güncellemeden sonra tek bir droid exec ile ağın modellerinin yerinde olduğunu kontrol edin.

Görseller. Ağın modelleri metin tabanlıdır; ekran görüntüleri için başka bir sağlayıcıda görme yeteneği olan bir model kaydını yanınızda bulundurun.

Satıcı hesabı olmadan çalışmak esas ise. Aynı ağ modelleri, giriş gerektirmeyen açık terminal ajanlarına bağlanır — örneğin aynı yükleyiciyle --tool opencode bayrağı kullanarak OpenCode'a.