Factory Droid + JoinGonka Gateway: Gonka नेटवर्क मॉडल पर BYOK

चरण 1: Droid इंस्टॉल करें। Factory के दस्तावेज़ से आधिकारिक तरीके:

# macOS and Linux
curl -fsSL https://app.factory.ai/cli | sh

# Homebrew
brew install --cask droid

# Windows (PowerShell)
irm https://app.factory.ai/cli/windows | iex

# via npm
npm install -g droid

स्क्रिप्ट बाइनरी को ~/.local/bin में रखती है और बताती है कि PATH में डायरेक्टरी कैसे जोड़ें; Linux पर दस्तावेज़ xdg-utils पैकेज भी इंस्टॉल करने को कहते हैं। जाँच — droid --version।

चरण 2: कुंजी प्राप्त करें। gate.joingonka.ai/register पर रजिस्टर करें, पता सत्यापित करें और «API कुंजियाँ» सेक्शन में jg- प्रीफ़िक्स वाली कुंजी बनाएँ। एक कुंजी और एक बैलेंस नेटवर्क के सभी मॉडलों के लिए काम करते हैं।

चरण 3: इंस्टॉलर चलाएँ।

npx @joingonka/setup --tool droid

इंस्टॉलर कुंजी पूछेगा — कमांड लाइन आर्ग्युमेंट में यह पास नहीं होती ताकि शेल इतिहास में न रह जाए — और चार काम करेगा:

• ~/.factory/settings.json (Windows पर — %USERPROFILE%\.factory\settings.json) की customModels ऐरे में नेटवर्क के हर मॉडल के लिए एक एंट्री जोड़ेगा: गेटवे का पता, प्रोवाइडर टाइप generic-chat-completion-api, कुंजी लिटरल में, असली कॉन्टेक्स्ट विंडो और रिस्पॉन्स सीलिंग; फ़ाइल को 600 परमिशन मिलेंगी;
• डिफ़ॉल्ट मॉडल — sessionDefaultSettings.model — DeepSeek V4 Flash पर सेट करेगा, लेकिन सिर्फ़ तब जब कोई चुना न गया हो या चुना गया मॉडल नेटवर्क से हट चुका हो। Factory कैटलॉग का मॉडल या कोई और BYOK एंट्री वह नहीं छीनेगा, बल्कि स्विच करने का तरीका बताएगा;
• पिछली फ़ाइल की कॉपी सेव करेगा, और customModels में दूसरों की एंट्रियाँ, बाकी सेटिंग्स और कमेंट जैसे थे वैसे छोड़ देगा; जो फ़ाइल पढ़ी न जा सके उसे वह ओवरराइट नहीं करेगा, बल्कि बताएगा कि क्या ठीक करें;
• अंत में गेटवे पर एक लाइव रिक्वेस्ट भेजेगा और सीधे बताएगा कि कुंजी, पता और मॉडल स्वीकार हुए या नहीं।

दूसरा डिफ़ॉल्ट मॉडल --model फ़्लैग सेट करता है जिसमें deepseek, glm या minimax शॉर्टहैंड है — साफ़ तौर पर बताया गया मॉडल हमेशा लिखा जाता है। डॉटफ़ाइल्स और सर्वर के लिए बिना सवाल वाला मोड है, इसमें कुंजी एनवायरनमेंट वेरिएबल से आती है:

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

Droid को रीस्टार्ट करने की ज़रूरत नहीं: settings.json में बदलाव वह खुद नोटिस कर लेता है। अंत में 429 रिस्पॉन्स के साथ ! Could not verify right now लाइन का मतलब है मॉडल व्यस्त है, सेटअप में गड़बड़ नहीं — कॉन्फ़िगरेशन तो लिखा जा चुका है।

