Home → Guide → Cherry Studio con un'API personalizzata: indirizzo, modelli, Claude e immagini

Cherry Studio con un'API personalizzata: indirizzo, modelli, Claude e immagini

Aggiungere un provider in Cherry Studio richiede meno di un minuto. L'unico campo che si sbaglia è l'indirizzo API, perché Cherry aggiunge /v1 da solo. E quando inizi ad allegare screenshot, conta sapere quali modelli li vedono davvero: ne abbiamo provati sette.

Aggiungere il provider

Apri Impostazioni → Provider di modelli e fai clic su Aggiungi. Dai un nome (ad esempio APICLAN) e scegli il tipo OpenAI.
Incolla la chiave API presa dalla console.
Inserisci https://apiclan.us come indirizzo API.
Fai clic su Verifica e scegli un modello qualsiasi per confermare che la chiave funziona.

Cosa inserisci	Cosa chiama Cherry Studio
`https://apiclan.us`	`https://apiclan.us/v1/chat/completions` ✓
`https://apiclan.us/v1/`	`https://apiclan.us/v1/chat/completions` ✓
`https://apiclan.us/v1`	`https://apiclan.us/v1/v1/chat/completions` ✗ 404

Cherry Studio aggiunge /v1/chat/completions all'indirizzo, a meno che non termini con /. Quindi https://apiclan.us e https://apiclan.us/v1/ funzionano entrambi, mentre https://apiclan.us/v1 senza barra finale diventa /v1/v1 e restituisce 404.

Aggiungere i modelli

Fai clic su Gestisci sotto il provider. Cherry Studio scarica l'elenco da /v1/models, che restituisce solo i modelli del gruppo della tua chiave. Il 12 ottobre 2026 erano:

Gruppo GPT: gpt-5.6-sol, gpt-5.6-terra, gpt-6-astra, gpt-6-sol, gpt-6.1-sol
Gruppo DeepSeek: deepseek-v4-flash, deepseek-v4-pro, deepseek-v4.1-flash (più versioni datate)

Fai clic su + accanto a quelli che ti servono. Se un modello manca, la tua chiave appartiene a un altro gruppo: ogni chiave di questo gateway è legata a un solo gruppo.

Aggiungere Claude

Aggiungi un secondo provider di tipo Anthropic, con lo stesso indirizzo https://apiclan.us e una chiave creata in un gruppo Claude. Poi aggiungi claude-opus-5-5 o claude-fable-5-1. Un provider per gruppo tiene separate le chiavi: GPT, DeepSeek e Claude hanno ciascuno la propria voce.

Quali modelli leggono le immagini allegate

Abbiamo inviato a ogni modello la stessa piccola immagine di un solo colore, con la richiesta in stile OpenAI usata da Cherry Studio, chiedendo di che colore fosse. Abbiamo ripetuto con un secondo colore per escludere le risposte azzeccate a caso.

Modello	Legge immagini	Tempo di risposta
`claude-opus-5-5`	✓	3.1 s
`claude-fable-5-1`	✓	3.3 s
`deepseek-v4.1-flash`	✓	2.3–3.1 s
`gpt-6-astra`	✓	6.6 s
`gpt-5.6-sol`	✓	7.3 s
`gpt-6.1-sol`	✓	24–25 s
`deepseek-v4-pro`	✗	—

deepseek-v4-pro non accetta immagini: ha risposto «white» a un'immagine verde e l'altra volta non ha restituito nulla, senza errori. Per gli screenshot usa un modello con la spunta. gpt-6.1-sol legge correttamente le immagini ma ha impiegato circa 24 secondi, contro 2,6 secondi per il primo token di una richiesta solo testo. Se Cherry Studio non mostra il pulsante immagine per un modello, apri le sue impostazioni e spunta Visione. Test del 12 ottobre 2026.

Errori comuni

401 → la chiave è sbagliata o non corrisponde al provider (ad esempio una chiave GPT nel provider Anthropic).
404 → l'indirizzo termina con /v1 senza barra. Usa https://apiclan.us.
model_not_found (is not supported by any configured account in this group) → il modello non è nel gruppo della tua chiave. Aggiungilo da Gestisci invece di digitarlo.
La risposta ignora la tua immagine → il modello non legge immagini. Passa a uno con la spunta nella tabella.

Configuri strumenti di programmazione? Cline con un'API personalizzata · Codex con un'API personalizzata.

Inizia a usarlo

Nessun abbonamento, nessun minimo mensile, nessuna telefonata commerciale. Ricarica in USDT e spendi quello che usi — 1 USDT ti dà 2 crediti di saldo API.

Leggi l'avvio rapido da 30 secondi

Lingua: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

I prezzi di questa pagina sono compilati automaticamente dai dati di fatturazione reali. Le condizioni di terzi sono citate dalla loro documentazione.