Cherry Studio + JoinGonka Gateway — ไคลเอนต์ AI บนเดสก์ท็อป

Cherry Studio — ไคลเอนต์ AI แบบโอเพนซอร์สสำหรับ Windows, macOS และ Linux: แชทกับผู้ช่วย, การเปรียบเทียบคำตอบของหลายโมเดล, เอเจนท์, ฐานความรู้, การแปล และการเชื่อมต่อเซิร์ฟเวอร์ MCP โครงการนี้เผยแพร่ภายใต้ใบอนุญาต AGPL-3.0 และได้รับดาวบน GitHub มากกว่า 50,000 ดวง (กันยายน 2026) หลักการสำคัญของไคลเอนต์คือคีย์ของคุณเอง: คุณเป็นผู้ตัดสินใจว่า inference จะผ่านผู้ให้บริการรายใด และแอปพลิเคชันจะมอบอินเทอร์เฟซเดียวที่ครอบคลุมไว้

นอกเหนือจากรายการผู้ให้บริการที่มีอยู่ ใน Cherry Studio ยังมี Custom Provider — ผู้ให้บริการของคุณเองที่มีที่อยู่แบบกำหนดเอง คุณสามารถเชื่อมต่อ JoinGonka Gateway ผ่านช่องทางนี้: API ที่เข้ากันได้กับ OpenAI สำหรับโมเดลของเครือข่ายแบบกระจายศูนย์ Gonka ที่ชำระเงินตามโทเค็นตามราคาจริงของเครือข่าย หลังจากลงทะเบียนและยืนยันที่อยู่แล้ว บัญชีของคุณจะได้รับโทเค็นฟรี 3M โทเค็น — คุณสามารถทดลองใช้ไคลเอนต์ได้อย่างสบายใจก่อนการเติมเงินครั้งแรก

คู่มือนี้ประกอบด้วยการตั้งค่าทีละขั้นตอนสำหรับตระกูล V2 ปัจจุบันพร้อมหมายเหตุสำหรับ V1, การวิเคราะห์ช่อง API Host พร้อมกฎเกี่ยวกับสัญลักษณ์ #, การเลือกโมเดล, การตรวจสอบ และข้อผิดพลาดทั่วไป คำบรรยายอินเทอร์เฟซอ้างอิงตามโลคัลภาษาอังกฤษของแอปพลิเคชัน

การติดตั้ง, เวอร์ชัน และกุญแจ

การติดตั้ง บิลด์สำหรับทุกระบบอยู่ในหน้า releases ของโปรเจกต์: ตัวติดตั้งและเวอร์ชันพกพาสำหรับ Windows, ไฟล์ dmg สำหรับ macOS, AppImage, deb และ rpm สำหรับ Linux — ทั้ง x64 และ ARM ประวัติการสนทนาและการตั้งค่าจัดเก็บไว้ในเครื่องของคุณ

V1 หรือ V2 ในเดือนสิงหาคม 2026 ซีรีส์ V2 เปิดตัวพร้อมโครงสร้างข้อมูลใหม่และการตั้งค่าที่ออกแบบใหม่; บิลด์ล่าสุดของซีรีส์เดิมคือ 1.9.13 ทั้งสองซีรีส์มีฟีเจอร์ผู้ให้บริการ自定义 ต่างกันที่รูปแบบการเพิ่มและป้ายกำกับบางส่วน — จุดเหล่านั้นจะถูกระบุไว้ด้านล่าง เมื่ออัปเกรดจาก V1 การตั้งค่าผู้ให้บริการและโมเดลจะถูกโอนย้ายอัตโนมัติ ข้อมูล V1 เดิมยังคงอยู่ แต่ข้อมูลใหม่จะไม่ซิงค์กลับ และไฟล์สำรองของทั้งสองซีรีส์เข้ากันไม่ได้ ก่อนอัปเดตโปรดอ่านส่วนเกี่ยวกับการย้ายข้อมูลในเอกสาร Cherry Studio

