Vai al contenuto
Risorse per sviluppatori
Risorse per sviluppatori

Cherry Studio

Connetti Cherry Studio a RunAPI e verifica una chat.

Visualizza Markdown

Connetti Cherry Studio a RunAPI con un provider OpenAI personalizzato. Crea una Chiave API RunAPI standard nella Guida all’Autenticazione prima di continuare.

Installa Cherry Studio

Installa l’applicazione desktop seguendo la guida ufficiale al download di Cherry Studio, quindi apri le sue impostazioni.

Aggiungi il provider RunAPI

  1. Apri Settings -> Model Services -> + Add.
  2. Imposta il nome del provider su RunAPI e il Provider type su OpenAI.
  3. Inserisci la tua chiave API RunAPI e imposta l’indirizzo API su https://runapi.ai/v1.
  4. Aggiungi un identificatore di modello preciso dal Model Catalog, abilita il provider e salva.

Poiché il tipo di provider è OpenAI, questo campo utilizza l’URL di base compatibile con OpenAI di RunAPI, che include /v1. Cherry Studio aggiunge /chat/completions per una richiesta Chat Completions, quindi non incollare l’URL completo dell’operazione nel campo dell’indirizzo API.

Seleziona un modello

I provider personalizzati si basano sui modelli che aggiungi. Se il selettore è vuoto, torna all’area di gestione dei modelli del provider e aggiungi manualmente un identificatore RunAPI esatto. L’aggiunta di un modello non conferisce capacità che il modello non supporta.

Esegui il controllo della connessione

Esegui il Controllo connessione con il modello salvato. Questa operazione invia una richiesta al modello anziché limitarsi a validare il formato della chiave. Un controllo riuscito conferma che l’URL del provider, la chiave e il modello selezionato funzionano insieme.

Verifica la connessione

Avvia una nuova chat, seleziona il provider e il modello RunAPI, poi invia Reply with the word connected. Una risposta normale, completa o in streaming, conferma che la chat attiva sta utilizzando RunAPI.

Risoluzione dei problemi

  • Il selettore di modelli è vuoto: aggiungi l’identificatore esatto del modello nell’area di gestione dei modelli del provider personalizzato e conferma che il provider sia abilitato.
  • Il controllo della connessione non riesce: conferma che un modello sia selezionato, sostituisci la chiave con una chiave standard valida e riprova.
  • La richiesta restituisce 404: usa https://runapi.ai/v1 come indirizzo API; non aggiungere /chat/completions manualmente.
  • Text funziona ma vision o tool non funzionano: scegli un modello che dichiari la funzionalità richiesta nel Model Catalog.

Per il comportamento del protocollo condiviso, utilizza la Guida introduttiva all’API LLM. Per i campi di richiesta e risposta, utilizza il Riferimento API Chat Completions.