Cherry Studio + JoinGonka Gateway — desktop AI client

Pag-install. Ang mga build para sa lahat ng system ay nasa page ng releases ng proyekto: installer at portable build para sa Windows, dmg image para sa macOS, AppImage, deb at rpm para sa Linux — para sa x64 at ARM. Ang history ng mga usapan at mga setting ay naka-imbak nang lokal, sa iyong makina.

V1 o V2. Noong Agosto 2026, inilabas ang V2 lineup na may bagong data structure at muling ginawang mga setting; ang huling build ng dating lineup ay 1.9.13. May sariling provider sa pareho, naiiba ang paraan ng pagdagdag at ang ilang mga label — sa ibaba, ang mga ganitong lugar ay may marka. Kapag lumilipat mula V1, awtomatikong naililipat ang mga setting ng provider at mga modelo, ang orihinal na data ng V1 ay napanatili, ngunit ang bagong data ay hindi nagsi-sync pabalik, at ang mga backup ng dalawang lineup ay hindi compatible. Bago mag-update, basahin ang seksyon tungkol sa migration sa dokumentasyon ng Cherry Studio.

JoinGonka key. Magrehistro sa gateway, buksan sa dashboard ang seksyong «API keys» at pindutin ang «Create key». Nagsisimula ang key sa jg- at ipinapakita nang isang beses lamang — i-save ito agad. Maginhawang gumawa ng hiwalay na key para sa Cherry Studio: sa seksyong «Usage», makikita ang gastos nito sa hiwalay na linya.

1. I-tap ang icon ng gear — magbubukas ang mga setting. Piliin ang seksyong Model Provider (sa dokumentasyong Ingles, tinatawag itong Model Services).
2. Sa ilalim ng listahan ng mga provider, i-tap ang Add Provider.
3. Sa V2, magbubukas ang dialog na Add Custom Provider. Ilagay ang Provider Name — halimbawa, JoinGonka. Sa bloke na Endpoint settings, punan ang OpenAI line ng address na https://gate.joingonka.ai/v1: lalabas sa ilalim ng field ang linyang Request path na may huling path — dapat itong magtapos sa /v1/chat/completions. Sa field na API Key, i-paste ang jg-your-key at i-tap ang Add.
4. Sa V1, mas maikli ang dialog: pangalan ng provider at Provider Type — piliin ang OpenAI. Ang key at address ay inilalagay na sa page ng provider, sa mga field na API Key at API Host.
5. Tiyakin na naka-enable ang provider: nasa kanang itaas na sulok ng page nito ang toggle. Sa V2, ang mga bagong provider ay idinadagdag na naka-off, at ang mga modelo ng naka-off na provider ay hindi lumalabas sa mga listahan ng pagpipilian.

Paano binubuo ng Cherry Studio ang address. Ang field na API Host ay tumatanggap ng base address, at ang path ay ang app na mismo ang nagdaragdag at ipinapakita ang resulta sa linyang Preview sa ilalim ng field. Pareho ang mga patakaran sa dalawang linya:

Sa mga lumang instruksiyon, may isa pang patakaran: ang slash sa dulo ng address ay diumano'y nagpapawalang-bisa sa /v1. Gumagana ito sa mga unang bersyon, hanggang sa linyang 1.6, at inalis sa 1.7: sa mga kasalukuyang build, ang # lang ang nagpapawalang-bisa sa auto-substitution.

Ang provider ay naidagdag na, ngunit hindi pa ito nakikita sa chat: tanging ang mga modelong malinaw mong idinagdag ang napupunta sa mga selection list ng Cherry Studio. May dalawang paraan.

Listahan mula sa server. Sa pahina ng provider, i-click ang Sync models (sa V1 — Manage, pagkatapos ay Fetch model list). Mag-re-request ang Cherry Studio sa gateway ng GET /v1/models at ipapakita ang live na listahan ng network; idagdag ang mga kailangang modelo gamit ang + button. Manual. Ang Add Model button ay nagbubukas ng form kung saan kinakailangan ang isang field — Model ID: ang identifier ay ipinapasok nang eksakto, karakter por karakter.

Ang presyo ng mga modelo sa network ay pareho, kaya idagdag silang lahat — pipili ka sa pagitan nila batay sa behavior, hindi sa budget:

Mga uri ng modelo. Ang bawat modelo sa listahan ay may settings button kung saan minamarkahan ang mga kakayahan nito: Vision, Reasoning, Tool, at iba pa. Ang ilang marka ay kusa nang inilalagay ng Cherry Studio, ngunit para sa mga gateway model, dapat itong suriin. Ang Vision ay dapat tanggalin: ang mga modelo ng network ay text-based. Ang Tool ay kailangan kung gumagamit ka ng mga MCP-tool — ang lahat ng modelo sa talahanayan ay sumusuporta sa native tool calling. Ang Reasoning ay angkop para sa GLM-5.3 Flash — ito ang reasoning-model ng network.

