Factory Droid + JoinGonka Gateway: BYOK sa mga modelo ng network ng Gonka

Hakbang 1: i-install ang Droid. Mga opisyal na paraan mula sa dokumentasyon ng 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

Inilalagay ng script ang binary sa ~/.local/bin at sinasabi kung paano idagdag ang direktoryo sa PATH; sa Linux, hinihiling ng dokumentasyon na i-install din ang xdg-utils package. Para i-verify — droid --version.

Hakbang 2: kumuha ng key. Magrehistro sa gate.joingonka.ai/register, i-verify ang address at gumawa ng key na may jg- prefix sa seksyong «Mga API key». Isang key at isang balanse ang gumagana para sa lahat ng modelo ng network.

Hakbang 3: patakbuhin ang installer.

npx @joingonka/setup --tool droid

Tatanungin ng installer ang key — hindi ito ipinapasa sa command-line arguments para hindi ito maiwan sa shell history — at gagawin nito ang apat na bagay:

• magdadagdag ng entry sa customModels array ng ~/.factory/settings.json (sa Windows — %USERPROFILE%\.factory\settings.json) para sa bawat modelo ng network: address ng gateway, uri ng provider na generic-chat-completion-api, key bilang literal, tunay na context window at response ceiling; makakakuha ang file ng 600 permissions;
• itakda ang default na modelo — sessionDefaultSettings.model — sa DeepSeek V4 Flash, pero kung wala pang napili o ang napili ay tumutukoy sa modelong wala na sa network. Hindi nito aagawin ang modelo mula sa catalog ng Factory o anumang BYOK entry, sa halip ay sasabihin kung paano magpalit;
• magse-save ng kopya ng dating file, at iiwan ang mga entry ng iba sa customModels, iba pang settings at comments kung ano sila; ang file na hindi mabasa ay hindi nito i-overwrite, sasabihin lang kung ano ang ayusin;
• sa huli, magpapadala ng live na request sa gateway at direktang sasabihin kung tinanggap ang key, address at modelo.

Ang ibang default na modelo ay itinatakda ng --model flag na may shorthand na deepseek, glm o minimax — ang tahasang tinukoy na modelo ay laging isinusulat. Para sa mga dotfile at server, may mode na walang tanong, at ang key dito ay kinukuha mula sa environment variable:

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

Hindi kailangang i-restart ang Droid: siya na mismo ang nakakapansin ng mga pagbabago sa settings.json. Ang linyang ! Could not verify right now na may 429 response sa dulo ay nangangahulugang abala ang modelo, hindi error sa setup — nakasulat na ang configuration.

Lahat ng ginagawa ng installer, kayang isulat nang manu-mano. Ang mga custom na setting ng Droid ay nakaimbak sa ~/.factory/settings.json; kung wala ang file, ginagawa ito ng Droid sa unang pagpapatakbo. Para sa network ng Gonka, kailangan ang array na customModels at ang default na modelo:

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

Ang default na modelo ay nakaimbak sa sessionDefaultSettings.model at tumutukoy sa entry sa pamamagitan ng id nito. Binabanggit pa ng dokumentasyon ng Factory ang key na model sa root ng file, pero sa aming pagpapatakbo ng droid exec na walang flag na -m, kinuha ng Droid ang modelo mula mismo sa sessionDefaultSettings — at ganoon din pagkatapos baguhin ang halaga.

Nakalagay ang key sa file nang plaintext: isara ang file gamit ang command na chmod 600 ~/.factory/settings.json at huwag ilipat ang mga entry na may key papunta sa .factory/settings.json ng proyekto — kadalasan kasi napupunta ito sa repository. At kung pagkatapos patakbuhin ang Droid ay iba ang hitsura ng file, normal lang iyon: sa tuwing sine-save ang anumang setting, buong isinusulat muli ng Droid ang file — inaayos ang mga key, nagdadagdag ng field na index sa mga entry, at hindi nagse-save ng mga komento. Nananatili naman ang permisyong 600, at walang problema itong ina-update ng installer.

