Ikonekta ang Cherry Studio sa CheapTokens: custom provider, Base URL

Para gamitin ang CheapTokens sa Cherry Studio, magdagdag ng custom provider (Settings → Model Provider → Add Provider), ilagay ang https://api.cheaptokens.dev/v1/ sa OpenAI Base URL field, i-paste ang iyong API key at manu-manong idagdag ang model id na deepseek-ai/DeepSeek-V4-Flash-0731. Pagkatapos, i-check ang key gamit ang Model Check at mag-hello. Iyon lang ang buong gawain; ang tanging detalye na nakakalito ay ang slash sa dulo ng URL.

Binubuksan mo ang isang desktop chat app dahil gusto mo ng isang window para sa maraming modelo at isang balanse sa likod ng mga ito, hindi isang browser tab bawat serbisyo. Ginawa ang Cherry Studio para diyan: ito ay isang open-source AI workstation para sa Windows, macOS at Linux (AGPL-3.0 Community Edition) na may chat, agents at knowledge bases, at tumatanggap ito ng anumang OpenAI-compatible na serbisyo bilang custom provider. Nagsasalita ang CheapTokens sa OpenAI Chat Completions format, kaya bagay ito. Ang mga hakbang sa ibaba ay sumusunod sa Cherry Studio docs page tungkol sa custom providers, na sinuri noong 7 Nobyembre 2026; nagbabago ang app mismo, kaya kung may label na lumipat, hanapin ang parehong salita sa malapit.

Ano ang kailangan mo bago buksan ang app#

Tatlong bagay, lahat maikli:

• ang Base URL: https://api.cheaptokens.dev/v1/ (kasama ang trailing slash — ang dahilan ay nasa susunod na seksyon);
• isang API key mula sa iyong CheapTokens account, itago sa isang lugar kung saan makokopya mo ito, hindi i-paste sa isang shared note;
• ang buong model id. Ang short name mula sa price list ay hindi tinatanggap ng API; gamitin ang gateway id, halimbawa deepseek-ai/DeepSeek-V4-Flash-0731. Ang iba pang mga id ay nasa list-models guide at sa CheapTokens docs.

Idagdag ang custom provider#

Buksan ang Settings (ang gear icon), pagkatapos ang Model Provider. Sa ibaba ng provider list ay may + Add Provider. I-click ito at lalabas ang Add Custom Provider dialog.

Punan ito nang ganito:

Nagpapakita ang Cherry Studio ng 'OpenAI' at 'Anthropic' endpoint fields bilang default. Punan lamang ang protocol na aktwal mong ginagamit; para sa normal na chat, iyon ang OpenAI, at ang Anthropic field ay maaaring manatiling walang laman. Sa ilalim ng bawat Base URL field, nagpapakita ang app ng preview ng final request path. Basahin ito. Ito ang pinakamabilis na paraan para mahuli ang maling address bago ka magpadala ng kahit ano.

I-click ang Add para i-save.

Bakit mahalaga ang trailing slash#

Binubuo ng Cherry Studio ang request URL mula sa iyong Base URL gamit ang tatlong panuntunan sa docs nito (sinuri noong 7 Nobyembre 2026):

• ang root address tulad ng https://example.com ay dinadagdagan ng /v1/chat/completions;
• ang address na nagtatapos sa / ay dinadagdagan lamang ng chat/completions;
• ang address na nagtatapos sa # ay ginagamit nang eksakto kung paano ito na-type, walang idinagdag.

Nasa ilalim ng /v1 ang CheapTokens, kaya ang https://api.cheaptokens.dev/v1/ ang form na nagiging https://api.cheaptokens.dev/v1/chat/completions — ang path na inaasahan ng API. Ang preview sa ilalim ng field ay dapat eksaktong ganoon. Kung makikita mo ang /v1/v1/ o walang /v1, ayusin ang field bago magpatuloy.

Key, model at Model Check#

Bumalik sa page ng provider, may limang maliliit na hakbang. Gawin ang mga ito sa ganitong pagkakasunod-sunod:

Isang paalala sa hakbang 5. Mayroon ding Sync models button ang page na kumukuha ng model list mula sa serbisyo. Ang maaasahang paraan ay idagdag mo mismo ang id gamit ang +: i-type ang deepseek-ai/DeepSeek-V4-Flash-0731 nang eksakto, kasama ang deepseek-ai/ na bahagi. Aling mga modelo ang maaari mong idagdag:

Ang Model Check ay ang button sa tabi ng key field; ayon sa Cherry Studio docs, tinitiyak nito na valid ang key. Kung magreklamo ito, tumalon sa seksyon ng error sa ibaba: kadalasan ang sanhi ay isa sa tatlong field.

Ipadala ang unang mensahe#

Magbukas ng bagong chat, piliin ang CheapTokens provider at ang model na idinagdag mo sa model selector sa itaas, at magsulat ng maikli, tulad ng 'Explain what a token is in two sentences.' Ang sagot mula sa modelo ay nangangahulugang gumagana ang buong chain: key, address, model id.

Gusto mong makita ang isang request nang walang app? Narito ang isang plain Chat Completions call:

export CHEAPTOKENS_API_KEY="paste-your-key-here"

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-ai/DeepSeek-V4-Flash-0731", "messages": [{"role": "user", "content": "Explain what a token is in two sentences."}]}'

Ang sagot ay JSON na may teksto sa choices[0].message.content at ang token counts sa usage.

Aling modelo ang ilalagay sa desktop chat#

Iba ang trabaho ng chat window kaysa sa agent loop: nagtatanong ka, nagbabasa, nagtatanong muli. Dalawang bagay ang mahalaga: gaano kahaba ang mga sagot at gaano kalaki ang kasya sa isang usapan.

• DeepSeek-V4-Flash — ang default na piliin para sa pangkalahatang chat at mahahabang dokumento: hanggang 32,768 output tokens bawat sagot, 380K context, isang presyo sa anumang oras. Sa kabuuan, kasama ang input at output, mas mura ito kaysa OpenRouter.
• GLM-5.3-Flash — araw-araw na chat na may pinakamalaking window sa tatlo (390K), mas mura kaysa OpenRouter sa input at output.
• MiniMax-M2.7 — chat at agent-style na mga gawain na may 180K context, mas mura kaysa OpenRouter sa parehong panig.

Lahat ng tatlo ay nasa likod ng isang balanse, kaya maaari mong idagdag ang lahat ng tatlong id sa parehong provider at lumipat sa model selector nang hindi hinahawakan ang key.

Magkano ang isang chat session#

Narito ang isang magaspang na larawan. Sabihin nating mayroon kang 20-message na usapan. Bawat mensahe ay nagpapadala muli ng naunang history, kaya ang isang request ay may average na mga 6,000 tokens in at 500 tokens out (isang dahilan na tinalakay sa bakit mas mahal ang mahabang chat). Ang isang request sa DeepSeek-V4-Flash ay nagkakahalaga ng $0.00014. Dalawampu sa mga ito ay nasa calculator sa ibaba; ilipat ang sliders para tumugma sa sarili mong mga chat.

Ang table sa ibaba ay nagpapatakbo ng parehong session sa lahat ng modelo, na may OpenRouter column para sa paghahambing:

Para sa kasalukuyang presyo kada 1M tokens tingnan ang CheapTokens pricing.

Kung hindi ito gumana#

Karamihan ng problema ay nagmumula sa parehong tatlong field: key, URL, model id. Itugma ang nakikita mo sa sanhi:

Para sa mas mahabang walkthrough ng mga error na ito, tingnan ang API 401 o 404: maling key, base URL o model id. At kung mas gusto mo ang browser-based na chat kaysa desktop app, gumagana ang Open WebUI sa parehong paraan.

Sources: Cherry Studio docs, custom provider at provider settings pages, sinuri noong 7 Nobyembre 2026; ang proyekto ay nasa github.com/CherryHQ/cherry-studio.