Documentazione

Chatbox

Chatbox divide l'endpoint in host e percorso, e compila automaticamente il percorso. L'host è quindi l'origine: inserire /v1 è l'errore che questo client rende più facile commettere.

Aggiungi un provider di tipo OpenAI API Compatible con API Host impostato sulla radice del servizio — Chatbox aggiunge autonomamente /v1/chat/completions.

Impostazioni di Chatbox

Settings → Model Providers → Add

  API 提供方名称 / Provider name   Kunavo
  API 类型 / Type                 OpenAI API 兼容 (OpenAI API compatible)
  API 密钥 / API Key              sk-kn-...
  API 主机 / API Host             https://api.kunavo.com
  API 路径 / API Path             (leave empty → /v1/chat/completions)
  Model                           claude-sonnet-5

API Host è https://api.kunavo.com, senza /v1. Chatbox dispone di un campo API Path separato, il cui valore predefinito è /v1/chat/completions; quindi, se l'host termina già con /v1, le richieste vengono inviate a /v1/v1/chat/completions. Lascia vuoto il percorso, a meno che tu non sappia di aver bisogno di un valore diverso.

Il selettore del tipo di provider di Chatbox indica un formato di comunicazione. Scegli Compatibile con API OpenAI e inserisci un ID di modello Claude: l'ID viene risolto dall'endpoint, quindi le due impostazioni non sono in conflitto.

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

Passo dopo passo

Crea una chiave su /app/keys e copiala: viene mostrata una sola volta.
Apri Impostazioni → Provider di modelli e fai clic su Aggiungi.
Assegna un nome al provider, imposta il tipo su Compatibile con API OpenAI e incolla la chiave API.
Imposta API 主机 / API Host su https://api.kunavo.com e lascia vuoto API 路径 / API Path.
Aggiungi gli ID dei modelli che vuoi usare, salva e avvia una conversazione.

Verificato rispetto a La guida alla configurazione dei provider di Chatbox il 6 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.

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

# 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 Chatbox
`claude-sonnet-5`	$1.40 / $7.00	il modello di conversazione predefinito
`claude-haiku-4-5`	$0.70 / $3.50	scambi brevi, in cui contano sia la latenza sia il prezzo
`claude-opus-5`	$3.50 / $17.50	una seconda voce provider da tenere a disposizione per le domande difficili
`gpt-5-6-terra`	$0.70 / $4.20	un'altra famiglia di modelli sulla 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

Quale valore devo impostare in API Host di Chatbox per un endpoint compatibile con OpenAI?

L'origine, senza percorso, ad esempio https://api.example.com. Chatbox ha un campo API Path separato, il cui valore predefinito è /v1/chat/completions e che, secondo la documentazione, in genere non deve essere compilato: /v1 proviene quindi dal percorso, non dall'host. Un host che termina con /v1 genera richieste a /v1/v1/chat/completions e restituisce 404.

Come aggiungo un provider di modelli personalizzato in Chatbox?

Apri Impostazioni → Provider di modelli e fai clic su Aggiungi. Assegna un nome al provider, scegli il tipo di API compatibile con OpenAI, incolla la chiave API, imposta API Host sull'origine dell'endpoint e lascia vuoto API Path. Aggiungi gli ID dei modelli che vuoi usare e salva: il provider apparirà quindi nel selettore dei modelli di ogni conversazione.

Chatbox può usare modelli Claude?

Sì, tramite un endpoint compatibile con OpenAI che li offre. Chatbox invia l'ID del modello inserito all'host configurato, quindi l'ID Claude viene risolto lì e non in Chatbox; l'app non ha bisogno di credenziali Anthropic proprie. Il selettore del tipo di provider sceglie un formato di comunicazione, non un fornitore.

Quando devo compilare API Path in Chatbox?

Solo se l'endpoint non offre chat completions su /v1/chat/completions. Il campo è previsto per i gateway con routing non standard; per un servizio standard compatibile con OpenAI è corretto lasciarlo vuoto. Inserire un percorso è una causa comune di errori 404 che sembrano problemi di autenticazione.