Dodaj każdy model z katalogu do Cherry Studio jako jednego providera.

Updated 2026-07-29

Ustawienia Model Services w Cherry Studio akceptują dowolny endpoint kompatybilny z OpenAI: dodaj providera z typem OpenAI, wskaż adres API na api.apisrouter.com, wklej jeden klucz i dodaj identyfikatory modeli ręcznie. Claude, GPT, DeepSeek, GLM, Kimi i Qwen siedzą w jednym pickerze na desktopie.

Szybka odpowiedź: jeden provider w Model Services.

Kliknij ikonę zębatki w lewej nawigacji Cherry Studio, otwórz zakładkę Model Services i kliknij przycisk Add pod listą providerów. Nadaj providerowi rozpoznawalną nazwę (APIsRouter) i wybierz OpenAI jako typ providera, a następnie zapisz. Teraz wybierz nowego providera z listy i skonfiguruj go: przełącz jego przełącznik włączenia, wklej swój klucz w pole API key i ustaw adres API na https://api.apisrouter.com. Zwróć uwagę na kształt: udokumentowanym domyślnym zachowaniem Cherry Studio jest przyjęcie adresu głównego i samodzielne doklejenie /v1/chat/completions, więc host wpisujesz bez /v1. Następnie dodaj modele przyciskiem Add w sekcji modeli, po jednym dokładnym identyfikatorze z katalogu na wpis (claude-sonnet-4-6, deepseek-v4-flash, glm-5.2), i naciśnij przycisk Check obok klucza, żeby uruchomić walidację na żywo względem wybranego modelu.

Provider name:  APIsRouter
Provider type:  OpenAI

then, on the provider page:
API key:        sk-YOUR-APISROUTER-KEY
API address:    https://api.apisrouter.com
                (Cherry appends /v1/chat/completions)
Models → + Add: claude-sonnet-4-6, deepseek-v4-flash, glm-5.2
Check → pick a model → success

Jak Cherry Studio składa URL żądania.

Cherry Studio (CherryHQ na GitHubie, ok. 49 tys. gwiazdek) to desktopowy klient chińskiego pochodzenia dla Windowsa, macOS i Linuksa, znany z dostarczania presetów dla setek providerów i asystentów. Wszystko, czego nie ma na liście presetów, wchodzi przez opisany wyżej przepływ niestandardowego providera, a częścią wartą zrozumienia jest pole adresu API. Udokumentowane domyślne zachowanie: podajesz adres główny, a Cherry Studio dokleja do niego trasę OpenAI, więc https://api.apisrouter.com staje się na drucie https://api.apisrouter.com/v1/chat/completions. Jeśli provider używa niestandardowej ścieżki, zakończenie adresu znakiem # całkowicie wyłącza doklejanie, a adres jest używany dokładnie tak, jak wpisany, co jest udokumentowaną furtką awaryjną. Zachowanie doklejania wokół ukośników końcowych zmieniało się między wydaniami, więc jeśli żądania kończą się 404, przeczytaj finalny URL w błędzie zamiast zgadywać; forma adresu głównego plus automatyczne doklejanie to stabilna konfiguracja dla standardowej bramki /v1. Po skonfigurowaniu każda konwersacja wysyła standardowe chat completions z dodanym identyfikatorem modelu jako zwykłym stringiem. Dostawcy nie mają znaczenia dla formatu na drucie, co pozwala jednemu wpisowi providera nieść razem chińskie i zachodnie identyfikatory z katalogu.

Szczegóły, które się opłacają: rotacja kluczy i zarządzanie modelami.

Pole API key akceptuje więcej niż jeden klucz: rozdziel klucze angielskimi przecinkami, a Cherry Studio rotuje między nimi od góry do dołu per żądanie — to udokumentowana funkcja load balancingu. Przy bramce mierzącej per klucz, to działa też jako atrybucja: jeden klucz do pracy, jeden prywatny, rotacja wyłączona przez wpisanie tylko jednego. Wpisy modeli są ręczne i to jest cecha, nie ograniczenie. Cherry Studio pokazuje dokładnie to, co dodasz, więc picker pozostaje wyselekcjonowany zamiast tonąć w pobranym katalogu. Każdy wpis przyjmuje identyfikator jako string na drucie; przycisk Manage później edytuje albo usuwa wpisy. Grupuj powiązane identyfikatory spójnym nazewnictwem, a picker czyta się jak menu: tier szybki (deepseek-v4-flash, claude-haiku-4-5-20251001), siła regionalna (glm-5.2, qwen3.7-plus, kimi-k2.6), flagowiec (claude-sonnet-4-6). Przycisk Check waliduje parę klucz i adres względem wybranego modelu, i to najszybszy sposób, żeby potwierdzić providera przed prawdziwymi konwersacjami. Nieudany check przy poprawnym kluczu prawie zawsze oznacza, że pole adresu niesie przypadkowe /v1, które podwoiło ścieżkę.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50
# add these ids verbatim in the provider's model list