คีย์ JoinGonka ลงทะเบียนที่ gateway เปิดส่วน «API-keys» ในแดชบอร์ดแล้วกด «สร้างคีย์» คีย์จะขึ้นต้นด้วย jg- และแสดงเพียงครั้งเดียว — บันทึกไว้ทันที สะดวกที่จะสร้างคีย์แยกสำหรับ Cherry Studio: ในส่วน «การใช้งาน» ค่าใช้จ่ายของคีย์นั้นจะแสดงเป็นบรรทัดแยกต่างหาก

การเชื่อมต่อ: ผู้ให้บริการของคุณเองและช่อง API Host

คลิกไอคอนเฟือง — หน้าตั้งค่าจะเปิดขึ้น เลือกส่วน Model Provider (ในเอกสารภาษาอังกฤษเรียกว่า Model Services)
ใต้รายการผู้ให้บริการ กด Add Provider
ใน V2 จะเปิดกล่องโต้ตอบ Add Custom Provider กรอก Provider Name — เช่น JoinGonka ในบล็อก Endpoint settings กรอกบรรทัด OpenAI ด้วยที่อยู่ https://gate.joingonka.ai/v1: ใต้ช่องจะปรากฏบรรทัด Request path พร้อมเส้นทางสุดท้าย — ต้องลงท้ายด้วย /v1/chat/completions ในช่อง API Key วาง jg-your-key แล้วกด Add
ใน V1 กล่องโต้ตอบสั้นกว่า: ชื่อผู้ให้บริการและ Provider Type — เลือก OpenAI คีย์และที่อยู่กรอกในหน้าผู้ให้บริการเอง ในช่อง API Key และ API Host
ตรวจสอบว่าผู้ให้บริการเปิดใช้งานอยู่: สวิตช์อยู่ที่มุมขวาบนของหน้า ใน V2 ผู้ให้บริการใหม่จะถูกเพิ่มมาในสถานะปิด และโมเดลของผู้ให้บริการที่ปิดจะไม่ปรากฏในรายการเลือก

Cherry Studio ประกอบที่อยู่อย่างไร ช่อง API Host รับที่อยู่ฐาน ส่วนเส้นทางแอปจะเติมเองและแสดงผลในบรรทัด Preview ใต้ช่อง กฎเหมือนกันทั้งสองเวอร์ชัน:

สิ่งที่กรอก	คำขอจะไปที่ใด	หมายเหตุ
`https://gate.joingonka.ai/v1`	`https://gate.joingonka.ai/v1/chat/completions`	ตัวเลือกที่แนะนำ: มีเวอร์ชันในที่อยู่แล้ว เติมแค่เส้นทาง
`https://gate.joingonka.ai`	ที่อยู่เดียวกัน	ไม่มีเวอร์ชันในที่อยู่ — Cherry Studio จะเติม `/v1` เอง
`https://gate.joingonka.ai/v1/`	ที่อยู่เดียวกัน	สแลชท้ายจะถูกตัดออกเฉย ๆ
`https://gate.joingonka.ai/v1/chat/completions#`	ที่อยู่ตามที่กรอก ไม่มี `#`	สัญลักษณ์ `#` ท้ายจะปิดการเติมเวอร์ชันและเส้นทางอัตโนมัติ สำหรับเกตเวย์ไม่จำเป็น — ใช้กับบริการที่มีเส้นทางไม่มาตรฐาน
`https://gate.joingonka.ai#`	`https://gate.joingonka.ai/chat/completions`	ไม่เติมเวอร์ชัน คำขอออกนอก API — เกตเวย์จะตอบ `405`

ในคู่มือเก่ายังมีกฎอีกข้อ: สแลชท้ายที่อยู่จะปิด /v1 ปรากฏว่าใช้ได้ในเวอร์ชันแรก ๆ จนถึงสาย 1.6 และถูกนำออกใน 1.7: ในบิลด์ปัจจุบันมีเพียง # ที่ปิดการเติมอัตโนมัติ

โมเดล: รายการ ประเภท และโมเดลเริ่มต้น

เมื่อเพิ่มผู้ให้บริการแล้ว แต่ยังไม่เห็นในแชท: เฉพาะโมเดลที่คุณเพิ่มอย่างชัดเจนเท่านั้นที่จะปรากฏในรายการเลือกของ Cherry Studio มีสองวิธีในการทำ:

รายการจากเซิร์ฟเวอร์ ในหน้าผู้ให้บริการ คลิก Sync models (ใน V1 คือ Manage แล้วตามด้วย Fetch model list) Cherry Studio จะส่งคำขอ GET /v1/models ไปยังเกตเวย์และแสดงรายการที่มีอยู่ทั้งหมด เพิ่มโมเดลที่ต้องการด้วยปุ่ม + ด้วยตนเอง ปุ่ม Add Model จะเปิดฟอร์มซึ่งมีช่องบังคับหนึ่งช่องคือ Model ID: กรอกตัวระบุให้ตรงตามตัวอักษร

โมเดลในเครือข่ายมีราคาเท่ากัน ดังนั้นให้เพิ่มทั้งหมด — การเลือกต้องดูที่พฤติกรรมไม่ใช่ราคา:

โมเดล	Model ID	บริบทและการตอบกลับ	เมื่อใดควรเลือกใน Cherry Studio
DeepSeek V4 Flash	`deepseek-ai/DeepSeek-V4-Flash-0731`	380K, ตอบกลับสูงสุด 32768 โทเค็น	โมเดลหลักสำหรับผู้ช่วย: เอกสารยาว, การแทรกโค้ดขนาดใหญ่, คำตอบเชิงลึกและการแปล — ขีดจำกัดการตอบกลับสูงสุดในเครือข่าย
MiniMax M2.7	`MiniMaxAI/MiniMax-M2.7`	200K, ตอบกลับสูงสุด 8192 โทเค็น	คำถามทั่วไปที่รวดเร็ว, ร่างอีเมล, การแก้ไขข้อความสั้นๆ; เหมาะสำหรับโมเดลบริการ
GLM-5.3 Flash	`zai-org/GLM-5.3-Flash`	390K, ตอบกลับสูงสุด 8192 โทเค็น	โมเดล Reasoning: วิเคราะห์ก่อนตอบ การวิเคราะห์งานที่ซับซ้อน, วางแผน, ตรวจสอบตรรกะ; คำตอบจะมาถึงช้ากว่าเพราะต้องใช้โควตาบางส่วนไปกับการวิเคราะห์

ประเภทโมเดล โมเดลแต่ละตัวในรายการจะมีปุ่มตั้งค่าเพื่อทำเครื่องหมายความสามารถ เช่น Vision, Reasoning, Tool และอื่นๆ Cherry Studio จะตั้งค่าบางอย่างอัตโนมัติ แต่สำหรับโมเดลเกตเวย์ควรตรวจสอบอีกครั้ง Vision ควรปิดไว้: โมเดลเครือข่ายเป็นโมเดลข้อความ Tool จำเป็นหากคุณเชื่อมต่อเครื่องมือ MCP — โมเดลจากตารางทั้งหมดรองรับการเรียกใช้เครื่องมือแบบ Native Reasoning เหมาะสำหรับ GLM-5.3 Flash ซึ่งเป็นโมเดล Reasoning ของเครือข่าย

โมเดลเริ่มต้น ในส่วนการตั้งค่า Default Model คุณสามารถกำหนดโมเดลสำหรับบทบาทบริการ ให้ตั้งค่า DeepSeek V4 Flash เป็นโมเดลหลักสำหรับผู้ช่วย สำหรับโมเดลที่รวดเร็วซึ่งใช้ตั้งชื่อบทสนทนาและเตรียมคำค้นหา เอกสาร Cherry Studio แนะนำโมเดลที่เบาและรวดเร็ว ไม่ใช่โมเดล Reasoning — ในโมเดลของเครือข่าย MiniMax M2.7 เหมาะที่สุด ส่วน GLM-5.3 Flash ที่มีการวิเคราะห์บังคับนั้นไม่แนะนำ สำหรับการแปล โมเดลสองตัวแรกใช้ได้ทั้งคู่

การตรวจสอบและการวินิจฉัย

ในหน้าของผู้ให้บริการในบล็อกของคีย์จะมีปุ่ม Model Check (ใน V1 จะเป็นปุ่ม Check ข้างช่องใส่คีย์) เลือกโมเดล จากนั้น Cherry Studio จะส่งคำขอทดสอบสั้นๆ ไปยังโมเดลและแสดงผลลัพธ์พร้อมกับค่าความหน่วง (latency) หากการตรวจสอบผ่านแล้ว ให้ไปที่หน้าแชท เลือกโมเดลของเกตเวย์ในตัวสลับโมเดล แล้วเริ่มถามคำถามได้เลย