Ipinapakita ng Droid ang sarili nitong mga entry nang hiwalay sa catalog: ayon sa dokumentasyon, sa interactive na mode, inilalabas ng command na /model ang mga ito sa seksyong Custom models, at ang Ctrl+N ay nagbibisikleta sa mga modelo mismo sa input field. Sa one-shot na mode, tinutukoy ng flag na -m ang modelo gamit ang value mula sa field na id, isinusulat ang mga forward slash nang ganito: droid exec -m custom:zai-org/GLM-5.3-Flash "…".

Kung magkamali ka sa pangalan, sasagot ang Droid ng Invalid model at ililista ang lahat ng modelong nakikita nito, kasama na ang sarili nito sa anyong custom:… (display name): makikita rin na nag-load ang mga entry. Ang pangalan sa estilo ng dokumentasyon ng Factory, mula sa caption at numero (custom:DeepSeek-V4-Flash-(Gonka)-0), ay hindi gagana kapag may tahasang id — sa aming run, parehong Invalid model ang ibinigay nito.

Ano ang nangangailangan ng Factory account. Inaalis ng sariling mga modelo ang isyu sa pagbabayad ng mga token, pero hindi ang pag-login sa produkto mismo. Ito ang ipinakita ng run ng Droid 0.225.1 nang walang login sa account:

Para gumana sa interface, gumawa ng Factory account at mag-login sa browser — ang Login option o ang command na /login; sa machine na walang browser, iminumungkahi ng dokumentasyon ang key mula sa mga setting ng account sa variable na FACTORY_API_KEY. Ang paggana ng droid exec nang walang login ay maginhawa para sa pagsubok, pero hindi opisyal na nakadokumento — huwag umasa dito sa CI. Ayon sa pricing page ng Factory, kasama ang BYOK sa lahat ng indibidwal na plan na may libreng limit, at lampas sa limit, ang paggamit ng BYOK ay sinisingil ayon sa mga kondisyon ng plan; ang kasalukuyang mga kondisyon ay nasa factory.ai/pricing. Ang mga token ng mga modelo ng network ay binabayaran nang hiwalay — mula sa balanse ng JoinGonka.

Alin ang modelong pipiliin. Pareho ang presyo ng lahat ng modelo ng network, kaya ang pagpili ay tungkol sa pagganap. Ganito sila nagtrabaho sa aming run ng droid exec sa isang gawain — basahin ang file at hanapin ang error:

Ang flag na -r (antas ng pag-iisip) sa mga modelong BYOK, ayon sa dokumentasyon ng Factory, ay hindi inilalapat. Kung bakit DeepSeek V4 Flash ang default, tinalakay sa review ng modelo.

Maglagay sa isang walang laman na direktoryo ng file na calc.py na may malinaw na bug — halimbawa, ang area ng rektanggulo kung saan pinagsasama ang mga gilid sa halip na i-multiply — at hilingin sa Droid na hanapin ito:

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

Kung walang flags, ang droid exec ay gumagana sa read-only mode: puwedeng tingnan ang mga file, pero hindi sila mababago. Ang agent mismo ang tatawag sa tool sa pagbabasa at sasagot nang direkta, kasama ang pagtukoy sa maling expression. Sa flag na -o json, darating ang sagot bilang isang object na madaling i-parse ng script (pinaikli ang output):

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

Kinukumpirma ng field na factory_credits: 0 na sa inyong sariling modelo tumakbo ang trabaho, hindi sa mga credit ng Factory. Para makapag-edit ang agent ng mga file, magdagdag ng antas ng autonomy: droid exec --auto low "Fix the bug in calc.py and change nothing else." — sa aming run, binasa ng DeepSeek V4 Flash ang file, pinalitan ang pagdaragdag ng pagpaparami, at mismo ang nagpatakbo ng script para tiyakin na 12 ang output.

Ang ikatlong pagsusuri ay mula sa panig ng gateway: sa dashboard, sa seksyong "Usage", lalabas ang request sa breakdown na "By models", at sa block na "By keys" mag-a-update ang oras ng huling request.

