Voeg elk catalogusmodel toe aan Cherry Studio als één provider.

Updated 2026-07-29

De Model Services-instellingen van Cherry Studio accepteren elk OpenAI-compatibel endpoint: voeg een provider toe met het type OpenAI, wijs het API-adres naar api.apisrouter.com, plak één sleutel, en voeg model-ID's handmatig toe. Claude, GPT, DeepSeek, GLM, Kimi en Qwen staan in één kiezer op de desktop.

Snel antwoord: één provider in Model Services.

Klik op het tandwielicoon in de linkernavigatie van Cherry Studio, open het tabblad Model Services, en klik op de knop Add onder de providerlijst. Geef de provider een herkenbare naam (APIsRouter) en kies OpenAI als providertype, en sla dan op. Selecteer nu de nieuwe provider in de lijst en configureer hem: zet zijn aan/uit-schakelaar aan, plak je sleutel in het veld API key, en stel het API-adres in op https://api.apisrouter.com. Let op de vorm: de gedocumenteerde standaard van Cherry Studio is om het rootadres te nemen en zelf /v1/chat/completions toe te voegen, dus voer je de host in zonder /v1. Voeg vervolgens modellen toe met de knop Add in de modelsectie, één exact catalogus-ID per vermelding (claude-sonnet-4-6, deepseek-v4-flash, glm-5.2), en druk op de knop Check naast de sleutel om een live validatie te draaien tegen een geselecteerd model.

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

Hoe Cherry Studio de verzoek-URL samenstelt.

Cherry Studio (CherryHQ op GitHub, ruim 49K sterren) is een desktopclient van Chinese oorsprong voor Windows, macOS en Linux, bekend om het meeleveren van presets voor honderden providers en assistenten. Alles wat niet in de presetlijst staat, komt binnen via de bovenstaande flow voor aangepaste providers, en het deel dat het waard is om te begrijpen, is het veld API address. De gedocumenteerde standaard: jij levert het rootadres, en Cherry Studio voegt de OpenAI-route eraan toe, zodat https://api.apisrouter.com op de lijn https://api.apisrouter.com/v1/chat/completions wordt. Als een provider een niet-standaard pad gebruikt, schakelt het adres laten eindigen op # de aaneenschakeling volledig uit en wordt het adres exact gebruikt zoals getypt, wat het gedocumenteerde ontsnappingsluik is. Het aaneenschakelingsgedrag rond trailing slashes is tussen releases verschoven, dus als verzoeken 404'en, lees dan de uiteindelijke URL in de foutmelding in plaats van te gokken; de vorm met rootadres plus automatisch toevoegen is de stabiele configuratie voor een standaard /v1-gateway. Eenmaal geconfigureerd, stuurt elk gesprek standaard chat completions met het model-ID dat je hebt toegevoegd als platte string. Leveranciers maken niet uit voor het wire-formaat, en dat is wat één providervermelding Chinese en westerse catalogus-ID's samen laat dragen.

Details die hun plek verdienen: multi-key en modelbeheer.

Het veld API key accepteert meer dan één sleutel: scheid sleutels met Engelse komma's en Cherry Studio roteert er per verzoek van boven naar beneden doorheen, een gedocumenteerde load-balancingfunctie. Bij een gateway die per sleutel meet, dient dit ook als attributie: één sleutel voor werk, één voor privé, rotatie uit door er maar één te vermelden. Modelvermeldingen zijn handmatig en dat is een feature. Cherry Studio toont precies wat je toevoegt, dus de kiezer blijft gecureerd in plaats van te verdrinken in een opgehaalde catalogus. Elke vermelding neemt het ID als wire-string; de knop Manage bewerkt of verwijdert vermeldingen later. Groepeer verwante ID's met consistente naamgeving en de kiezer leest als een menu: snelle laag (deepseek-v4-flash, claude-haiku-4-5-20251001), regionale kracht (glm-5.2, qwen3.7-plus, kimi-k2.6), frontier (claude-sonnet-4-6). De knop Check valideert het paar van sleutel en adres tegen een model dat je selecteert, en het is de snelste manier om de provider te bevestigen vóór echte gesprekken. Een mislukte check met een correcte sleutel betekent bijna altijd dat het adresveld een overtollige /v1 draagt die het pad heeft verdubbeld.

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

Modellen kiezen voor een desktop-workhorse.

Eén sleutel betekent dat vergelijkingen kiezerswissels zijn. Draai dezelfde week werk op twee kandidaat-ID's en laat de uitgaven per model in de APIsRouter-console arbiteren naast je eigen beoordeling van de outputkwaliteit.

  • Dagelijkse chat en snelle herschrijvingen leven op de snelle laag: deepseek-v4-flash en claude-haiku-4-5-20251001 houden het altijd-open venster gratis aanvoelen.
  • Chinees-talig werk is waar de regionale ID's hun rijen verdienen: glm-5.2 en qwen3.7-plus voor opstellen en documenten, kimi-k2.6 voor langecontext-lezen.
  • claude-sonnet-4-6 neemt de gesprekken die je onbewerkt doorstuurt: zorgvuldige analyse, klantgerichte proza, code die je van plan bent te shippen.
  • De assistenten van Cherry Studio kunnen hun eigen model per rol vastpinnen, zodat een vertaalassistent op glm-5.2 en een coderingsassistent op claude-sonnet-4-6 naast elkaar bestaan achter één provider.
  • Voeg rijen bewust toe; een gecureerde kiezer met zes modellen wordt gebruikt, terwijl een geplakte hele catalogus wordt gescrold.

Betaal naar gebruik · onder officiële prijzen

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

ModelOfficiële prijsOnze prijs
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

