Dify

Un solo campo obbligatorio — API Base URL, nel modulo Add Model del plugin compatibile con OpenAI API — indirizza ogni nodo LLM di uno spazio di lavoro Dify verso Kunavo.

# Integrations → Model Provider → OpenAI-API-compatible → Add Model
Type                          LLM
Model Name                    claude-sonnet-5
Model display name            Kunavo · Claude Sonnet 5
API Key                       sk-kn-...
API Base URL                  https://api.kunavo.com/v1
model name for API endpoint   (leave blank — Model Name is already the id)
Completion mode               Chat
Model context size            1000000
Upper bound for max tokens    (your own ceiling for one reply)
Function Call Type            Tool Call     # defaults to no_call
Vision Support                Support       # only if you will send images
Structured Output             Support       # defaults to not supported

# Model context size is per model, not per endpoint: 1000000 is
# claude-sonnet-5's. The table below carries the rest.

Passo dopo passo

1. Crea una chiave su /app/keys e copiala: viene mostrata una sola volta.
2. In Dify, apri Integrations → Model Provider, vai su Install model providers (o nel Marketplace) e installa OpenAI-API-compatible, pubblicato da langgenius. La documentazione di Dify specifica che solo il proprietario e gli amministratori del workspace possono gestire i provider.
3. Fai clic su Add Model nella scheda di quel provider. Il plugin non offre modelli predefiniti: è un provider customizable-model; quindi ogni ID che vuoi usare richiede una voce separata.
4. Compila il modulo come sopra. Type = LLM, Model Name = l’ID Kunavo esatto, API Key = la tua chiave sk-kn-, API Base URL = https://api.kunavo.com/v1, Completion mode = Chat e Model context size come indicato nella tabella qui sotto. Poi imposta Function Call Type e, se ti servono, Structured Output e Vision Support. Salva.
5. Apri un flusso di lavoro e seleziona il modello nel nodo che deve usarlo: Dify assegna i modelli per nodo, non per app, quindi un classificatore e un nodo di scrittura finale possono usare ID e prezzi diversi. Le app e i nodi per cui non selezioni un modello usano Default Models → System Reasoning Model come fallback.
6. Esegui un flusso di lavoro con limiti definiti, poi controlla l’addebito nel tuo account Kunavo, non in Dify: vedi la nota sulla visualizzazione dei costi qui sotto.

Verificato rispetto a La pagina del plugin OpenAI-API-compatible di Dify 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.

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

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

Due cose diverse si chiamano «API di Dify»

Questa pagina tratta una delle due, ma nei risultati di ricerca vengono spesso confuse.

1. Aggiungere un modello a Dify: è ciò che fa la procedura di configurazione qui sopra. Dify è il client, Kunavo è l’endpoint e la credenziale che incolli è una chiave sk-kn-. Da quel momento, ogni nodo LLM di ogni app in quel workspace può richiamare gli ID che hai aggiunto.
2. Richiamare un’app Dify dal tuo codice: è la Service API che Dify espone per un’app pubblicata, con una propria chiave app- rilasciata da Dify. Quella chiave è di Dify, non nostra, e non è possibile indirizzarla altrove. Kunavo non interviene in questo flusso.

Possono funzionare contemporaneamente sulla stessa app, e di solito è così: il tuo backend chiama l’app Dify con una chiave Dify e i nodi dell’app chiamano Kunavo con una chiave Kunavo. Due chiavi, due fatture, due punti da controllare quando qualcosa restituisce un errore 401.

Perché Dify non mostra i costi del modello che hai aggiunto

I file dei modelli predefiniti di Dify includono una sezione sui prezzi: tariffe di input e output e un’unità per token. Dify moltiplica i conteggi dei token per queste tariffe e mostra un importo nel log. Lo schema del provider OpenAI-API-compatible non dichiara alcun campo relativo a prezzo, unità o valuta; è stato verificato alla data indicata sopra. Perciò, per un modello aggiunto tramite questo plugin, Dify non ha una tariffa da applicare ai conteggi: l’importo mancante non è uno sconto che hai trovato né un bug che hai causato, è un campo che non esiste. Consulta il dato effettivo nel riepilogo dell’utilizzo Kunavo e considera i conteggi di Dify come conteggi di token.

C’è un’impostazione correlata che conviene lasciare invariata: Include Usage in Stream è attivata per impostazione predefinita e chiede all’endpoint i conteggi dei token di prompt e completamento nell’ultimo blocco dello stream. Disattivandola, perdi anche i conteggi dei token.

Se ospiti Dify autonomamente

Lo stack Docker Compose instrada le richieste in uscita tramite un servizio ssrf_proxy, quindi l’endpoint deve essere raggiungibile dall’interno della rete dei container, non soltanto dal browser sul tuo portatile. Se la configurazione funziona da un punto ma dall’altro va in timeout, di solito il problema è questo: riguarda la rete, non le credenziali. La curl qui sopra, eseguita dall’interno del container, fornisce una risposta diretta.