Documentazione
Cherry Studio
Il provider personalizzato di Cherry Studio usa un indirizzo root separato per ogni protocollo: OpenAI, Anthropic e Gemini. Incolla la chiave e gli indirizzi root, premi Sync Models e il catalogo popolerà automaticamente il selettore.
Settings → Model Services → un provider personalizzato: incolla la chiave e l'indirizzo API, fai clic su Get Model List e l'intero catalogo riempie il selettore.
设置 → 模型服务 → 添加 → 添加自定义提供商 (Settings → Model Services → Add → Add Custom Provider)
提供商名称 / Provider name Kunavo
API 密钥 / API Key sk-kn-...
端点设置 / Endpoint settings
OpenAI https://api.kunavo.com/v1
Anthropic https://api.kunavo.com
→ 同步模型 (Sync Models), then add the models you want
→ 检测 (Test) to confirmGET /v1/models usando la root del campo compilato e la chiave inserita. È anche il modo più rapido per verificare che la combinazione sia corretta: un elenco vuoto indica quasi sempre un problema con la chiave o l'indirizzo, non con il provider.https://api.kunavo.com e https://api.kunavo.com/v1 vengono entrambi risolti correttamente nel campo OpenAI), quindi aggiunge sempre il proprio percorso per quel campo. Se incolli l'URL endpoint completo, già terminante con /chat/completions o /messages, il percorso viene aggiunto una seconda volta e la richiesta restituisce 404.sk-kn-) e aggiungi credito da $10: le chiamate vengono pagate con quel saldo e le chiamate non riuscite non vengono addebitate. La dashboard si apre quindi sulla configurazione Cherry Studio.Passo dopo passo
- Crea una chiave su
/app/keyse copiala: viene mostrata una sola volta. - Apri 设置 → 模型服务 (Impostazioni → Servizi modello) e 添加自定义提供商 (Aggiungi provider personalizzato).
- Inserisci API 密钥 (la chiave) e compila il campo endpoint OpenAI (
https://api.kunavo.com/v1). - Compila anche il campo Anthropic (
https://api.kunavo.com): si trova sotto OpenAI in 端点设置 (Impostazioni endpoint). Cherry Agent e qualsiasi modello instradato tramite il protocollo Anthropic Messages leggono specificamente da questo campo, non da quello OpenAI. Gli altri tipi di endpoint sono disponibili in 更多设置 (Altre impostazioni). - Salva, poi premi 同步模型 nell'elenco dei modelli del provider e aggiungi i modelli di chat che vuoi usare; premi 检测 per verificarne uno dall'inizio alla fine.
- Assegna i modelli a ciascun assistente invece di impostarli globalmente: Cherry Studio mantiene un modello per assistente, consentendo così di affiancare un'opzione predefinita economica a una specializzata più costosa.
Verificato rispetto a La documentazione di Cherry Studio sui provider il 1 ottobre 2026. Le impostazioni di terze parti cambiano; se il nome di un campo qui non corrisponde più a quello visualizzato, fa fede quella pagina, non questa.
Verifica prima di eseguire il debug del client
Una sola richiesta stabilisce se il problema riguarda l'endpoint, la chiave o il file di configurazione. Se restituisce JSON, lo stesso base URL e la stessa chiave funzionano in Cherry Studio.
# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
-H "Authorization: Bearer sk-kn-..."Quale model id inserire nel campo
Ogni modello di testo è raggiungibile come model id: l'elenco aggiornato è GET /v1/models e il catalogo con i prezzi è nella pagina dei modelli. Le tariffe sono in USD per 1M di token, input / output.
| ID del modello | Kunavo ingresso / uscita | Dove si inserisce in Cherry Studio |
|---|---|---|
claude-sonnet-5 | $1.40 / $7.00 | l'assistente di tutti i giorni |
claude-opus-5 | $3.50 / $17.50 | un assistente da usare per i problemi difficili |
claude-haiku-4-5 | $0.70 / $3.50 | traduzioni, riepiloghi e altre attività ad alto volume |
gpt-5-6-terra | $0.70 / $4.20 | documenti lunghi e grandi quantità di testo nel contesto |
Domande frequenti
Come aggiungo un provider API personalizzato a Cherry Studio?
Apri Impostazioni → Servizi modello (设置 → 模型服务) e seleziona Aggiungi provider personalizzato (添加自定义提供商). Sono previsti indirizzi root separati per ciascun tipo di endpoint — OpenAI e Anthropic sono mostrati per impostazione predefinita, mentre OpenAI Responses, Gemini e gli endpoint per immagini sono disponibili in Altre impostazioni (更多设置) — oltre a un'unica chiave API. Inserisci la chiave e le root degli endpoint che ti servono, premi Sincronizza modelli (同步模型) per caricare il catalogo, aggiungi i modelli desiderati e usa Test (检测) per verificare che uno funzioni.
Perché Sync Models di Cherry Studio non restituisce risultati?
Il pulsante chiama il percorso /v1/models del campo OpenAI usando la chiave inserita. Se non restituisce risultati, il problema riguarda l'indirizzo di quel campo o la chiave, non Cherry Studio. Ogni campo richiede un indirizzo root: Cherry Studio aggiunge versione e percorso. Controlla di non aver incollato l'URL endpoint completo, già terminante con /chat/completions, poi prova la stessa combinazione con curl: se ricevi JSON, il problema è nell'app; un 401 indica la chiave.
Che cosa fa il carattere # alla fine del campo endpoint di Cherry Studio?
La documentazione ufficiale spiega che serve a fissare il campo su un percorso specifico, per gli endpoint il cui percorso non segue la struttura standard. Gli endpoint OpenAI e Anthropic di Kunavo seguono entrambi lo standard, quindi non serve: inserisci l'indirizzo root, con o senza /v1, e lascia che Cherry Studio aggiunga il resto.
Cherry Studio può usare modelli Claude senza un account Anthropic?
Sì, quando sono offerti da un gateway: inserisci l'indirizzo di Kunavo specificamente nel campo Anthropic, non in quello OpenAI, perché Cherry Agent e qualsiasi modello instradato tramite il protocollo Anthropic Messages leggono da quel campo. Cherry Studio invia l'ID del modello all'endpoint specificato nella voce provider, quindi l'ID Claude viene risolto lì e l'unica credenziale che Cherry Studio usa è la chiave di tale endpoint.