इंस्टॉलर जो कुछ भी करता है, वह सब हाथ से लिखा जा सकता है। Droid की यूज़र सेटिंग्स ~/.factory/settings.json में रखी जाती हैं; अगर फ़ाइल मौजूद न हो, तो Droid पहली बार चलने पर उसे बना देता है। Gonka नेटवर्क के लिए customModels ऐरे और एक डिफ़ॉल्ट मॉडल चाहिए:

{
  "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"
  }
}

डिफ़ॉल्ट मॉडल sessionDefaultSettings.model में रखा जाता है और एंट्री को उसकी id से रेफ़र करता है। Factory के डॉक्स में फ़ाइल की जड़ में एक और model कुंजी का ज़िक्र है, लेकिन हमारे रन में droid exec ने -m फ़्लैग के बिना मॉडल sessionDefaultSettings से ही लिया — और वैल्यू बदलने के बाद भी।

कुंजी फ़ाइल में सादे टेक्स्ट में पड़ी रहती है: फ़ाइल को chmod 600 ~/.factory/settings.json कमांड से बंद कर दें और कुंजी वाली एंट्री प्रोजेक्ट की .factory/settings.json में न ले जाएँ — वह आम तौर पर रिपॉज़िटरी में चली जाती है। और अगर Droid चलाने के बाद फ़ाइल कुछ और दिखे, तो यह सामान्य है: कोई भी सेटिंग सेव करते समय Droid पूरी फ़ाइल दोबारा लिखता है — कुंजियाँ क्रम में लगाता है, एंट्री में index फ़ील्ड जोड़ता है और कमेंट नहीं रखता। इस दौरान 600 परमिशन बनी रहती हैं, और इंस्टॉलर ऐसी एंट्री आराम से अपडेट कर देता है।

Droid अपनी प्रविष्टियाँ कैटलॉग से अलग दिखाता है: डॉक्युमेंटेशन के अनुसार, इंटरैक्टिव मोड में कमांड /model उन्हें Custom models सेक्शन में दिखाता है, और Ctrl+N इनपुट फ़ील्ड में ही मॉडलों को बदलता रहता है। वन-शॉट मोड में मॉडल को -m फ़्लैग सेट करता है जिसकी वैल्यू id फ़ील्ड से आती है, स्लैश जैसे हैं वैसे ही लिखे जाते हैं: droid exec -m custom:zai-org/GLM-5.3-Flash "…"।

नाम में गलती हुई तो Droid Invalid model कहकर जवाब देगा और वे सारे मॉडल गिना देगा जो उसे दिखते हैं, जिनमें अपने मॉडल custom:… (display name) के रूप में शामिल होंगे: साथ ही यह भी दिख जाएगा कि प्रविष्टियाँ लोड हो गई हैं। Factory के डॉक्युमेंटेशन वाला नाम, यानी सिग्नेचर और नंबर से बना नाम (custom:DeepSeek-V4-Flash-(Gonka)-0), स्पष्ट id होने पर काम नहीं करेगा — हमारे रन में इसने वही Invalid model दिया।

Factory अकाउंट की ज़रूरत कहाँ पड़ती है। अपने मॉडल टोकन के भुगतान का सवाल हटा देते हैं, लेकिन खुद प्रोडक्ट में लॉगिन का नहीं। बिना अकाउंट लॉगिन के Droid 0.225.1 के रन में यह दिखा:

इंटरफ़ेस में काम करने के लिए Factory अकाउंट बनाएँ और ब्राउज़र से लॉगिन करें — Login विकल्प या /login कमांड; बिना ब्राउज़र वाली मशीन पर डॉक्युमेंटेशन अकाउंट सेटिंग्स से लिया गया की FACTORY_API_KEY वेरिएबल में रखने का सुझाव देता है। बिना लॉगिन droid exec चलाना आज़माने के लिए सुविधाजनक है, लेकिन आधिकारिक तौर पर इसका ज़िक्र नहीं है — CI में इस पर भरोसा न करें। Factory के प्राइसिंग पेज के मुताबिक़ BYOK सभी इंडिविजुअल प्लान में मुफ़्त लिमिट के साथ शामिल है, और लिमिट से ऊपर BYOK का इस्तेमाल प्लान की शर्तों के हिसाब से बिल किया जाता है; मौजूदा शर्तें — factory.ai/pricing पर। नेटवर्क के मॉडलों के टोकन इसके अलावा अलग से चुकाए जाते हैं — JoinGonka बैलेंस से।

