Documentazione

Msty Studio

La documentazione di Msty Studio dice che è possibile aggiungere un endpoint compatibile con OpenAI come provider, poi non fornisce altri dettagli. L'app è più specifica: indica il tipo di provider, i due campi e la regola per /v1. Ecco il modulo compilato per Kunavo.

Model Hub > Model Providers > Add Provider > Open AI Compatible: una API Key e un Inference Endpoint di https://api.kunavo.com/v1 — la nota dell'app indica che la maggior parte degli endpoint compatibili con OpenAI richiede /v1.

Msty Studio 2.9.11 — Add Provider

Model Hub  >  Model Providers  >  Add Provider

Provider             Open AI Compatible     (under "OpenAI Compatible")
Name                 Kunavo                 "Give it a name (optional)"
API Key              sk-kn-...
Inference Endpoint   https://api.kunavo.com/v1      <- keep the /v1

Models               Fetch Models, then tick the ids you want
                     (or Add Custom Model: Model ID + Model Name)
                                                     → Save Provider

Lascia /v1: lo dice Msty stessa. Sotto il campo Inference Endpoint, l'app distribuita mostra: “La maggior parte degli endpoint provider compatibili con OpenAI richiede il percorso /v1, ad esempio https://example.com/v1”. Msty Studio aggiunge a ciò che inserisci solo /models e /chat/completions. Senza /v1, Fetch Models invia una richiesta a https://api.kunavo.com/models e le richieste di chat vanno a https://api.kunavo.com/chat/completions; dal 1º ottobre 2026, entrambi restituiscono un 404 in formato JSON con un messaggio che indica di aggiungere /v1 (prima, il recupero dei modelli restituiva una pagina web).

Da dove provengono queste etichette. La documentazione online di Msty non specifica i nomi dei campi. Le etichette riportate sopra sono le stringhe incluse nella versione desktop 2.9.11 di Msty Studio (scaricata dai server ufficiali di Msty il 1º ottobre 2026 e consultata senza avviarla), quindi corrispondono a quelle visualizzate dall'app in inglese. Una versione successiva potrebbe rinominarle; fa fede l'app sul tuo schermo.

Non verificato dall'inizio alla fine. Nessuno qui ha inviato un messaggio da Msty Studio a Kunavo. Il modulo provider, la nota su /v1 e i percorsi delle richieste sono stati esaminati nella versione rilasciata; il lato Kunavo è stato verificato con semplici richieste HTTP. Streaming, chiamate agli strumenti, input di immagini e controlli del ragionamento tramite questo tipo di provider non sono stati testati: la tua prima chat è la verifica effettiva.

