Collegare GPT e API di terze parti a Cherry Studio
Scegli il protocollo giusto, inserisci l'URL root del provider, aggiungi l'ID modello esatto e verifica una piccola richiesta prima di espandere la configurazione.
La ricerca di come connettere GPT a Cherry Studio di solito significa che è necessaria una configurazione del provider funzionante, non un tour delle funzionalità. I campi importanti sono il protocollo, la chiave API, l'URL di base e l'ID modello esatto.
Il percorso breve è:
Impostazioni → Servizio modello → scegli o aggiungi un fornitore → inserisci le credenziali e l'URL API → recupera o aggiungi un modello → abilita il fornitore → esegui un controllo di integrità.
Cherry Studio dispone di provider integrati per servizi come OpenAI, Anthropic, Google Gemini, DeepSeek, Moonshot, Ollama e LM Studio. Un gateway o un servizio self-hosted può essere aggiunto tramite un provider personalizzato quando espone un endpoint compatibile con OpenAI, Anthropic o Gemini. Consulta la guida alle impostazioni del provider ufficiale per i nomi dell'interfaccia utente correnti.
Cosa ti serve prima di aprire Cherry Studio
Prepara quattro valori dal servizio che desideri utilizzare:
| Valore | Cosa significa |
|---|---|
| Protocollo | Compatibile con OpenAI, Messaggi Anthropic, Gemini o il formato documentato del provider |
| Chiave API | La credenziale utilizzata per autenticare la richiesta |
| Base URL | L'indirizzo root API, a meno che il provider non richieda esplicitamente un endpoint completo |
| Model ID | La stringa esatta accettata dallo API upstream |
Non utilizzare una password di chat web come chiave API. Un abbonamento ChatGPT, un account API e un gateway di terze parti sono percorsi di accesso separati. Utilizza la credenziale e l'endpoint documentati dal servizio selezionato.
Connetti GPT in cinque passaggi
1. Servizio modello aperto
Avvia Cherry Studio e apri Impostazioni → Servizio modello. Scegli il provider OpenAI integrato quando chiami direttamente OpenAI. Per un gateway, un aggregatore o una distribuzione privata, scegli Aggiungi provider e crea una voce personalizzata separata.
Il provider viene selezionato dal suo protocollo, non dalla parola GPT nel nome del modello. Un modello con etichetta GPT dietro un gateway compatibile con Anthropic necessita ancora del profilo di protocollo Anthropic.
2. Compila i campi del provider
Utilizza la documentazione del fornitore per ciascun campo:
| Campo Cherry Studio | Cosa inserire | Evitare |
|---|---|---|
| Nome del fornitore | Un'etichetta che riconoscerai più tardi | Riutilizzo di un'etichetta per endpoint non correlati |
| Chiave API | Solo il valore chiave | Spazi aggiuntivi, virgolette o Bearer |
| Tipo API | Il protocollo effettivamente implementato dall'endpoint | Indovinando dal nome commerciale del modello |
| Indirizzo API | L'URL root documentato o l'URL completo richiesto | Un URL del dashboard o un percorso duplicato |
Per un servizio compatibile con OpenAI convenzionale, Cherry Studio generalmente prevede l'indirizzo root e aggiunge la versione e il percorso della richiesta. Se un provider mostra sia https://api.example.com che https://api.example.com/v1/chat/completions, il primo è l'URL di base normale. Non aggiungere /v1 due volte. Utilizza un percorso completo solo quando il provider lo richiede esplicitamente.
La guida personalizzata del provider copre endpoint aggiuntivi, immissione manuale del modello e servizi locali in stile vLLM.
3. Recupera o aggiungi il modello
Fai clic su Ottieni elenco modelli. Se l'endpoint espone il rilevamento del modello, aggiungi il modello con il pulsante +. L'ID restituito è autorevole: mantieni le date, i prefissi del fornitore, i trattini e i suffissi della versione esattamente come mostrato.
Se il provider non espone un elenco di modelli, aggiungi il modello manualmente. Un salvataggio riuscito del fornitore non rende automaticamente disponibile un modello nel selettore di chat. È necessario aggiungere il modello e abilitare il cambio del provider.
4. Controlla una richiesta breve
Utilizza Verifica con il modello appena aggiunto, quindi invia un messaggio minimo:
Reply with exactly: connection successful
Ciò separa i problemi di autenticazione e routing dai problemi di visione, strumenti, contesto lungo o capacità dell'agente. Conferma la chiamata nella pagina di utilizzo del provider quando disponibile.
5. Aggiungi funzionalità avanzate una alla volta
Una volta che il testo semplice funziona, prova lo streaming, le immagini, gli strumenti o i parametri di ragionamento uno per uno. Una risposta in chat riuscita dimostra solo che il percorso testuale di base funziona; non dimostra che il modello o il protocollo supporti tutte le funzionalità esposte da Cherry Studio.
Collegamento di altre API di terze parti
Gateway compatibili con OpenAI
Utilizzare Provider personalizzato → OpenAI quando il gateway documenta OpenAI Chat Completions o un'altra superficie compatibile con OpenAI. Questo è il percorso abituale per aggregatori, gateway privati, vLLM e molti modelli aperti ospitati.
Gateway multiprotocollo
I nuovi gateway in stile API possono esporre chat OpenAI, risposte OpenAI, messaggi Anthropic e percorsi Gemini da un indirizzo root. Le istruzioni NewAPI di Cherry Studio spiegano che il client seleziona il percorso della versione per il protocollo scelto. Utilizza la preimpostazione NewAPI quando il gateway segue tale contratto; utilizzare un provider personalizzato quando dispone di un percorso documentato o di una variazione di individuazione del modello.
Ollama, LM Studio e vLLM
Seleziona il provider locale corrispondente o utilizza un provider OpenAI personalizzato quando il server locale espone un API compatibile con OpenAI. Immettere il nome del modello effettivamente caricato dal server locale. L’esecuzione locale può ridurre l’esposizione dei dati, ma i modelli locali differiscono ancora per visione, strumenti, lunghezza del contesto e supporto del ragionamento.
Quando l'elenco dei modelli è vuoto
Esegui questi controlli in ordine:
- Confermare che il servizio implementa un endpoint elenco modelli. Alcune API accettano solo un ID modello fornito manualmente.
- Rimuovi i segmenti di percorso duplicati. Un URL root che contiene già
/v1può avere esito negativo quando Cherry Studio aggiunge un altro/v1. - Verifica di aver utilizzato l'indirizzo API e non l'indirizzo del dashboard di gestione del provider.
- Copia l'ID modello esatto restituito dal fornitore. I nomi visualizzati e gli ID API non sono intercambiabili.
- Assicurati che il provider sia abilitato. Un provider disabilitato nasconde i suoi modelli dal selettore.
Errori comuni
| Errore | Probabile causa | Primo controllo |
|---|---|---|
401 Unauthorized | Chiave non valida, scaduta o formattata in modo errato | Ricopiare la chiave e confermare il profilo del protocollo |
403 Forbidden | Conto, progetto, saldo o limite chiave | Controlla le autorizzazioni e la quota del provider |
404 Not Found | URL root errato, percorso della versione duplicato o mancata corrispondenza del protocollo | Ripristina l'URL di base documentato |
400 Bad Request | Parametro o forma di richiesta non supportato | Rimuovi i parametri personalizzati e riprova con il testo normale |
model not found | ID errato o modello non aggiunto in Cherry Studio | Copia l'ID esatto del modello a monte |
| Il testo funziona ma le immagini/gli strumenti falliscono | Il modello o il protocollo non hanno questa capacità | Controlla l'elenco delle capacità e il percorso |
| Timeout | Latenza del provider, problema di rete o richiesta di dimensioni eccessive | Riprovare con un breve messaggio e un modello |
Cambia una variabile alla volta. Inizia con un fornitore, un modello e una breve richiesta; solo allora aggiungi più modelli o strumenti.
Confronto di più modelli
Cherry Studio ti consente di cambiare modello nel selettore di conversazioni e inviare lo stesso messaggio a più modelli selezionati. Ogni selezione crea una richiesta indipendente. È utile per il confronto, ma non è un voto automatico o una garanzia di qualità; il conteggio delle richieste, il costo e l'esposizione dei dati aumentano con ogni modello selezionato. La guida comparativa ufficiale consiglia di scrivere criteri di valutazione espliciti invece di chiedere quale sia semplicemente la risposta "migliore".
Utilizza OmniaKey come unico fornitore
Se non desideri mantenere punti di ingresso separati per GPT, Claude, Gemini e altri modelli, configura OmniaKey come provider personalizzato compatibile con OpenAI in Cherry Studio.
- Crea una chiave OmniaKey API dedicata e imposta un limite di chiave adeguato nella pagina Chiavi API.
- Apri Impostazioni → Servizio modello → Aggiungi fornitore in Cherry Studio.
- Scegli il tipo compatibile con OpenAI e inserisci l'URL di base e la chiave dalla Avvio rapido OmniaKey.
- Recupera l'elenco dei modelli o aggiungi un ID esatto dal catalogo dei modelli in tempo reale.
- Abilita il provider, esegui un breve controllo e conferma la richiesta in Utilizzo.
L'attuale catalogo OmniaKey include Claude, GPT, Gemini e Grok, insieme ad altre famiglie di modelli. Gli ID e le funzionalità sono dinamici, quindi utilizza il catalogo live anziché un vecchio tutorial. Un percorso compatibile con OpenAI non rende identiche tutte le funzionalità specifiche del provider; verificare la funzionalità del modello e del protocollo prima di abilitare la visione o gli strumenti.
Domande frequenti
Cherry Studio può utilizzare qualsiasi API che trovo?
Solo quando il servizio espone un protocollo supportato da Cherry Studio. Un URL arbitrario senza un formato di richiesta documentato, un metodo di autenticazione e un ID modello non è sufficiente.
Devo inserire un URL root o /chat/completions?
Seguire la documentazione del fornitore. I provider convenzionali normalmente utilizzano l'URL root e consentono a Cherry Studio di aggiungere il percorso della richiesta; utilizzare un endpoint completo solo quando il provider lo richiede esplicitamente.
Perché posso chattare ma non utilizzare strumenti o immagini?
Il successo del testo di base non dimostra che il modello, il protocollo e il percorso client selezionati supportino gli strumenti o la visione. Controlla ciascuna funzionalità separatamente.
Un abbonamento web ChatGPT è una chiave API?
No. Cherry Studio necessita di una credenziale del provider API o di una credenziale gateway compatibile. I dettagli di accesso al Web non devono mai essere incollati nel campo chiave API.
Fonti e freschezza
Questa guida utilizzaCherry Studioil fornitore attuale di, il fornitore personalizzato,OpenAI, NewAPI e documentazione multi-modello, oltre aOmniaKeyè attualeAPIe documentazione del modello. I valori tecnici come gli ID modello, le funzionalità del provider e i percorsi possono cambiare; verificarli al momento della configurazione.