Kung may nagkamali, tandaan ang kakaibang behavior ng Droid: sa console, ang droid exec ay nagpi-print lamang ng Error during droid execution: Exec failed (sa JSON — "result":"Exec failed"), at ang tunay na dahilan ay nananatili sa log. Makukuha ito sa isang command:

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

Ang ahenteng tool ay gumagastos ng tokens nang iba kaysa sa chat: sa bawat parirala mo, nagdaragdag ang Droid ng system prompt, mga deskripsyon ng tool, at snapshot ng working directory, at ang task ay tumatagal ng ilang steps. Sa aming run, bawat step ay may dala na mga 9.5 libong input tokens bago pa ang tanong mo: ang task na "basahin ang file at hanapin ang error" ay tumagal ng dalawang steps at mga 19 libong tokens, ang "ayusin at suriin" — apat na steps at mga 44 libong tokens. Kaya ang presyo kada token ay mahalaga rito.

Sa pamamagitan ng JoinGonka Gateway, ang mga tokens ay nagkakahalaga ng $0.0069 kada milyon sa input at $0.021 kada milyon sa output — ang presyo ay pareho para sa lahat ng models sa network at awtomatikong kinukuha sa pahinang ito mula sa isang live source.

Ang mga estimasyon sa kanang column ay base sa presyo noong Setyembre 2026. Para sa paghahambing — paano posibleng magbayad para sa mga models sa Droid:

Ang command na /cost sa Droid interface ay nagpapakita ng statistics ng session, at ang eksaktong konsumo at balance para sa mga BYOK models ay nasa cabinet ng gateway, sa mga seksyong "Usage" at "Billing". Gumawa ng hiwalay na key para sa Droid — ang traffic nito ay makikita bilang hiwalay na linya.

Autonomy. Sa one-shot mode, ang Droid ay nagbabasa lang bilang default; pinapalawak ng mga antas ang mga pahintulot: --auto low — pag-edit ng mga file, --auto medium — kasama pa ang pag-install ng dependencies, build, tests at lokal na commits, --auto high — hanggang sa push at deploy. Ang flag na --skip-permissions-unsafe ay nag-aalis ng lahat ng pagsusuri — para lamang sa mga disposable container. Sa interactive mode, ang Ctrl+L ang nagpapalit ng antas, at ang panimulang antas ay itinakda ng sessionDefaultSettings.autonomyLevel; default doon ay off — lahat may kumpirmasyon.

Lagda sa mga commit. Ang setting na includeCoAuthoredByDroid ay naka-on bilang default: nagdadagdag ang Droid ng linyang co-authorship sa mga commit message. Kung ayaw ninyo ito, isulat ang "includeCoAuthoredByDroid": false sa settings.json.

Saan naka-store ang mga session. Pagkatapos mag-login sa account, ang Droid ay nagmi-mirror ng CLI sessions sa web version ng Factory bilang default — ang cloudSessionSync ang responsable dito. Ang mga BYOK key, ayon sa dokumentasyon, ay nananatiling lokal; kung dapat ding manatili sa makina ang pag-uusap, itakda ang "cloudSessionSync": false. Sa panig nito, hindi nag-iimbak ang gateway ng nilalaman ng mga prompt at sagot — mga aggregate ng gastos lang ang natitira sa stats.

Mga update. Ang pag-install sa pamamagitan ng script ay kusang nag-a-update; maaaring i-pin ang bersyon gamit ang variable na FACTORY_DROID_AUTO_UPDATE_ENABLED=false o ang command na droid update --version <version>; ang mga npm build ay hindi kusang nag-a-update. Pagkatapos ng update, sa isang droid exec, tiyakin na naroon pa rin ang mga modelo ng network.

Mga larawan. Text-only ang mga modelo ng network; para sa mga screenshot, panatilihin sa tabi ang isang entry na may modelong may vision, mula sa ibang provider.

Kung mahalaga ang pagtatrabaho nang walang vendor account. Ang parehong mga modelo ng network ay kumokonekta sa mga bukas na terminal agent na hindi kailangan ng login — halimbawa, sa OpenCode gamit ang parehong installer, na may flag na --tool opencode.