เพื่อตรวจสอบว่าคำขอถูกส่งผ่านเกตเวย์จริงหรือไม่ ให้เปิดแผงควบคุม (dashboard) ไปที่ส่วน "Usage": ในบล็อก "By keys" คุณจะเห็นคำขอและเวลาในการเข้าใช้งานล่าสุดของคีย์ Cherry Studio ส่วนในบล็อก "By models" จะแสดงโมเดลที่เลือกไว้ ใน V2 จะมีสถิติของไคลเอนต์เองในส่วนการตั้งค่า Usage ได้แก่ จำนวนโทเค็นและคำขอตามผู้ให้บริการ โมเดล และคีย์ ค่าใช้จ่ายที่แสดงเป็นเพียงข้อมูลอ้างอิงเท่านั้น เนื่องจาก Cherry Studio คำนวณจากราคามาตรฐานของโมเดล ไม่ใช่ราคาจริงของเครือข่าย Gonka ดังนั้นโปรดตรวจสอบยอดเงินที่แน่นอนในแผงควบคุมของเกตเวย์

หากมีข้อผิดพลาดเกิดขึ้น สาเหตุมักจะระบุอยู่ในข้อความตอบกลับ:

สิ่งที่เห็น	หมายความว่าอย่างไร	สิ่งที่ควรทำ
`401`, `Invalid API key`	เกตเวย์ไม่รู้จักคีย์นี้	ตรวจสอบว่าคีย์ขึ้นต้นด้วย `jg-` ไม่มีเว้นวรรค และเปิดใช้งานอยู่ในส่วน "API-keys"
`404`, `Invalid URL (POST …)`	มีส่วนของเส้นทางที่เกินมา กรณีทั่วไปคือมีการใส่ URL เต็มใน API Host โดยไม่มี `#` และ Cherry Studio เติม `/chat/completions` ซ้ำเข้าไป	ให้ใส่เพียงที่อยู่พื้นฐาน `https://gate.joingonka.ai/v1` ในช่องและตรวจสอบกับแถว Preview
`405 Not Allowed` หรือ HTML แทนที่จะเป็นคำตอบ	คำขอส่งไปผิดที่: URL ลงท้ายด้วย `#` แต่ไม่มี `/v1` อยู่ในนั้น	ลบ `#` ออกหรือเติม `/v1` เข้าไป
`429`	โมเดลทำงานหนักเกินไป: ในช่วงเวลาที่มีการใช้งานสูง ความจุของโมเดลนั้นในเครือข่ายอาจถูกใช้งานจนเต็ม	ลองใหม่ในอีกไม่กี่วินาทีหรือสลับไปใช้โมเดลอื่น สถานะของเครือข่ายสามารถดูได้ที่ หน้าสถานะ
ตรวจสอบผ่านแต่ไม่มีโมเดลในแชท	ผู้ให้บริการอาจถูกปิดอยู่ หรือโมเดลไม่ได้ถูกเพิ่มในรายการ	เปิดใช้งานผู้ให้บริการและเพิ่มโมเดลผ่าน Sync models หรือ Add Model
ใส่คีย์แล้วแต่แชทไม่ตอบ	ผู้ช่วยกำลังใช้โมเดลเริ่มต้นจากผู้ให้บริการอื่นที่ไม่ได้ตั้งค่าไว้	ระบุโมเดลของเกตเวย์ในส่วน Default Model
สำหรับ GLM-5.3 Flash คำตอบว่างเปล่าหรือตัดขาด	ขีดจำกัดการตอบกลับในการตั้งค่าผู้ช่วยน้อยเกินไป: การประมวลผล (reasoning) กินโควต้าในขีดจำกัดเดียวกัน	ลบข้อจำกัด Max tokens หรือตั้งค่าให้สูงพอ เช่น ตั้งแต่ 2000 โทเค็นขึ้นไป
โมเดลตอบว่ามองไม่เห็นภาพ	โมเดลในเครือข่ายเป็นโมเดลข้อความ: เกตเวย์จะแทนที่รูปภาพด้วยข้อความอธิบาย	ยกเลิกการเลือก Vision ในโมเดลนั้น สำหรับงานที่เกี่ยวกับรูปภาพให้ใช้ผู้ให้บริการที่มีโมเดลรองรับการมองเห็น (Vision) ซึ่งใน Cherry Studio สามารถใช้งานผู้ให้บริการหลายรายพร้อมกันได้

