Factory Droid + JoinGonka Gateway: BYOK บนโมเดลเครือข่าย Gonka

ขั้นตอนที่ 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 ยืนยันอีเมล แล้วสร้างคีย์ที่ขึ้นต้นด้วย jg- ในส่วน «คีย์ API» คีย์เดียวและยอดคงเหลือเดียวใช้ได้กับทุกโมเดลในเครือข่าย

ขั้นตอนที่ 3: รันตัวติดตั้ง

npx @joingonka/setup --tool droid

ตัวติดตั้งจะถามหาคีย์ — ซึ่งจะไม่ถูกรับผ่านอาร์กิวเมนต์บรรทัดคำสั่ง เพื่อไม่ให้ค้างอยู่ในประวัติเชลล์ — และจะทำสี่สิ่งด้วยกัน:

• เพิ่มรายการสำหรับแต่ละโมเดลในเครือข่ายลงในอาร์เรย์ customModels ของไฟล์ ~/.factory/settings.json (บน Windows คือ %USERPROFILE%\.factory\settings.json): ที่อยู่เกตเวย์, ประเภทผู้ให้บริการ 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 บรรทัด ! Could not verify right now ที่มาพร้อมการตอบกลับ 429 หมายความว่าโมเดลไม่ว่าง ไม่ใช่ข้อผิดพลาดในการตั้งค่า — การกำหนดค่าได้ถูกบันทึกไปแล้ว

ทุกสิ่งที่ตัวติดตั้งทำ สามารถเขียนด้วยมือได้เลย การตั้งค่าผู้ใช้ของ 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 ของโปรเจกต์ เพราะไฟล์นั้นมักถูก commit เข้า repository และถ้าหลังจากเปิด 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 ของเราบนโจทย์เดียวกัน — อ่านไฟล์และหาข้อผิดพลาด:

แฟล็ก -r (ระดับการคิดวิเคราะห์) ตามเอกสารของ Factory ไม่ใช้กับโมเดล BYOK เหตุใด 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

การตรวจสอบที่สามจากฝั่งเกตเวย์: ในหน้าคอนโซลส่วน «การใช้งาน» คำขอจะปรากฏในหมวด «ตามโมเดล» และในบล็อก «ตามคีย์» เวลาของคำขอล่าสุดจะอัปเดต

หากมีอะไรผิดพลาด ให้คำนึงถึงลักษณะพิเศษของ 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

เครื่องมือแบบ Agent ใช้โทเค็นต่างจากการแชททั่วไป: ในแต่ละข้อความของคุณ Droid จะเพิ่ม System Prompt, คำอธิบายเครื่องมือ และ Snapshot ของไดเรกทอรีทำงาน ซึ่งงานหนึ่งอาจต้องใช้หลายขั้นตอน ในการทดสอบของเรา แต่ละขั้นตอนจะใช้โทเค็นขาเข้าประมาณ 9,500 โทเค็นก่อนที่คุณจะเริ่มถามเสียอีก: งาน «อ่านไฟล์และหาข้อผิดพลาด» ใช้ 2 ขั้นตอนและโทเค็นประมาณ 19,000, ส่วน «แก้ไขและตรวจสอบ» ใช้ 4 ขั้นตอนและประมาณ 44,000 ดังนั้นราคาต่อโทเค็นจึงสำคัญมากที่นี่

ผ่านทาง JoinGonka Gateway โทเค็นมีราคา $0.0069 ต่อล้านโทเค็นขาเข้า และ $0.021 ต่อล้านโทเค็นขาออก — ราคาจะเท่ากันทุกโมเดลในเครือข่ายและดึงข้อมูลแบบเรียลไทม์มาแสดงบนหน้านี้

ตัวเลขในคอลัมน์ขวาอ้างอิงตามราคาในเดือนกันยายน 2026 เพื่อเปรียบเทียบ นี่คือวิธีการจ่ายเงินสำหรับโมเดลใน Droid:

คำสั่ง /cost ในอินเทอร์เฟซ Droid จะแสดงสถิติเซสชัน ส่วนการใช้งานจริงและยอดคงเหลือสำหรับโมเดล BYOK สามารถดูได้ในแดชบอร์ดของ Gateway ในหัวข้อ «การใช้งาน» (Usage) และ «การเรียกเก็บเงิน» (Billing) แนะนำให้สร้างคีย์แยกสำหรับ Droid เพื่อให้ติดตามปริมาณการใช้งานได้อย่างชัดเจน

ความเป็นอิสระ ในโหมดครั้งเดียว Droid จะอ่านอย่างเดียวเป็นค่าเริ่มต้น สิทธิ์จะขยายตามระดับ: --auto low — แก้ไขไฟล์, --auto medium — ติดตั้ง dependencies, บิลด์, ทดสอบ และคอมมิตในเครื่องเพิ่มด้วย, --auto high — ไปจนถึง push และ deploy แฟล็ก --skip-permissions-unsafe ยกเลิกการตรวจสอบทั้งหมด — ใช้เฉพาะกับคอนเทนเนอร์แบบใช้ครั้งเดียว ในโหมดอินเทอร์แอกทีฟ Ctrl+L ใช้สลับระดับ และระดับเริ่มต้นกำหนดได้ด้วย sessionDefaultSettings.autonomyLevel; ค่าเริ่มต้นคือ off — ทุกอย่างต้องยืนยัน

ลายเซ็นในคอมมิต การตั้งค่า includeCoAuthoredByDroid เปิดไว้เป็นค่าเริ่มต้น: Droid จะเพิ่มบรรทัดผู้ร่วมเขียนในข้อความคอมมิต หากไม่ต้องการ ให้ใส่ "includeCoAuthoredByDroid": false ใน settings.json

เซสชันเก็บไว้ที่ไหน หลังจากเข้าสู่ระบบบัญชี Droid จะมิเรอร์เซสชัน CLI ไปยังเวอร์ชันเว็บของ Factory เป็นค่าเริ่มต้น — ตัวที่รับผิดชอบคือ cloudSessionSync คีย์ BYOK ตามเอกสารยังคงอยู่ในเครื่อง; หากต้องการให้บทสนทนาอยู่ในเครื่องด้วย ให้ตั้ง "cloudSessionSync": false ทางฝั่งเกตเวย์ไม่เก็บเนื้อหาของพรอมป์และคำตอบ — ในสถิติเหลือเพียงข้อมูลรวมของการใช้งาน

การอัปเดต การติดตั้งด้วยสคริปต์อัปเดตตัวเองได้; การล็อกเวอร์ชันทำได้ด้วยตัวแปร FACTORY_DROID_AUTO_UPDATE_ENABLED=false หรือคำสั่ง droid update --version <version>; บิลด์จาก npm ไม่อัปเดตเอง หลังอัปเดต ให้ตรวจสอบด้วย droid exec หนึ่งครั้งว่าโมเดลของเครือข่ายยังอยู่ครบ

รูปภาพ โมเดลของเครือข่ายเป็นแบบข้อความ; สำหรับสกรีนช็อต ให้เก็บรายการที่มีโมเดลที่มองเห็นภาพได้ของผู้ให้บริการรายอื่นไว้ใกล้ ๆ

หากจำเป็นต้องทำงานโดยไม่มีบัญชีผู้ให้บริการ โมเดลของเครือข่ายเดียวกันเชื่อมต่อกับเทอร์มินัลเอเจนต์แบบเปิดที่ไม่ต้องเข้าสู่ระบบได้ — เช่น OpenCode ด้วยตัวติดตั้งเดียวกัน พร้อมแฟล็ก --tool opencode