Dobór modeli do desktopowego konia roboczego.

Jeden klucz oznacza, że porównania to przełączniki w pickerze. Uruchom ten sam tydzień pracy na dwóch kandydujących identyfikatorach i pozwól, żeby wydatek per model w konsoli APIsRouter sędziował obok Twojej własnej oceny jakości wyniku.

  • Codzienny czat i szybkie przeróbki żyją na szybkim tierze: deepseek-v4-flash i claude-haiku-4-5-20251001 sprawiają, że zawsze otwarte okno wydaje się darmowe.
  • Praca w języku chińskim to miejsce, gdzie regionalne identyfikatory zarabiają na swoje wiersze: glm-5.2 i qwen3.7-plus do szkicowania i dokumentów, kimi-k2.6 do czytania z długim kontekstem.
  • claude-sonnet-4-6 przejmuje konwersacje, które przekazujesz bez edycji: staranną analizę, prozę skierowaną do klientów, kod, który zamierzasz wypuścić.
  • Asystenci Cherry Studio mogą przypiąć własny model per rola, więc asystent do tłumaczeń na glm-5.2 i asystent do kodowania na claude-sonnet-4-6 współistnieją za jednym providerem.
  • Dodawaj wiersze świadomie; wyselekcjonowany picker z sześcioma modelami jest używany, podczas gdy wklejony cały katalog jest przewijany.

Płatność za użycie · poniżej cen oficjalnych

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

ModelCena oficjalnaNasza cena
Claude Sonnet 4.6$3.00 / $15.00 per M$2.40 / $12.00 per M
DeepSeek V4 Flash$0.14 / $0.28 per M$0.10 / $0.30 per M
GLM-5.2$1.14 / $4.00 per M$1.10 / $4.00 per M
Kimi K2.6$0.95 / $4.00 per M$1.00 / $4.00 per M
Qwen 3.7 Plus$0.29 / $1.14 per M$0.30 / $1.10 per M

Tryby awarii charakterystyczne dla Cherry Studio.

Podwojona ścieżka to najczęstsze zgłoszenie: wklejenie https://api.apisrouter.com/v1 w pole, które dokleja /v1/chat/completions, produkuje URL-e /v1/v1, które kończą się 404. Wpisz adres główny i pozwól klientowi zbudować trasę. Jeśli musisz przypiąć dokładny URL, istnieje do tego forma z końcowym #. Nieudany Check przy dobrym kluczu to zwykle powyższy kształt adresu; nieudany Check przy czystym adresie to klucz, a zauważ, że wiele kluczy musi być rozdzielonych angielskimi przecinkami, bo znaki pełnej szerokości wklejone z chińskich metod wprowadzania po cichu psują listę. Modele zawodzące pojedynczo, gdy inne działają, to problem z pisownią identyfikatora; wpisy to wolny tekst, a lista /v1/models to autorytatywne źródło. I pamiętaj, że ustawienia są per komputer: provider skonfigurowany na Twoim desktopie nie istnieje na laptopie, dopóki nie powtórzysz dwuminutowej konfiguracji albo nie użyjesz własnych funkcji backupu Cherry Studio. Uwaga o dryfie wersji: Cherry Studio wydaje aktualizacje często, a etykiety ustawień się przesuwają (Model Services pojawiało się też jako Model Provider w niektórych buildach); przepływ dodaj providera, wybierz typ OpenAI, klucz, adres, modele pozostał stabilny.