Non hai ancora una chiave? Crea un account Kunavo, genera una chiave (inizia con 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 Msty Studio.

Passo dopo passo

Crea una chiave su /app/keys e copiala: viene mostrata una sola volta.
In Msty Studio, apri Model Hub > Model Providers e seleziona Add Provider. Nell'elenco dei provider, sotto l'intestazione OpenAI Compatible, seleziona Open AI Compatible: non OpenAI, che è il provider OpenAI predefinito.
Assegna un nome al provider, incolla la chiave in API Key e inserisci https://api.kunavo.com/v1 come Inference Endpoint. L'app richiede che inizi con https://.
Fai clic su Fetch Models e seleziona i modelli desiderati. Kunavo restituisce il catalogo completo su GET /v1/models, quindi scegline alcuni, non tutti. Se preferisci, apri Add Custom Model e inserisci un Model ID esattamente come compare nel catalogo, ad esempio claude-sonnet-5.
Fai clic su Save Provider, poi apri una conversazione e seleziona uno dei suoi modelli: la documentazione di Msty indica questa operazione come passaggio di verifica. Se ricevi una risposta, endpoint, chiave e ID modello sono corretti.

Verificato rispetto a Pagina Online Providers di Msty Studio 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.

Questa è la versione breve. La guida completa, con scelta del modello, costo di una sessione reale e modalità di errore, è in Prezzi di Msty Studio e costi dell'API.

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 Msty 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 Msty Studio
`claude-sonnet-5`	$1.40 / $7.00	Documenti lunghi e chat Knowledge Stack: il modello predefinito per la maggior parte delle conversazioni
`gpt-5-6-terra`	$0.70 / $4.20	Una seconda famiglia nel riquadro di confronto delle chat divise
`claude-haiku-4-5`	$0.70 / $3.50	Domande rapide, titoli e attività che esegui spesso

La fatturazione è per token, usando un saldo prepagato senza canone mensile: vedi billing. In presenza di contesto ripetuto, che costituisce la maggior parte di ciò che invia un editor o un client di chat, prompt caching incide sulla spesa più della scelta del modello.

Di quale Msty si parla

Msty Studio: lo spazio di lavoro desktop e web descritto in questa pagina, con i provider in Model Hub > Model Providers.
Msty Go: un'app agente separata, con una propria schermata provider in Settings; la configurazione è descritta nella sua pagina.
Msty 1.x: l'app dismessa, la cui documentazione congelata su docs.msty.app continua a comparire in alto nei risultati. Le sue schermate non sono quelle di Studio.

Cosa indica l'app in caso di errore

Questi sono i messaggi inclusi nella versione 2.9.11 e il significato di ciascuno per questo endpoint:

“Provider endpoint non trovato. Verifica l'URL dell'endpoint e assicurati che includa il percorso API corretto, ad esempio /v1.”: all'Inference Endpoint manca /v1.
“Impossibile connettersi all'endpoint del provider…”: il nome host contiene un errore di battitura oppure è stato usato http:// anziché https://.
Fetch Models non riesce, ma l'URL è corretto: verifica la chiave. L'elenco dei modelli di Kunavo richiede una chiave valida e restituisce 401 in sua assenza.
Un modello è elencato, ma la chat genera un errore: il modulo di Msty avverte che “Non tutti i modelli sono stati testati con Msty”. L'elenco di Kunavo comprende modelli di immagini, video e audio che non possono essere usati in una finestra di chat; seleziona un modello per la chat.

Cosa esce dal tuo dispositivo

Msty descrive i provider online come un modo per “usare modelli ospitati con le proprie chiavi API, senza eseguire l'inferenza del modello sul dispositivo”. Pertanto, una conversazione con un modello Kunavo invia a Kunavo il prompt e il contesto allegato, che Kunavo inoltra al fornitore del modello; una conversazione con un modello locale non lo fa. Se questo aspetto è importante, conserva il materiale sensibile sui modelli locali.

Livello di ragionamento per questo tipo di provider

La documentazione di Msty indica che, per i “modelli compatibili con OpenAI”, i livelli di ragionamento supportati sono solo None e Default, mentre il provider Anthropic nativo offre Think Lightly, Moderately e Deeply. Con il tipo Open AI Compatible, un modello Claude dovrebbe quindi funzionare con il ragionamento predefinito, non con i livelli graduati.

Domande frequenti

Come aggiungo un provider personalizzato compatibile con OpenAI in Msty Studio?

Apri Model Hub > Model Providers e seleziona Add Provider. Sotto l'intestazione OpenAI Compatible, scegli Open AI Compatible, assegna un nome, incolla la chiave in API Key e inserisci l'endpoint in Inference Endpoint, includendo il percorso della versione: per Kunavo, https://api.kunavo.com/v1. Fai clic su Fetch Models per caricare l'elenco oppure usa Add Custom Model per inserire un Model ID, quindi seleziona Save Provider. Queste etichette sono le stringhe presenti nella versione 2.9.11 di Msty Studio; la documentazione online di Msty descrive la stessa procedura senza indicare i nomi dei campi.

Msty Studio richiede /v1 nell'endpoint?

Per la maggior parte dei provider compatibili con OpenAI, sì, e l'app stessa lo specifica: sotto il campo Inference Endpoint mostra “La maggior parte degli endpoint provider compatibili con OpenAI richiede il percorso /v1, ad esempio https://example.com/v1. In caso di problemi, prova ad aggiungere /v1 all'endpoint”. Msty Studio aggiunge solo /models e /chat/completions; pertanto, l'endpoint Kunavo è https://api.kunavo.com/v1. Senza /v1, sia il recupero dei modelli sia le chat restituiscono un 404 il cui messaggio indica di aggiungere /v1.

Il provider personalizzato di Msty Studio è uguale a quello di Msty Go?

No. Sono app separate, con schermate dei provider distinte. In Msty Studio i provider si aggiungono da Model Hub > Model Providers, scegliendo il tipo Open AI Compatible descritto qui. Msty Go, l'app per agenti precedentemente chiamata Msty Claw, configura i provider da Settings > Model Providers usando un proprio insieme di campi. Le istruzioni di configurazione di un'app non valgono per l'altra, e nessuna delle due corrisponde alla dismessa app Msty 1.x, la cui vecchia documentazione compare ancora nei risultati di ricerca.

Chi mi addebita i costi quando Msty Studio usa un provider personalizzato?

I costi vengono addebitati separatamente da due soggetti. Msty addebita il piano dell'app che usi, se previsto. Le chiamate al modello vengono addebitate da chi ha emesso la chiave inserita nel campo API Key del provider: con una chiave Kunavo, il costo è calcolato per token e detratto dal saldo prepagato Kunavo. I modelli locali eseguiti all'interno di Msty non hanno costi per richiesta. I piani e il costo di una tipica conversazione su un documento lungo alle tariffe di catalogo sono illustrati nella pagina dei prezzi di Msty Studio, linkata sopra.

Kunavo ha testato Msty Studio?

Non dall'inizio alla fine. Il 1 ottobre 2026 è stata scaricata dai server di Msty la versione desktop ufficiale di Msty Studio 2.9.11 e ne è stato esaminato il contenuto senza avviarla: da lì provengono il tipo di provider, le etichette dei campi, la nota su /v1, i messaggi di errore e i percorsi delle richieste riportati in questa pagina. Il lato Kunavo è stato verificato con richieste HTTP dirette. Non è stata eseguita alcuna chat da Msty Studio a Kunavo, quindi lo streaming, l'uso degli strumenti e l'input di immagini tramite questo provider non sono verificati.