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

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

ถ้ามีอะไรผิดพลาด สาเหตุอ่านได้จากคำตอบเกือบทุกครั้ง:

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

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