ราคาค่าใช้จ่าย

ตัวไคลเอนต์ใช้งานได้ฟรี คุณจ่ายเฉพาะค่า inference เท่านั้น ผ่าน JoinGonka Gateway โทเค็นมีราคา $0.0069 ต่อล้านโทเค็นสำหรับขาเข้า และ $0.021 ต่อล้านโทเค็นสำหรับขาออก ซึ่งเป็นราคาเดียวกันสำหรับทุกโมเดลในเครือข่ายและดึงข้อมูลราคาปัจจุบันจากแหล่งข้อมูลโดยตรง การแชทใช้โทเค็นน้อยกว่าเครื่องมือที่เป็นตัวแทน (agent tools) มาก ดังนั้นนี่คือประมาณการค่าใช้จ่าย ณ เดือนกันยายน 2026:

สถานการณ์	การใช้งาน	ผ่าน Gateway
การสนทนาประมาณสิบข้อความ	10-30 พันโทเค็น	เศษเสี้ยวของหนึ่งเซนต์
วันทำงานหนัก: ถามคำถาม แปลเอกสาร ตรวจสอบเอกสาร	0.5-1M โทเค็น	น้อยกว่าหนึ่งเซนต์
การใช้งานรายวันตลอดทั้งเดือน	15-30M โทเค็น	ไม่กี่สิบเซนต์

ข้อควรระวังสำคัญเกี่ยวกับการสนทนาที่ยาว: ในทุกข้อความใหม่ ไคลเอนต์จะส่งประวัติการสนทนาทั้งหมดไปยังโมเดลอีกครั้ง ดังนั้นข้อความที่ร้อยจะมีราคาแพงกว่าข้อความแรก วิธีแก้ไขคือการเริ่มบทสนทนาใหม่สำหรับงานใหม่ ซึ่งใน Cherry Studio สามารถทำได้ด้วยการคลิกเพียงปุ่มเดียว

วิธีใช้งาน	การชำระเงิน	สิ่งที่จะได้รับ
สมัครสมาชิกบริการแชท	ราคาคงที่ต่อเดือน	โมเดลจากผู้ให้บริการเดียว ในอินเทอร์เฟซของเขา พร้อมขีดจำกัดตามแผน
Cherry Studio + คีย์ของผู้ให้บริการ	จ่ายตามการใช้จริงตามราคาของผู้ให้บริการ	อินเทอร์เฟซและประวัติการสนทนาบนเครื่องของคุณเอง ค่าใช้จ่ายเพิ่มขึ้นตามปริมาณการใช้งาน
Cherry Studio + JoinGonka Gateway	จ่ายตามการใช้จริงตามราคาของเครือข่าย จากยอดเงินในเกตเวย์	โมเดลเปิดในเครือข่ายในราคาเดียว ดูยอดการใช้งานรายวัน รายคีย์ และรายโมเดลได้ในแผงควบคุม

ประโยชน์เพิ่มเติมจากการใช้งานร่วมกัน

การเปรียบเทียบโมเดลในแชทเดียว Cherry Studio สามารถถามคำถามเดียวกับหลายโมเดลพร้อมกันได้: เพียงเลือกโมเดลเหล่านั้นในตัวสลับโมเดล แล้วแต่ละโมเดลจะตอบกลับด้วยคำขอแยกต่างหาก ด้วยราคาเดียวสำหรับโมเดลทั้งหมดในเครือข่าย นี่คือวิธีที่เร็วที่สุดในการทำความเข้าใจว่างานของคุณต้องการ MiniMax M2.7, DeepSeek V4 Flash สำหรับคำตอบที่ยาว, หรือ GLM-5.3 Flash สำหรับการประมวลผลเชิงตรรกะ โดยมีการตั้งค่าอธิบายไว้ใน รีวิวโมเดล

