Documentazione

ChatWise

ChatWise usa gli stessi tre campi per tutti i provider. Dai un nome al provider personalizzato, inserisci API Base URL e una chiave, poi premi Fetch: il selettore dei modelli si popola con gli ID Claude e GPT, tutti sullo stesso saldo.

Settings → Providers → "+" crea un provider personalizzato da tre campi — Provider name, API Base URL impostato su https://api.kunavo.com/v1 e API Key — poi Fetch legge l'elenco dei modelli dall'endpoint.

Settings → Providers → "+" → configurazione personalizzata

Provider name    Kunavo
API Base URL     https://api.kunavo.com/v1
                 field help: "Do NOT include /chat/completions in the URL"
API Key          sk-kn-...
Models           click Fetch to read the list from the endpoint,
                 or "+ New" and type an id by hand

"+ New" → Chat Models, the fields the docs name:
  Model ID       claude-sonnet-5
  Display Name   Claude Sonnet 5 (Kunavo)
  Capabilities   image input / reasoning flag — tick what the model does
  Context length as published on the models page

API Base URL deve mantenere /v1. ChatWise riporta la regola sotto il campo: «Non includere /chat/completions nell'URL», quindi il valore è la root da cui parte il percorso, non il percorso stesso. L'unico gateway ospitato mostrato nella documentazione con il campo compilato ha la stessa struttura, https://aihubmix.com/v1. Un URL di base che include già il percorso genera un 404, non un errore di autenticazione.

Questa configurazione è basata sulla documentazione ufficiale di ChatWise alla data indicata sotto. Kunavo non ha testato ChatWise con il proprio endpoint: non ha verificato una sessione, un turno in streaming né uno scambio completo con strumenti. Lo stesso vale per tutti i client di questa categoria. Una pagina con le istruzioni di configurazione non è un test di compatibilità. Tieni a disposizione la configurazione che già funziona mentre provi questa.

Kunavo non offre modelli per embedding, sintesi vocale o riconoscimento vocale, quindi questo endpoint gestisce solo chat e generazione di immagini. La funzione di input audio di ChatWise è diversa e non ne è interessata: allega a un messaggio un file audio da inviare a un modello che lo accetta, invece di chiamare un servizio di trascrizione.

Compilando questo campo si disattiva un'estensione di ChatWise. La pagina dedicata all'osservabilità avverte: «Assicurati che API Base URL del provider corrispondente sia vuoto, altrimenti l'osservabilità non sarà abilitata». La dashboard di Cloudflare AI Gateway e un URL di base reindirizzato sono incompatibili per lo stesso provider: un motivo per aggiungere Kunavo come voce provider separata, invece di modificare quella integrata.

Diversi prodotti non correlati usano il nome ChatWise. Questa pagina riguarda il client desktop disponibile per chatwise.app — macOS, Windows e Linux — la cui documentazione si trova su docs.chatwise.app. Il feed pubblico delle release su GitHub si ferma molto prima della versione distribuita: se l'app non corrisponde agli screenshot qui, controlla la versione scaricabile dall'app stessa, non quel feed.

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 ChatWise.

Passo dopo passo

Crea una chiave su /app/keys e copiala: viene mostrata una sola volta.
In ChatWise, apri Impostazioni → Provider e fai clic su «+» per aggiungere un nuovo provider. La documentazione propone due possibilità: scegliere uno dei preset integrati oppure creare una configurazione personalizzata. Kunavo non è un preset, quindi scegli la seconda.
Compila Nome provider, API Base URL e API Key come descritto sopra. Il modulo non prevede la selezione di un fornitore: l'endpoint risolve l'ID del modello, perciò usare un ID Claude con un provider compatibile con OpenAI è la combinazione prevista, non un'incompatibilità.
Nella riga Modelli, premi Fetch. Secondo la documentazione di ChatWise, se l'API supporta l'endpoint /models, può aggiungere automaticamente i modelli disponibili. Kunavo risponde a GET /v1/models, quindi l'elenco si popola da solo. Puoi usare + Nuovo per inserire gli ID che preferisci digitare.
Se aggiungi un modello manualmente, la documentazione indica questi campi: Model ID è l'identificatore API, mentre Display Name è solo un'etichetta; l'ID deve quindi corrispondere esattamente a quello del catalogo. Seleziona Funzionalità e imposta Lunghezza del contesto in base al modello: questi flag indicano al client cosa offrire, non all'endpoint cosa fare.
Seleziona il provider nel selettore dei modelli e invia un messaggio. Per i modelli di immagini, la pagina di ChatWise dedicata alla generazione di immagini aggiunge un passaggio: imposta il tipo di modello su Immagine prima che compaia nel selettore delle immagini.