कौन-सा मॉडल चुनें। नेटवर्क के सभी मॉडलों की कीमत एक ही है, इसलिए चुनाव बर्ताव का है। एक ही काम पर हमारे droid exec रन में इन्होंने ऐसा किया — फ़ाइल पढ़ना और गलती ढूँढ़ना:

BYOK मॉडलों पर -r फ़्लैग (रीज़निंग लेवल), Factory के डॉक्युमेंटेशन के मुताबिक़, लागू नहीं होता। डिफ़ॉल्ट रूप से DeepSeek V4 Flash क्यों चुना गया, यह मॉडल के ओवरव्यू में समझाया गया है।

एक खाली डायरेक्टरी में स्पष्ट बग वाली calc.py फ़ाइल रखें — जैसे कि आयत का क्षेत्रफल, जहाँ भुजाओं को गुणा करने के बजाय जोड़ा जाता है — और Droid से उसे ढूँढने के लिए कहें:

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

बिना फ़्लैग के droid exec केवल-पढ़ने के मोड में काम करता है: फ़ाइलें देखी जा सकती हैं, बदली नहीं जा सकतीं। एजेंट खुद पढ़ने का टूल कॉल करेगा और गलत अभिव्यक्ति का ज़िक्र करते हुए सारगर्भित जवाब देगा। -o json फ़्लैग के साथ जवाब एक ही ऑब्जेक्ट में आता है, जिसे स्क्रिप्ट से पार्स करना सुविधाजनक होता है (आउटपुट छोटा किया गया है):

