Aggiungi ogni modello del catalogo a Cherry Studio come un unico provider.

Updated 2026-07-29

Le impostazioni Model Services di Cherry Studio accettano qualsiasi endpoint compatibile OpenAI: aggiungi un provider con il tipo OpenAI, punta l'API address su api.apisrouter.com, incolla una chiave, e aggiungi gli id dei modelli a mano. Claude, GPT, DeepSeek, GLM, Kimi e Qwen risiedono in un unico selettore sul desktop.

Risposta rapida: un provider in Model Services.

Clicca l'icona a ingranaggio nella navigazione a sinistra di Cherry Studio, apri la scheda Model Services, e clicca il pulsante Add sotto la lista dei provider. Dai al provider un nome riconoscibile (APIsRouter) e scegli OpenAI come tipo di provider, poi salva. Ora seleziona il nuovo provider nella lista e configuralo: attiva il suo interruttore di abilitazione, incolla la tua chiave nel campo API key, e imposta l'API address su https://api.apisrouter.com. Nota la forma: il default documentato di Cherry Studio è prendere l'indirizzo radice e aggiungere da sé /v1/chat/completions, quindi inserisci l'host senza /v1. Poi aggiungi i modelli con il pulsante Add nella sezione modelli, un id di catalogo esatto per voce (claude-sonnet-4-6, deepseek-v4-flash, glm-5.2), e premi il pulsante Check accanto alla chiave per eseguire una validazione live contro un modello selezionato.

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

Come Cherry Studio compone l'URL della richiesta.

Cherry Studio (CherryHQ su GitHub, circa 49K stelle) è un client desktop di origine cinese per Windows, macOS e Linux, noto per spedire preset per centinaia di provider e assistenti. Qualsiasi cosa non nella lista dei preset entra tramite il flusso del provider personalizzato sopra, e la parte che vale la pena capire è il campo API address. Il default documentato: tu fornisci l'indirizzo radice, e Cherry Studio vi concatena la route OpenAI, quindi https://api.apisrouter.com diventa https://api.apisrouter.com/v1/chat/completions sul filo. Se un provider usa un percorso non standard, terminare l'indirizzo con # disabilita del tutto la concatenazione e l'indirizzo viene usato esattamente come digitato, che è la via di fuga documentata. Il comportamento di concatenazione attorno agli slash finali è cambiato tra le release, quindi se le richieste danno 404, leggi l'URL finale nell'errore invece di indovinare; la forma con indirizzo radice più l'aggiunta automatica è la configurazione stabile per un gateway /v1 standard. Una volta configurato, ogni conversazione invia chat completions standard con l'id del modello che hai aggiunto come semplice stringa. I fornitori non contano per il formato di trasmissione, ed è ciò che permette a una voce provider di portare insieme id di catalogo cinesi e occidentali.

Dettagli che si guadagnano il loro posto: multi-chiave e gestione dei modelli.

Il campo API key accetta più di una chiave: separa le chiavi con virgole inglesi e Cherry Studio le fa ruotare dall'alto in basso per richiesta, una funzionalità di load-balancing documentata. Con un gateway che misura per chiave, questo funge anche da attribuzione: una chiave per il lavoro, una per il personale, rotazione disattivata elencandone solo una. Le voci dei modelli sono manuali e questo è un pregio. Cherry Studio mostra esattamente ciò che aggiungi, quindi il selettore resta curato invece di affogare in un catalogo recuperato automaticamente. Ogni voce prende l'id come stringa di trasmissione; il pulsante Manage modifica o rimuove le voci in seguito. Raggruppa gli id correlati con una denominazione coerente e il selettore si legge come un menu: fascia veloce (deepseek-v4-flash, claude-haiku-4-5-20251001), forza regionale (glm-5.2, qwen3.7-plus, kimi-k2.6), frontiera (claude-sonnet-4-6). Il pulsante Check valida la coppia di chiave e indirizzo contro un modello che selezioni, ed è il modo più veloce per confermare il provider prima delle conversazioni reali. Un check fallito con una chiave corretta quasi sempre significa che il campo indirizzo porta un /v1 di troppo che ha raddoppiato il percorso.

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

Scegliere modelli per un cavallo di battaglia desktop.

Una chiave significa che i confronti sono cambi nel selettore. Esegui la stessa settimana di lavoro su due id candidati e lascia che la spesa per modello nella console di APIsRouter arbitri contro la tua stessa lettura della qualità dell'output.

  • La chat quotidiana e le riscritture rapide vivono sulla fascia veloce: deepseek-v4-flash e claude-haiku-4-5-20251001 mantengono la finestra sempre aperta gratuita nella sensazione.
  • Il lavoro in lingua cinese è dove gli id regionali si guadagnano le loro righe: glm-5.2 e qwen3.7-plus per bozze e documenti, kimi-k2.6 per la lettura a contesto lungo.
  • claude-sonnet-4-6 prende le conversazioni che inoltri senza modifiche: analisi accurata, prosa rivolta ai clienti, codice che intendi rilasciare.
  • Gli assistenti di Cherry Studio possono fissare il proprio modello per ruolo, così un assistente di traduzione su glm-5.2 e un assistente di coding su claude-sonnet-4-6 coesistono dietro un unico provider.
  • Aggiungi righe deliberatamente; un selettore curato di sei modelli viene usato, mentre un catalogo incollato viene scorso e basta.

Pagamento a consumo · sotto i prezzi ufficiali

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