โปรโตคอลที่สองด้วยคีย์เดียวกัน เกตเวย์ยังตอบกลับในรูปแบบ Anthropic ได้ ใน V2 จะมีบรรทัด Anthropic แยกต่างหากในบล็อก Endpoint settings ให้ใส่ https://gate.joingonka.ai และในช่อง Request path จะต้องได้พาธเป็น /v1/messages สำหรับ V1 ผลลัพธ์เดียวกันจะได้จาก Provider แยกต่างหากที่มี Provider Type เป็น Anthropic และที่อยู่เดียวกัน ภายใต้ปุ่ม More options ใน V2 ยังมีช่อง OpenAI Responses ซึ่งเกตเวย์รองรับด้วย โดยใช้ที่อยู่เดียวกับบรรทัดหลักของ OpenAI

การรัน Terminal Agents ในหน้า Code CLI (หรือ Coding Companion ในเอกสาร) Cherry Studio จะติดตั้งและรันเอเจนต์คอนโซลโดยใช้ Provider และโมเดลจากการตั้งค่า; รายการ Provider จะถูกกรองตามโปรโตคอลที่เครื่องมือนั้นๆ ต้องการ ดังนั้นจึงควรกรอกที่อยู่ Anthropic ไว้ล่วงหน้าหากคุณวางแผนจะรัน Claude Code จากที่นี่ สำหรับวิธีการตั้งค่าเอเจนต์เดียวกันโดยไม่มีตัวกลาง โปรดดูคำแนะนำ Claude Code + Gonka

ฐานความรู้ ใน V2 ฐานความรู้นี้ทำงานได้แม้ไม่มี Embedding model โดยใช้การค้นหาข้อความแบบ BM25 และหากใช้ Embedding model ระบบจะเปิดใช้งาน Hybrid search โมเดลของเครือข่าย Gonka เป็นแบบ generative ดังนั้นสำหรับการใช้งานแบบไฮบริด ให้เลือก Embedding model จาก Provider อื่น เช่น รันแบบโลคัลผ่าน Ollama โดยโมเดลของเกตเวย์จะเป็นผู้ตอบตามข้อมูลที่ค้นพบ

ต้องการแชทสำหรับทีมบนเบราว์เซอร์ใช่ไหม? Cherry Studio เป็นไคลเอนต์เดสก์ท็อปส่วนตัว สำหรับเว็บอินเทอร์เฟซแบบแชร์ที่มีบัญชีผู้ใช้ ให้ดูที่ Open WebUI ซึ่งสามารถเชื่อมต่อกับเกตเวย์โดยใช้ที่อยู่และคีย์เดียวกัน

Cherry Studio เชื่อมต่อกับ JoinGonka Gateway ในฐานะ Provider ของตัวเอง: ไปที่ Settings → Model Provider → Add Provider, ใส่ที่อยู่ https://gate.joingonka.ai/v1 และคีย์ jg- ไคลเอนต์จะเติมพาธ /chat/completions ให้เองและแสดงผลในช่อง Preview; เครื่องหมาย # ที่ท้ายที่อยู่จะปิดการเติมอัตโนมัติและไม่จำเป็นสำหรับเกตเวย์ จากนั้นให้เปิดใช้งาน Provider, เพิ่มโมเดลผ่าน Sync models, นำเครื่องหมาย Vision ออกจากโมเดลเหล่านั้น และตรวจสอบการเชื่อมต่อด้วยปุ่ม Model Check สำหรับโมเดลหลักแนะนำให้ใช้ DeepSeek V4 Flash, สำหรับงานเบื้องต้นใช้ MiniMax M2.7, และสำหรับงานตรรกะใช้ GLM-5.3 Flash; สามารถตรวจสอบปริมาณการใช้งานได้ที่แผงควบคุมของเกตเวย์ในส่วน «การใช้งาน» (Usage)

← Trae + JoinGonka Gateway — โมเดลเครือข่าย Gonka ใน AI-IDE omp (Oh My Pi) + JoinGonka Gateway: เอเจนต์พร้อมบทบาทโมเดล →

ต้องการเรียนรู้เพิ่มเติมหรือไม่?

สำรวจส่วนอื่นๆ หรือเริ่มรับ GNK ทันที

รับคีย์และโทเค็นฟรี →