Faalmodi specifiek voor Cherry Studio.

Het verdubbelde pad is de meest gemelde fout: https://api.apisrouter.com/v1 plakken in een veld dat /v1/chat/completions toevoegt, produceert /v1/v1-URL's die 404'en. Voer het rootadres in en laat de client de route bouwen. Moet je een exacte URL vastpinnen, dan bestaat daarvoor de vorm met een afsluitende #. Een mislukte Check met een goede sleutel is meestal de bovenstaande adresvorm; een mislukte Check met een schoon adres is de sleutel, en let erop dat meerdere sleutels gescheiden moeten worden door Engelse komma's, aangezien full-width tekens die uit Chinese invoermethodes zijn geplakt, de lijst stilletjes breken. Modellen die individueel fouten geven terwijl andere werken, is een probleem met de spelling van het ID; vermeldingen zijn vrije tekst en de /v1/models-lijst is de gezaghebbende bron. En onthoud dat instellingen per machine zijn: een provider die op je desktop is geconfigureerd, bestaat niet op je laptop totdat je de twee minuten durende instelling herhaalt of de eigen back-upfuncties van Cherry Studio gebruikt. Opmerking over versiedrift: Cherry Studio verschijnt frequent en instellingslabels verschuiven (Model Services is in sommige builds ook verschenen als Model Provider); de flow van provider toevoegen, type OpenAI kiezen, sleutel, adres, modellen is stabiel gebleven.

Wie routeert Cherry Studio via een gateway.

  • Tweetalige desktopgebruikers die GLM, Qwen, Kimi en DeepSeek mixen met Claude en GPT in één kiezer, één saldo, geen accounts per leverancier.
  • Gebruikers in Azië die Claude- en GPT-ID's willen op een vooruitbetaald tegoed zonder westerse kaart, naast de regionale modellen die ze al gebruiken.
  • Powerusers die Cherry Studio-assistenten per rol draaien en elke assistent aan de juiste leverancier willen vastpinnen zonder vijf sleutels te beheren.
  • Mensen die al andere tools via een gateway routeren en de desktopclient op dezelfde sleutel en hetzelfde gebruikslogboek willen.
  • Iedereen die regionale en westerse modellen vergelijkt op echt dagelijks werk in plaats van benchmarks, waar elke kandidaat één modelrij is.

Verifieer het endpoint en debug het eerste gesprek.

Curl eerst de modellijst op en kopieer de ID's die je van plan bent toe te voegen; draai vervolgens één chat completion tegen je beoogde dagelijkse workhorse. Als beide slagen, zit alles wat overblijft op de providerpagina. Draai binnen Cherry Studio Check voordat je gaat chatten. Authenticatiefouten zitten in het sleutelveld of de komma-scheidingstekens ervan. 404's zijn de adresvorm; lees de samengestelde URL in de foutmelding en tel de /v1-segmenten. Not-found-fouten bij een specifiek model zijn de spelling van het ID in die rij. Zodra gesprekken vloeien, toont de APIsRouter-console model per verzoek, tokenaantallen en uitgaven. Een desktopclient die tijdens een werkdag wordt gebruikt, genereert een gestage stroom kleine verzoeken, en de gebruiksweergave per sleutel verandert die stroom in getallen per model, per dag, met Chinese en westerse ID's op dezelfde pagina.

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

Veelgestelde vragen

Hoe voeg ik een aangepaste provider toe in Cherry Studio?

Tandwielicoon, tabblad Model Services, Add. Geef de provider een naam, kies het type OpenAI, sla op, en schakel hem dan op zijn pagina in, plak je sleutel, stel het API-adres in op https://api.apisrouter.com, en voeg model-ID's handmatig toe. Valideer met de knop Check.

Moet het API-adres /v1 bevatten?

Nee. De gedocumenteerde standaard van Cherry Studio neemt het rootadres en voegt zelf /v1/chat/completions toe, dus voer https://api.apisrouter.com in. Een /v1-host plakken verdubbelt het pad en 404't. Om een niet-standaard exacte URL vast te pinnen, laat je het adres eindigen op # om de aaneenschakeling uit te schakelen.

Kan Cherry Studio Claude, DeepSeek en GLM draaien via één provider?

Ja. Het ID van elke modelrij reist als platte string naar het adres, dus claude-sonnet-4-6, deepseek-v4-flash, glm-5.2, kimi-k2.6 en qwen3.7-plus kunnen één providervermelding en één sleutel delen, wisselbaar per gesprek en per assistent.

Wat doet de functie voor komma-gescheiden sleutels?

Meerdere sleutels in het veld API key, gescheiden door Engelse komma's, worden per verzoek van boven naar beneden geroteerd, een ingebouwde load-balancingfunctie. Bij meting per sleutel aan gatewayzijde werkt dit ook als attributie; vermeld één enkele sleutel om rotatie uit te laten staan.

Waarom mislukt de knop Check?

Bij een correcte sleutel is de gebruikelijke oorzaak een adres met een overtollige /v1 die het samengestelde pad verdubbelt. Bij een schoon adres, controleer opnieuw de sleutel en de scheidingstekens; full-width komma's uit Chinese invoermethodes breken multi-key-lijsten stilletjes.

Waarom vullen modellen zich niet automatisch zoals bij presetproviders?

Aangepaste providers tonen precies wat je toevoegt; Cherry Studio haalt de catalogus van een aangepast endpoint niet op. Dat houdt de kiezer gecureerd. Haal ID's uit de /v1/models-lijst en voeg de ID's toe die je daadwerkelijk gebruikt, en breid de lijst uit op de dag dat je er nog een nodig hebt.