Kto kieruje Cherry Studio przez bramkę.

  • Dwujęzyczni użytkownicy desktopu mieszający GLM, Qwen, Kimi i DeepSeek z Claude i GPT w jednym pickerze, na jednym saldzie, bez kont per dostawca.
  • Użytkownicy w Azji, którzy chcą mieć identyfikatory Claude i GPT na przedpłaconym saldzie bez zachodniej karty, obok regionalnych modeli, których już używają.
  • Zaawansowani użytkownicy uruchamiający asystentów Cherry Studio per rola, którzy chcą, żeby każdy asystent był przypięty do właściwego dostawcy bez zarządzania pięcioma kluczami.
  • Osoby, które już kierują inne narzędzia przez bramkę i chcą, żeby klient desktopowy działał na tym samym kluczu i logu użycia.
  • Każdy, kto porównuje modele regionalne i zachodnie na prawdziwej codziennej pracy zamiast na benchmarkach, gdzie każdy kandydat to jeden wiersz modelu.

Zweryfikuj endpoint i debuguj pierwszą konwersację.

Najpierw sprawdź curlem listę modeli i skopiuj identyfikatory, które planujesz dodać; następnie uruchom jedno chat completion na zamierzonym modelu do codziennego użytku. Jeśli oba przejdą, wszystko, co zostało, leży na stronie providera. Wewnątrz Cherry Studio uruchom Check przed rozpoczęciem czatu. Awarie uwierzytelniania to pole klucza albo jego separatory przecinkowe. 404 to kształt adresu; przeczytaj złożony URL w błędzie i policz segmenty /v1. Błędy not-found na konkretnym modelu to pisownia identyfikatora w tym wierszu. Gdy konwersacje już płyną, konsola APIsRouter pokazuje model per żądanie, liczbę tokenów i wydatki. Klient desktopowy używany przez cały dzień pracy generuje stały strumień małych żądań, a widok użycia per klucz zamienia ten strumień w liczby per model, per dzień, z chińskimi i zachodnimi identyfikatorami na tej samej stronie.

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash",
       "messages":[{"role":"user","content":"ping"}]}'

Częste pytania

Jak dodać niestandardowego providera w Cherry Studio?

Ikona zębatki, zakładka Model Services, Add. Nadaj nazwę providerowi, wybierz typ OpenAI, zapisz, a następnie na jego stronie włącz go, wklej swój klucz, ustaw adres API na https://api.apisrouter.com i dodaj identyfikatory modeli ręcznie. Zwaliduj przyciskiem Check.

Czy adres API powinien zawierać /v1?

Nie. Udokumentowane domyślne zachowanie Cherry Studio przyjmuje adres główny i samodzielnie dokleja /v1/chat/completions, więc wpisz https://api.apisrouter.com. Wklejenie hosta z /v1 podwaja ścieżkę i daje 404. Żeby przypiąć dokładny, niestandardowy URL, zakończ adres znakiem #, żeby wyłączyć doklejanie.

Czy Cherry Studio może uruchamiać Claude, DeepSeek i GLM przez jednego providera?

Tak. Identyfikator każdego wiersza modelu podróżuje do adresu jako zwykły string, więc claude-sonnet-4-6, deepseek-v4-flash, glm-5.2, kimi-k2.6 i qwen3.7-plus mogą współdzielić jeden wpis providera i jeden klucz, przełączalne per konwersacja i per asystent.

Co robi funkcja kluczy rozdzielonych przecinkami?

Wiele kluczy w polu API key, rozdzielonych angielskimi przecinkami, jest rotowanych od góry do dołu między żądaniami — to wbudowana funkcja load balancingu. Przy mierzeniu per klucz po stronie bramki działa też jako atrybucja; wpisz pojedynczy klucz, żeby rotacja pozostała wyłączona.

Dlaczego przycisk Check zawodzi?

Przy poprawnym kluczu zwykłą przyczyną jest adres niosący przypadkowe /v1, które podwaja złożoną ścieżkę. Przy czystym adresie sprawdź ponownie klucz i jego separatory; przecinki pełnej szerokości z chińskich metod wprowadzania po cichu psują listy wielu kluczy.

Dlaczego modele nie wypełniają się automatycznie jak u presetowych providerów?

Niestandardowi providerzy listują dokładnie to, co dodasz; Cherry Studio nie pobiera katalogu niestandardowego endpointu. To utrzymuje picker wyselekcjonowany. Pobierz identyfikatory z listy /v1/models i dodaj te, których faktycznie używasz, a listę rozszerz w dniu, w którym potrzebujesz kolejnego.