Połącz Cherry Studio z CheapTokens: niestandardowy dostawca, Base URL

Aby używać CheapTokens w Cherry Studio, dodaj niestandardowego dostawcę (Settings → Model Provider → Add Provider), wpisz https://api.cheaptokens.dev/v1/ w polu OpenAI Base URL, wklej swój klucz API i dodaj ręcznie identyfikator modelu deepseek-ai/DeepSeek-V4-Flash-0731. Następnie sprawdź klucz za pomocą Model Check i powiedz cześć. To cała robota; jedyny szczegół, który potrafi ugryźć, to ukośnik na końcu URL-a.

Otwierasz aplikację czatu na pulpicie, bo chcesz jedno okno dla kilku modeli i jedno saldo za nimi, a nie kartę przeglądarki dla każdej usługi. Cherry Studio jest do tego stworzone: to otwartoźródłowa stacja robocza AI dla Windows, macOS i Linux (AGPL-3.0 Community Edition) z czatem, agentami i bazami wiedzy, która przyjmuje każdą usługę zgodną z OpenAI jako niestandardowego dostawcę. CheapTokens mówi formatem OpenAI Chat Completions, więc pasuje. Poniższe kroki opierają się na stronie dokumentacji Cherry Studio o niestandardowych dostawcach, sprawdzonej 7 listopada 2026; sama aplikacja się zmienia, więc jeśli jakaś etykieta się przeniosła, szukaj tego samego słowa w pobliżu.

Co potrzebujesz, zanim otworzysz aplikację#

Trzy rzeczy, wszystkie krótkie:

• Base URL: https://api.cheaptokens.dev/v1/ (z ukośnikiem na końcu — powód w następnej sekcji);
• klucz API ze swojego konta CheapTokens, trzymany w miejscu, z którego możesz go skopiować, a nie wklejony do współdzielonej notatki;
• pełny identyfikator modelu. Krótka nazwa z cennika nie jest akceptowana przez API; użyj identyfikatora bramy, na przykład deepseek-ai/DeepSeek-V4-Flash-0731. Pozostałe identyfikatory są w przewodniku po listowaniu modeli i w dokumentacji CheapTokens.

Dodaj niestandardowego dostawcę#

Otwórz Settings (ikona zębatki), potem Model Provider. Na dole listy dostawców jest + Add Provider. Kliknij go, a pojawi się okno Add Custom Provider.

Wypełnij je tak:

Cherry Studio domyślnie pokazuje pola endpointów 'OpenAI' i 'Anthropic'. Wypełnij tylko protokół, którego faktycznie używasz; dla zwykłego czatu to ten OpenAI, a pole Anthropic może zostać puste. Pod każdym polem Base URL aplikacja pokazuje podgląd końcowej ścieżki żądania. Przeczytaj go. To najszybszy sposób, by wyłapać zły adres, zanim cokolwiek wyślesz.

Kliknij Add, aby zapisać.

Dlaczego ukośnik na końcu ma znaczenie#

Cherry Studio buduje URL żądania z twojego Base URL według trzech reguł ze swojej dokumentacji (sprawdzonej 7 listopada 2026):

• do adresu głównego, jak https://example.com, dopisywane jest /v1/chat/completions;
• do adresu kończącego się na / dopisywane jest tylko chat/completions;
• adres kończący się na # jest używany dokładnie tak, jak wpisany, bez niczego dodawanego.

CheapTokens działa pod /v1, więc https://api.cheaptokens.dev/v1/ to forma, która zamienia się w https://api.cheaptokens.dev/v1/chat/completions — ścieżkę, której oczekuje API. Podgląd pod polem powinien pokazywać dokładnie to. Jeśli widzisz /v1/v1/ albo w ogóle brak /v1, popraw pole, zanim przejdziesz dalej.

Klucz, model i Model Check#

Z powrotem na stronie dostawcy jest pięć małych kroków. Zrób je w tej kolejności:

Uwaga do kroku 5. Strona ma też przycisk Sync models, który pobiera listę modeli z usługi. Niezawodna droga to dodanie identyfikatora samodzielnie przyciskiem +: wpisz deepseek-ai/DeepSeek-V4-Flash-0731 dokładnie, z częścią deepseek-ai/. Które modele możesz dodać:

Model Check to przycisk obok pola klucza; według dokumentacji Cherry Studio sprawdza, czy klucz jest ważny. Jeśli zgłasza błąd, przejdź do sekcji błędów poniżej: przyczyną jest zwykle jedno z trzech pól.

Wyślij pierwszą wiadomość#

Otwórz nowy czat, wybierz dostawcę CheapTokens i model dodany w selektorze modeli u góry, i napisz coś krótkiego, na przykład 'Wyjaśnij w dwóch zdaniach, czym jest token.' Odpowiedź modelu oznacza, że cały łańcuch działa: klucz, adres, identyfikator modelu.

Chcesz zobaczyć żądanie bez aplikacji? Oto zwykłe wywołanie Chat Completions:

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."}]}'

Odpowiedź to JSON z tekstem w choices[0].message.content i liczbami tokenów w usage.

Który model wybrać do czatu na pulpicie#

Okno czatu to inne zadanie niż pętla agenta: pytasz, czytasz, pytasz znowu. Wtedy liczą się dwie rzeczy: jak długie mogą być odpowiedzi i jak duża rozmowa się mieści.

• DeepSeek-V4-Flash — domyślny wybór do ogólnego czatu i długich dokumentów: do 32 768 tokenów wyjściowych na odpowiedź, kontekst 380K, jedna cena o każdej porze. Łącznie, licząc wejście i wyjście razem, jest tańszy niż OpenRouter.
• GLM-5.3-Flash — codzienny czat z największym oknem z trzech (390K), tańszy niż OpenRouter zarówno na wejściu, jak i na wyjściu.
• MiniMax-M2.7 — czat i zadania w stylu agenta z kontekstem 180K, tańszy niż OpenRouter po obu stronach.

Wszystkie trzy stoją za jednym saldem, więc możesz dodać wszystkie trzy identyfikatory do tego samego dostawcy i przełączać się w selektorze modeli bez dotykania klucza.

Ile kosztuje sesja czatu#

Oto przybliżony obraz. Załóżmy, że masz rozmowę na 20 wiadomości. Każda wiadomość wysyła ponownie wcześniejszą historię, więc żądanie średnio ma około 6000 tokenów wejściowych i 500 tokenów wyjściowych (powód omówiony w dlaczego długi czat kosztuje więcej). Jedno żądanie na DeepSeek-V4-Flash kosztuje $0.00014. Dwadzieścia z nich jest w kalkulatorze poniżej; przesuń suwaki, aby dopasować do własnych czatów.

Poniższa tabela przeprowadza tę samą sesję na wszystkich modelach, z kolumną OpenRouter do porównania:

Aktualne ceny za 1M tokenów znajdziesz w cenniku CheapTokens.

Jeśli nie działa#

Większość problemów pochodzi z tych samych trzech pól: klucz, URL, identyfikator modelu. Dopasuj to, co widzisz, do przyczyny:

Szerszy opis tych błędów znajdziesz w API 401 lub 404: zły klucz, base URL lub identyfikator modelu. A jeśli wolisz czat w przeglądarce zamiast aplikacji na pulpicie, Open WebUI działa w ten sam sposób.

Źródła: dokumentacja Cherry Studio, strony o niestandardowym dostawcy i ustawieniach dostawcy, sprawdzone 7 listopada 2026; projekt jest na github.com/CherryHQ/cherry-studio.