Default model. Sa seksyon ng settings na Default Model, itinatakda ang mga modelo para sa mga utility role. Gawing pangunahing assistant model ang DeepSeek V4 Flash. Para sa mabilis na modelo na gumagawa ng mga pangalan ng chat at naghahanda ng mga search query, inirerekomenda ng Cherry Studio documentation ang isang magaan at mabilis na modelo na hindi reasoning — sa mga modelo ng network, ang MiniMax M2.7 ang pinakaangkop dito, at huwag ilagay ang GLM-5.3 Flash dahil sa obligadong reasoning nito. Para sa pagsasalin, ang alinman sa unang dalawa ay angkop.

Sa pahina ng provider sa block ng key, may button na Model Check (sa V1 — Check katabi ng field ng key). Pumili ng model — magpapadala ang Cherry Studio ng maikling test request dito at ipapakita ang resulta kasama ang response latency. Kung matagumpay ang check — pumunta sa chat, piliin ang model ng gateway sa model switcher at magtanong ng kahit ano.

Para masiguradong dumadaan ang mga request sa gateway, buksan ang dashboard nito, sa section na “Usage”: sa block na “By keys” para sa key ng Cherry Studio, lalabas ang mga request at oras ng huling paggamit, sa block na “By models” — ang napiling model. Sa V2, may sariling statistics ang client, sa settings section na Usage: tokens at requests ayon sa providers, models, at keys. Ang halaga doon ay para sa sanggunian lamang — tinatantiya ito ng Cherry Studio batay sa mga pampublikong presyo ng mga model, at hindi sa presyo ng network na Gonka, kaya tingnan ang eksaktong halaga sa dashboard ng gateway.

Kung may hindi gumana, ang dahilan ay halos palaging mababasa sa response:

Libre ang mismong client, babayaran mo lang ay ang inference. Sa pamamagitan ng JoinGonka Gateway, ang mga token ay nagkakahalaga ng $0.0069 bawat milyon sa input at $0.021 bawat milyon sa output — ang presyo ay pareho para sa lahat ng model sa network at kinukuha sa pahinang ito mula sa live source. Mas matipid ang chat sa tokens kumpara sa mga agent tool, kaya ang pagkakasunod-sunod ng halaga base sa presyo noong Setyembre 2026 ay ganito:

Mahalagang paalala tungkol sa mahahabang dialogue: sa bawat reply, ipinapadala ng client sa model ang buong history ulit, kaya mas mahal ang pang-isandaang reply kaysa sa una. Ang solusyon — bagong dialogue para sa bagong task; sa Cherry Studio, isang pindot lang ito.

Paghahambing ng mga modelo sa isang dialogue. Kayang magtanong ng Cherry Studio sa maraming modelo nang sabay-sabay: piliin ang mga ito sa model switcher, at sasagot ang bawat isa sa pamamagitan ng magkahiwalay na request. Dahil pare-pareho ang presyo sa lahat ng mga modelo sa network, ito ang pinakamabilis na paraan upang malaman sa iyong mga gawain kung saan sapat na ang MiniMax M2.7, saan kailangan ang mahabang sagot ng DeepSeek V4 Flash, at saan sulit ang pangangatwiran ng GLM-5.3 Flash — ang mga setting nito ay tinalakay sa review ng modelo.

Pangalawang protocol gamit ang parehong key. Ang gateway ay tumutugon din sa format na Anthropic. Sa V2 dialogue, mayroong hiwalay na linyang Anthropic sa block na Endpoint settings: ilagay doon ang https://gate.joingonka.ai, at sa linyang Request path, dapat ay lumabas ang path na /v1/messages. Sa V1, ang parehong resulta ay ibinibigay ng hiwalay na provider na may Provider Type na Anthropic at parehong address. Sa ilalim ng button na More options sa V2, mayroon ding linyang OpenAI Responses — sineserbisyuhan din ito ng gateway, ang address ay pareho sa pangunahing linyang OpenAI.

Pagpapatakbo ng mga terminal agent. Sa pahinang Code CLI (sa dokumentasyon — Coding Companion), nag-i-install at nagpapatakbo ang Cherry Studio ng mga console agent sa pamamagitan ng paglalagay ng provider at modelo mula sa sarili nitong mga setting; ang listahan ng mga provider doon ay sinasala ayon sa protocol na kinakailangan ng partikular na tool. Kaya naman, dapat punan ang Anthropic address nang maaga kung balak mong magpatakbo ng Claude Code mula rito. Kung paano i-configure ang parehong agent nang walang tagapamagitan — basahin sa gabay na Claude Code + Gonka.

Knowledge base. Sa V2, gumagana ito kahit walang embedding model — base sa text search na BM25, at kasama ang embedding model, magkakaroon ng hybrid search. Ang mga modelo ng network na Gonka ay generative, kaya para sa hybrid mode, kumuha ng embedding model mula sa ibang provider, halimbawa ay lokal sa pamamagitan ng Ollama; ang gateway model ang sasagot gamit ang mga natagpuang fragment.

Kailangan ng shared chat para sa team sa browser? Ang Cherry Studio ay isang personal na desktop client. Para sa shared web interface na may mga account, tingnan ang Open WebUI: kumokonekta ito sa gateway gamit ang parehong address at key.