Verificato rispetto a La pagina di ChatWise dedicata ai provider personalizzati il 21 settembre 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 il costo effettivo di utilizzo di ChatWise.

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 ChatWise.

# 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 ChatWise
`claude-sonnet-5`	$1.40 / $7.00	la conversazione di tutti i giorni: chat lunghe in cui conta la qualità per ogni dollaro speso
`claude-opus-5`	$3.50 / $17.50	la domanda difficile per cui altrimenti apriresti una seconda app
`claude-haiku-4-5`	$0.70 / $3.50	titoli, riepiloghi e chiamate in background che un client di chat effettua autonomamente
`gpt-5-6-terra`	$0.70 / $4.20	documenti lunghi incollati, in cui il limite è la finestra di contesto
`gpt-5-6-sol`	$2.00 / $12.00	un secondo parere da una famiglia di modelli diversa, con la stessa chiave

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.

Domande frequenti

Come aggiungo un provider API personalizzato a ChatWise?

Apri Impostazioni, vai a Provider e fai clic su «+» per aggiungere un provider, quindi scegli un preset o crea una configurazione personalizzata. Inserisci Nome provider, API Base URL e API Key, poi aggiungi i modelli con il pulsante Fetch o con «+ Nuovo». La documentazione ufficiale di ChatWise sui provider personalizzati spiega come integrare qualsiasi servizio AI compatibile con OpenAI o Anthropic: un gateway è quindi un caso previsto, non una soluzione di ripiego.

API Base URL di ChatWise deve terminare con /v1?

Per un endpoint compatibile con OpenAI, sì. ChatWise riporta la regola sotto il campo: non includere /chat/completions nell'URL. Il client aggiunge autonomamente il percorso, quindi il valore deve essere la root /v1: https://api.kunavo.com/v1. Anche l'unico gateway ospitato mostrato nella documentazione di ChatWise con il campo compilato ha lo stesso formato: https://aihubmix.com/v1. Se ometti /v1, ottieni un 404 anziché un errore di autenticazione: è il modo più rapido per distinguere i due problemi.

Perché Fetch non restituisce modelli in ChatWise?

L'elenco viene recuperato dall'endpoint /models usando la chiave inserita, quindi se è vuoto il problema di solito riguarda la chiave o l'URL di base, non il catalogo vuoto. Prova la stessa combinazione fuori dall'app con un semplice curl verso /v1/models: se ricevi JSON, il problema è nel modulo del provider; un 401 indica un problema con la chiave, un 404 con l'URL. Puoi sempre aggiungere i modelli manualmente con «+ Nuovo»; in tal caso, l'ID modello deve corrispondere esattamente a quello del catalogo.

Serve un abbonamento o una licenza ChatWise per usare la mia chiave API?

Sono due rapporti di pagamento distinti. ChatWise è un client che si acquista una sola volta, mentre l'accesso ai modelli viene addebitato da chi gestisce la tua chiave: con una chiave Kunavo, si scala un saldo prepagato per ogni token, senza costi mensili aggiuntivi. La configurazione dei provider non figura tra le funzioni sbloccate dal piano a pagamento, ma nessuna pagina di ChatWise afferma esplicitamente che il piano gratuito consenta di aggiungere un provider personalizzato: verificalo durante il periodo di prova prima di farci affidamento.

ChatWise può usare modelli Claude senza un account Anthropic?

Sì, tramite una voce provider compatibile con OpenAI. L'ID del modello viene risolto dall'endpoint configurato, non da ChatWise, quindi le credenziali che utilizzi sono quelle di tale endpoint. Questa modalità è diversa dall'accesso tramite un abbonamento esistente nell'app, anch'esso pubblicizzato da ChatWise: in quel caso si applicano i termini di un altro fornitore, mentre con una chiave a tuo carico non è così. Kunavo non ha testato ChatWise con il proprio endpoint, quindi considera questa pagina una guida alla configurazione, non un risultato verificato.