Il percorso per configurare l'API in Cherry Studio è Settings → Model Provider → Add Provider. Inserisci API Key, inserisci l'indirizzo radice nei campi OpenAI e Anthropic di Endpoint settings, salva e usa ‘Sync models’ per importare i modelli, quindi verifica con ‘Check’. Prima di tutto: Cherry Studio non dispone di un'interfaccia in coreano, quindi i menu sono riportati nell'originale inglese. Questa pagina si basa su v2.1.4, pubblicata il 30 settembre 2026; poiché la schermata di aggiunta dei provider è cambiata notevolmente in v2, la descrizione del periodo v1 con ‘Type: OpenAI’ non corrisponde più all'interfaccia.
Il riferimento è la versione desktop di CherryHQ/cherry-studio (AGPL-3.0, Windows·macOS·Linux). Al 1º ottobre 2026 il repository non è archiviato e la versione più recente è v2.1.4. L'app con lo stesso nome sull'App Store è un'app non correlata di un altro sviluppatore. Le lingue integrate dell'interfaccia sono 13 e il coreano non è disponibile; in base ai file di traduzione dell'interfaccia di v2.1.4, la procedura presuppone l'uso dell'interfaccia inglese.
Configurazione passo dopo passo
Settings → Model Provider → Add Provider
(대화상자 제목: Add Custom Provider)
Provider Name Kunavo
API Key sk-kn-...
Endpoint settings
OpenAI https://api.kunavo.com/v1
Anthropic https://api.kunavo.com
More options
OpenAI Responses https://api.kunavo.com/v1 (선택)
Image Generation Base URL https://api.kunavo.com/v1 (선택)
Gemini 비워 둠
→ Save → 모델 목록에서 "Sync models" → 쓸 모델 추가 → "Check"- In Settings → Model Provider, fai clic su Add Provider. Il titolo della finestra di dialogo che si apre è ‘Add Custom Provider’. Se ti servono servizi della famiglia Coding Plan, più account o separazione dei progetti, puoi anche iniziare da un preset esistente tramite ‘Start from a preset (optional)’ in alto.
- Inserisci Provider Name e API Key.
- In Endpoint settings sono presenti fin dall'inizio due campi: OpenAI e Anthropic. È necessario almeno un endpoint testuale (se lasciato vuoto, compare l'errore ‘Configure at least one text endpoint’). Compilando entrambi i campi puoi selezionare modelli non solo per la chat, ma anche per Agent e per le funzioni che utilizzano il formato Anthropic.
- Espandendo More options trovi i campi OpenAI Responses, Gemini, Image Generation Base URL e Image Edit Base URL. Lascia vuoti i campi che non utilizzi.
- Dopo il salvataggio, verifica che il provider sia attivato (Enable). Secondo la documentazione ufficiale, i provider configurati ma non attivati non mostrano i modelli nell'elenco di selezione. È la causa più comune del problema “la chiave non funziona”.
- Nell'elenco dei modelli, usa Sync models per importarli, aggiungi quelli da utilizzare e verifica uno con Check.
Come scrivere l'indirizzo: solo l'indirizzo radice
In base al codice sorgente di v2.1.4, in ogni campo va inserito l'indirizzo radice. Se manca la parte relativa alla versione, viene aggiunto automaticamente /v1 (se è già presente, non viene aggiunto); quindi viene concatenato il percorso fisso specifico del campo. Sotto ogni campo viene mostrato l'URL finale tramite ‘Request path’: verificalo prima di salvare.
| Campo | Percorso aggiunto da Cherry Studio | Kunavo |
|---|---|---|
| OpenAI | /chat/completions | Supportato |
| Anthropic | /messages | Supportato |
| OpenAI Responses (More options) | /responses | Supportato |
| Image Generation Base URL (More options) | /images/generations | Supportato |
| Image Edit Base URL (More options) | /images/edits | Supportato |
| Gemini (More options) | /models/{model}:generateContent | Non supportato, lasciare vuoto |
Gli errori comuni sono due. Se incolli un URL completo che include /chat/completions o /messages, il percorso viene aggiunto due volte e causa un 404. Inoltre, il # finale è, come indicato dall'interfaccia, il simbolo che “Add # at the end to disable the automatically appended API version”, cioè disabilita l'aggiunta automatica della versione; se lo aggiungi a un endpoint standard, manca /v1. Per verificare l'indirizzo e la chiave, il comando seguente è il metodo più rapido.
curl https://api.kunavo.com/v1/models \
-H "Authorization: Bearer $KUNAVO_API_KEY"Configurazione di base del modello per risparmiare
Cherry Studio chiama modelli anche in background, non solo per la chat. Quick Model viene utilizzato, come indicato nella descrizione, per ‘attività semplici come assegnare un nome alle conversazioni ed estrarre parole chiave di ricerca’, e le istruzioni consigliano di ‘scegliere un modello leggero ed evitare i modelli di ragionamento’. Impostando qui un modello economico, non viene eseguito un modello costoso a ogni conversazione. Configura separatamente anche Translate Model. Se selezioni più modelli e poni una domanda in una volta sola, vengono inviate richieste separate in numero pari ai modelli e ciascuna viene addebitata separatamente. L'importo nelle statistiche di utilizzo dell'app è una stima convertita ai prezzi pubblici, quindi sui percorsi scontati può risultare superiore al costo reale. Modificando il prezzo unitario nelle impostazioni del modello con la tariffa effettiva, il valore viene corretto. Per maggiori dettagli, consulta la pagina inglese Cherry Studio API cost.
Considerazioni e pagamenti per l’uso con Kunavo
- Ambito della verifica: questa configurazione è stata redatta consultando il codice sorgente e la documentazione ufficiale di Cherry Studio; non è stata verificata eseguendo Cherry Studio con Kunavo collegato al suo endpoint. Mantieni invariato il percorso attuale e testalo.
- Solo chat e immagini: Kunavo non dispone di modelli di embedding, quindi per la ricerca vettoriale nella knowledge base serve un altro provider o un modello di embedding locale. La documentazione ufficiale spiega che la knowledge base funziona con la ricerca per parole chiave BM25 anche senza un modello di embedding.
- Strumenti MCP: gli strumenti aggiunti in Settings → MCP Servers funzionano solo con modelli che supportano le chiamate agli strumenti. I modelli Claude e GPT aggiunti sopra le supportano.
- Pagamento: ricarica prepagata senza canone mensile, con addebito del saldo in base ai token. L'importo minimo della ricarica è $10; nel checkout Stripe puoi usare carte (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay e Link. Quando il checkout è visualizzato in won coreani, sono disponibili anche KakaoPay, Naver Pay, PAYCO, Samsung Pay e carte nazionali con i pagamenti internazionali bloccati (aggiunto il 3 ottobre 2026; non sono ancora stati effettuati pagamenti con questi metodi). Gli importi sono stabiliti in dollari e Stripe converte la visualizzazione in won; il tasso include una commissione di conversione del 2–4% a carico dell'acquirente. Toss Pay non è disponibile. Consulta le informazioni sulla fatturazione, quindi crea un account e genera una chiave. La pagina di configurazione in inglese è la guida all'integrazione di Cherry Studio.
Domande frequenti
Come si configura l'API in Cherry Studio?
Facendo clic su Settings → Model Provider → Add Provider si apre la finestra di dialogo 'Add Custom Provider'. Inserisci Provider Name e API Key, inserisci l'indirizzo radice nei campi OpenAI e Anthropic di Endpoint settings, quindi salva. Poi usa 'Sync models' nell'elenco dei modelli per importarli e aggiungi quelli da utilizzare, quindi verifica uno con 'Check'. Il provider deve essere attivato (Enable) perché il modello appaia nell'elenco di selezione.
È possibile usare Cherry Studio in coreano?
L'interfaccia non supporta il coreano. In v2.1.4 le lingue dell'interfaccia sono 13: inglese, cinese (semplificato e tradizionale), giapponese, tedesco, francese, spagnolo, portoghese, russo, greco, rumeno, turco e vietnamita. Poiché i menu vengono spesso utilizzati in inglese, questa pagina riporta i nomi dei menu in inglese. Le conversazioni con i modelli possono invece essere in coreano.
Devo aggiungere /v1 all'indirizzo API?
Puoi aggiungerlo oppure no. Il codice sorgente di v2.1.4 aggiunge automaticamente la versione (/v1) se manca nell'indirizzo radice inserito, mentre la lascia invariata se è già presente; poi aggiunge il percorso specifico del campo (OpenAI usa /chat/completions, Anthropic /messages). Da evitare è incollare l'URL completo che include /chat/completions, perché il percorso verrebbe aggiunto due volte e causerebbe un 404. Il carattere # finale disabilita l'aggiunta automatica della versione, quindi non usarlo con gli endpoint standard. Puoi verificare l'URL finale in 'Request path' sotto il campo.
Cosa fare se i modelli non compaiono premendo Sync models?
Questo pulsante richiede l'elenco dei modelli del provider (/v1/models) utilizzando l'indirizzo e la chiave inseriti; se l'elenco è vuoto, di solito il problema riguarda l'indirizzo o la chiave. Verifica di non aver incollato l'URL completo e che non ci sia un # finale, quindi prova a eseguire curl con lo stesso indirizzo e la stessa chiave. Se arriva JSON, il problema è nell'app; se ricevi 401, il problema è la chiave.
Cherry Studio è gratuito?
La versione desktop della community è open source con licenza AGPL-3.0 ed è gratuita. Il costo riguarda i modelli del provider configurato. Cherry Studio Enterprise è un prodotto separato con prezzo su preventivo, mentre CherryAI integrato è gratuito, ma la configurazione e i limiti dei modelli non sono pubblici.
Verificato il 1° ottobre 2026: API GitHub (CherryHQ/cherry-studio, v2.1.4), elenco dei file di traduzione dell’interfaccia di v2.1.4 e stringhe dell’interfaccia inglese (en-us.json), codice sorgente della schermata di aggiunta dei provider e documentazione ufficiale di Cherry Studio. Kunavo non ha eseguito Cherry Studio con il proprio endpoint.