ModelloPrezzo ufficialeIl nostro prezzo
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

Modalità di errore specifiche di Cherry Studio.

Il percorso raddoppiato è la segnalazione più comune: incollare https://api.apisrouter.com/v1 in un campo che aggiunge /v1/chat/completions produce URL /v1/v1 che danno 404. Inserisci l'indirizzo radice e lascia che il client costruisca la route. Se devi fissare un URL esatto, esiste per questo la forma con # finale. Un Check fallito con una chiave buona è di solito la forma dell'indirizzo sopra; un Check fallito con un indirizzo pulito è la chiave, e nota che più chiavi devono essere separate da virgole inglesi, dato che i caratteri a larghezza intera incollati da metodi di input cinesi rompono silenziosamente la lista. Modelli che danno errore individualmente mentre altri funzionano è un problema di ortografia dell'id; le voci sono testo libero e l'elenco /v1/models è la fonte autorevole. E ricorda che le impostazioni sono per macchina: un provider configurato sul tuo desktop non esiste sul tuo laptop finché non ripeti la configurazione di due minuti o usi le funzionalità di backup proprie di Cherry Studio. Nota sulla deriva di versione: Cherry Studio spedisce frequentemente e le etichette delle impostazioni si spostano (Model Services è anche apparso come Model Provider in alcune build); il flusso di aggiungere provider, scegliere il tipo OpenAI, chiave, indirizzo, modelli è rimasto stabile.

Chi instrada Cherry Studio tramite un gateway.

  • Utenti desktop bilingui che mescolano GLM, Qwen, Kimi e DeepSeek con Claude e GPT in un unico selettore, un saldo, nessun account per fornitore.
  • Utenti in Asia che vogliono id Claude e GPT su un saldo prepagato senza una carta occidentale, accanto ai modelli regionali che già usano.
  • Utenti avanzati che fanno girare assistenti Cherry Studio per ruolo e vogliono ogni assistente fissato al fornitore giusto senza gestire cinque chiavi.
  • Persone che già instradano altri strumenti tramite un gateway e vogliono il client desktop sulla stessa chiave e log di utilizzo.
  • Chiunque confronti modelli regionali e occidentali su lavoro quotidiano reale piuttosto che benchmark, dove ogni candidato è una riga di modello.

Verifica l'endpoint e fai debug della prima conversazione.

Esegui prima curl sull'elenco dei modelli e copia gli id che intendi aggiungere; poi esegui una chat completion contro il tuo daily driver previsto. Con entrambi che passano, tutto ciò che resta è nella pagina del provider. Dentro Cherry Studio, esegui Check prima di chattare. I fallimenti di autenticazione sono il campo chiave o i suoi separatori a virgola. I 404 sono la forma dell'indirizzo, leggi l'URL composto nell'errore e conta i segmenti /v1. Errori non-trovato su un modello specifico sono l'ortografia dell'id in quella riga. Una volta che le conversazioni scorrono, la console di APIsRouter mostra modello per richiesta, conteggi dei token e spesa. Un client desktop usato durante una giornata lavorativa genera un flusso costante di piccole richieste, e la vista di utilizzo per chiave trasforma quel flusso in numeri per modello, per giorno, con id cinesi e occidentali sulla stessa 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"}]}'

Domande frequenti

Come aggiungo un provider personalizzato in Cherry Studio?

Icona a ingranaggio, scheda Model Services, Add. Dai un nome al provider, scegli il tipo OpenAI, salva, poi sulla sua pagina abilitalo, incolla la tua chiave, imposta l'API address su https://api.apisrouter.com, e aggiungi gli id dei modelli manualmente. Valida con il pulsante Check.

L'API address dovrebbe includere /v1?

No. Il default documentato di Cherry Studio prende l'indirizzo radice e aggiunge da sé /v1/chat/completions, quindi inserisci https://api.apisrouter.com. Incollare un host con /v1 raddoppia il percorso e dà 404. Per fissare un URL esatto non standard, termina l'indirizzo con # per disabilitare la concatenazione.

Cherry Studio può far girare Claude, DeepSeek e GLM tramite un unico provider?

Sì. L'id di ogni riga di modello viaggia verso l'indirizzo come semplice stringa, quindi claude-sonnet-4-6, deepseek-v4-flash, glm-5.2, kimi-k2.6, e qwen3.7-plus possono condividere una voce provider e una chiave, commutabili per conversazione e per assistente.

Cosa fa la funzionalità delle chiavi separate da virgola?

Più chiavi nel campo API key, separate da virgole inglesi, vengono ruotate dall'alto in basso tra le richieste, una funzionalità di load-balancing integrata. Con la misurazione per chiave sul lato gateway funge anche da attribuzione; elenca una sola chiave per mantenere disattivata la rotazione.

Perché il pulsante Check fallisce?

Con una chiave corretta, la causa abituale è un indirizzo che porta un /v1 di troppo che raddoppia il percorso composto. Con un indirizzo pulito, ricontrolla la chiave e i suoi separatori; le virgole a larghezza intera dai metodi di input cinesi rompono silenziosamente le liste multi-chiave.

Perché i modelli non si popolano automaticamente come i provider preset?

I provider personalizzati elencano esattamente ciò che aggiungi; Cherry Studio non recupera il catalogo di un endpoint personalizzato. Questo mantiene curato il selettore. Tira gli id dall'elenco /v1/models e aggiungi quelli che usi davvero, poi estendi la lista il giorno in cui ne serve un altro.