{"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 फ़ील्ड पुष्टि करता है कि काम आपके मॉडल पर हुआ, Factory क्रेडिट्स पर नहीं। एजेंट को फ़ाइलें संपादित करने देने के लिए स्वायत्तता स्तर जोड़ें: droid exec --auto low "Fix the bug in calc.py and change nothing else." — हमारे रन में DeepSeek V4 Flash ने फ़ाइल पढ़ी, जोड़ को गुणा से बदला और खुद स्क्रिप्ट चलाकर पुष्टि की कि 12 प्रिंट होता है।

तीसरी जाँच — गेटवे की ओर से: कंट्रोल पैनल में «Usage» सेक्शन में यह अनुरोध «By models» ब्रेकडाउन में दिखेगा, और «By keys» ब्लॉक में अंतिम अनुरोध का समय अपडेट हो जाएगा।

अगर कुछ गड़बड़ हो जाए, तो Droid की एक खासियत ध्यान में रखें: कंसोल में droid exec सिर्फ़ Error during droid execution: Exec failed प्रिंट करता है (JSON में — "result":"Exec failed"), और असली कारण लॉग में रह जाता है। उसे एक ही कमांड से निकाला जा सकता है:

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

एजेंट टूल चैट की तुलना में टोकन का उपयोग अलग तरह से करता है: Droid आपके प्रत्येक वाक्यांश में एक सिस्टम प्रॉम्प्ट, टूल विवरण और वर्किंग डायरेक्टरी का स्नैपशॉट जोड़ता है, और कार्य को पूरा होने में कई टर्न लगते हैं। हमारे रन में, आपके प्रश्न से पहले ही प्रत्येक टर्न में लगभग 9.5 हजार इनपुट टोकन खर्च हुए: «फ़ाइल पढ़ें और त्रुटि खोजें» कार्य में दो टर्न और लगभग 19 हजार टोकन लगे, «सुधारें और जांचें» में चार टर्न और लगभग 44 हजार टोकन लगे। इसलिए यहां प्रति टोकन कीमत मायने रखती है।

JoinGonka Gateway के माध्यम से टोकन की कीमत इनपुट पर $0.0069 प्रति मिलियन और आउटपुट पर $0.021 प्रति मिलियन है — यह कीमत नेटवर्क के सभी मॉडलों के लिए समान है और इस पेज पर लाइव स्रोत से अपडेट की जाती है।

दाईं ओर के कॉलम में अनुमान सितंबर 2026 की कीमतों के अनुसार हैं। तुलना के लिए — Droid में मॉडल के लिए भुगतान कैसे किया जा सकता है:

Droid इंटरफ़ेस में /cost कमांड सत्र के आँकड़े दिखाती है, और BYOK मॉडल के लिए सटीक खपत और शेष राशि गेटवे कैबिनेट के «इस्तेमाल» (Usage) और «बिलिंग» सेक्शन में देखी जा सकती है। Droid के लिए एक अलग कुंजी बनाएं — इसका ट्रैफ़िक एक अलग लाइन में दिखाई देगा।

स्वायत्तता। वन-शॉट मोड में Droid डिफ़ॉल्ट रूप से सिर्फ़ पढ़ता है, अधिकार स्तर बढ़ाते हैं: --auto low — फ़ाइल संपादन, --auto medium — साथ ही डिपेंडेंसी इंस्टॉल, बिल्ड, टेस्ट और लोकल कमिट, --auto high — push और deploy तक। --skip-permissions-unsafe फ़्लैग सभी जाँचें हटा देता है — सिर्फ़ एकबारगी कंटेनरों के लिए। इंटरैक्टिव मोड में स्तर Ctrl+L से बदलता है, और शुरुआती स्तर sessionDefaultSettings.autonomyLevel सेट करता है; डिफ़ॉल्ट वहाँ off है — सब कुछ पुष्टि के साथ।

कमिट में हस्ताक्षर। includeCoAuthoredByDroid सेटिंग डिफ़ॉल्ट रूप से चालू है: Droid कमिट संदेशों में सह-लेखकत्व की पंक्ति जोड़ता है। अगर वह नहीं चाहिए, तो settings.json में "includeCoAuthoredByDroid": false लिखें।

सेशन कहाँ स्टोर होते हैं। अकाउंट में साइन इन करने के बाद Droid डिफ़ॉल्ट रूप से CLI सेशन को Factory के वेब वर्शन में मिरर करता है — इसके लिए cloudSessionSync ज़िम्मेदार है। BYOK कुंजियाँ, डॉक्युमेंटेशन के अनुसार, लोकल ही रहती हैं; अगर बातचीत भी मशीन पर ही रहनी चाहिए, तो "cloudSessionSync": false सेट करें। गेटवे अपनी ओर से प्रॉम्प्ट और जवाबों की सामग्री स्टोर नहीं करता — आँकड़ों में सिर्फ़ खर्च के एग्रीगेट रहते हैं।

अपडेट। स्क्रिप्ट से इंस्टॉल खुद अपडेट होता है; वर्शन FACTORY_DROID_AUTO_UPDATE_ENABLED=false वेरिएबल या droid update --version <version> कमांड से पिन किया जा सकता है; npm से बने बिल्ड खुद अपडेट नहीं होते। अपडेट के बाद एक droid exec से जाँचें कि नेटवर्क के मॉडल मौजूद हैं।

तस्वीरें। नेटवर्क के मॉडल टेक्स्ट-आधारित हैं; स्क्रीनशॉट के लिए किसी दूसरे प्रोवाइडर की ऐसी मॉडल एंट्री पास रखें जो देख पाती हो।

अगर वेंडर अकाउंट के बिना काम करना ज़रूरी है। वही नेटवर्क मॉडल ऐसे ओपन टर्मिनल एजेंटों से जुड़ते हैं जिनमें लॉगिन की ज़रूरत नहीं — जैसे OpenCode से, उसी इंस्टॉलर से, --tool opencode फ़्लैग के साथ।