---
title: "Dify: provider OpenAI-API-compatible (base URL) | BroadRouter"
description: "Collega Dify a BroadNet Inference con il plugin OpenAI-API-compatible: valori esatti dei campi, dimensioni del contesto e impostazioni del function calling."
url: https://broadrouter.com/it/guides/dify-openai-api-compatible/
lang: it
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Tradotto dall’inglese con l’aiuto dell’IA. [Leggi l’originale in inglese](https://broadrouter.com/guides/dify-openai-api-compatible/) (aggiornato il 2026-11-16).

# BroadNet Inference in Dify con il plugin OpenAI-API-compatible

Aggiornato 2026-11-16

In Dify installa il plugin OpenAI-API-compatible da Integrations, Model Provider, poi clicca Add Model. Scegli il tipo LLM e inserisci un ID BroadNet come broadnet/glm-5.3, la tua chiave BroadNet e come API Base URL https://inference.broadnet.ai/v1. Imposta Completion mode su Chat, la dimensione reale del contesto, un limite di output con spazio per il ragionamento e Tool Call solo per GLM 5.3 o Qwen3.8 27B.

Dify è una piattaforma open source per creare app e workflow basati su LLM. I provider che Dify non elenca per nome si aggiungono con il plugin di provider **OpenAI-API-compatible**, pubblicato dal team di Dify (langgenius). BroadNet Inference serve chat completions standard su `https://inference.broadnet.ai/v1`, quindi è compatibile. BroadRouter è il sito di BroadNet; i nomi dei campi qui sotto vengono dalla versione 0.0.83 del plugin.

## Configurazione

1.  **Procurati una chiave.** Crea una chiave a consumo nella console di BroadNet.
    
2.  **Installa il plugin.** In Dify vai su **Integrations** > **Model Provider**, cerca **OpenAI-API-compatible** tra i provider installabili (oppure aprilo nel [Marketplace](https://marketplace.dify.ai/plugin/langgenius/openai_api_compatible)) e installalo. Devi essere owner o admin del workspace.
    
3.  **Aggiungi un modello.** Clicca **Add Model** sulla scheda del provider e compila:
    
    | Campo | Valore |
    | --- | --- |
    | Model Type | LLM |
    | Model Name | `broadnet/glm-5.3` |
    | Model display name | GLM 5.3 (BroadNet) |
    | API Key | la tua chiave BroadNet |
    | API Base URL | `https://inference.broadnet.ai/v1` |
    | Completion mode | Chat |
    | Model context size | `1048576` |
    | Upper bound for max tokens | `16000` |
    | Function Call Type | Tool Call |
    | Vision Support | Not Support |
    | Structured Output | Support |
    | API Type | Chat Completions API (/chat/completions) |
    | Token parameter name | Use max\_tokens |
    
4.  **Salva.** Dify verifica le credenziali prima di aggiungere il modello.
    
5.  **Provalo.** Crea un’app Chatbot, seleziona **GLM 5.3 (BroadNet)** nel selettore dei modelli e invia un messaggio nel pannello di anteprima.
    

Ripeti **Add Model** per ogni modello BroadNet che vuoi usare. Il nome del modello deve corrispondere esattamente all’ID di BroadNet, compreso il prefisso `broadnet/`.

## Valori per modello

| Model Name | Dimensione del contesto | Function Call Type | Vision Support |
| --- | --- | --- | --- |
| `broadnet/glm-5.3` | 1048576 | Tool Call | Not Support |
| `broadnet/qwen3.8-27b` | 262144 | Tool Call | Support |
| `broadnet/deepseek-v4.1-flash` | 1048576 | Not Support (non testato) | Support |
| `broadnet/gemma-4-26b-a4b` | 32768 | Not Support | Support |

Perché queste scelte:

-   **Context size** nel plugin vale per default 4.096. Se lo lasci così, Dify taglia memoria e contesto recuperato molto al di sotto di quello che il modello accetta.
-   **Upper bound for max tokens** vale anch’esso 4.096 per default. Tre dei modelli ragionano prima di rispondere, e il ragionamento conta in questo limite, quindi lascia loro spazio. 16.000 è un nostro suggerimento, non un limite di BroadNet.
-   **Token parameter name** impostato su `max_tokens` corrisponde al campo del riferimento API di BroadNet. Per default il plugin prova a dedurlo dal nome del modello.
-   **API Type** resta su Chat Completions. BroadNet non indica la Responses API.

## Trascrizione

Il plugin può aggiungere anche modelli speech-to-text. BroadNet serve `/v1/audio/transcriptions` con `broadnet/cohere-transcribe-arabic` per l’arabo e `broadnet/cohere-transcribe` per 14 lingue. Il README del plugin dice che per lo speech-to-text aggiunge da solo il percorso di versione, quindi il suo esempio usa l’host senza `/v1` (qui, `https://inference.broadnet.ai`). Non abbiamo testato questo percorso attraverso Dify: provalo prima con un breve file WAV. Vedi la [guida allo speech-to-text in arabo](https://broadrouter.com/it/guides/arabic-speech-to-text-api/).

## Risoluzione dei problemi

-   **La verifica delle credenziali fallisce.** Controlla la chiave, l’API Base URL (per gli LLM finisce con `/v1`) e il nome del modello. I modelli a pagamento richiedono una ricarica; il credito di $5 copre solo `broadnet/gemma-4-26b-a4b` e i due modelli Transcribe.
-   **Risposte vuote in un workflow.** Il max tokens del nodo LLM è troppo basso per un modello di ragionamento. Alzalo. [Perché le risposte arrivano vuote](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/).
-   **Il nodo Agent non chiama mai gli strumenti.** Usa GLM 5.3 o Qwen3.8 27B con Function Call Type impostato su Tool Call.
-   **429 sotto carico.** Una chiave a consumo consente 30 richieste al minuto e 4 in corso. Rami paralleli e nodi di iterazione possono superare questi limiti: riducine il parallelismo. Vedi [errori e retry](https://broadrouter.com/it/guides/errors-and-retries/).

## Termini in questa guida

[Token](https://broadrouter.com/it/glossary/token/)

Un token è l’unità di testo che un modello linguistico legge e scrive: una parola, una parte di parola, un segno di punteggiatura o una sequenza di byte prodotta dal tokenizer del modello. Le API LLM contano, limitano e di solito fatturano l’uso in token.

[Base URL (URL di base)](https://broadrouter.com/it/glossary/base-url/)

La base URL è l’indirizzo radice fisso di un’API, come https://api.example.com/v1, che un client antepone a ogni percorso di endpoint, come /chat/completions. Negli SDK compatibili con OpenAI, cambiare la base URL, insieme alla chiave API e all’ID del modello, punta lo stesso codice verso un altro provider.

[Speech-to-text (riconoscimento vocale)](https://broadrouter.com/it/glossary/speech-to-text/)

Lo speech-to-text, detto anche riconoscimento automatico del parlato (ASR), è la tecnologia che converte l’audio parlato in testo scritto. Un’API speech-to-text riceve un file o uno stream audio e restituisce una trascrizione, di solito a prezzo per minuto di audio. L’accuratezza si misura con il word error rate e varia con accento, dialetto e qualità della registrazione.

[Chat Completions API](https://broadrouter.com/it/glossary/chat-completions-api/)

La Chat Completions API è l’endpoint HTTP di OpenAI, POST /v1/chat/completions, che riceve il nome di un modello e una lista di messaggi con un ruolo e restituisce il messaggio successivo del modello. La forma della sua richiesta e risposta è diventata il formato comune che riusano provider e SDK compatibili con OpenAI.

[Pagamento a consumo (pay-as-you-go)](https://broadrouter.com/it/glossary/pay-as-you-go/)

Il pagamento a consumo è un modello di prezzo in cui paghi solo ciò che usi, misurato per unità come token, richieste o minuti di audio, senza abbonamento né impegno minimo. La maggior parte delle API LLM fattura così, da un saldo prepagato o con una fattura periodica.

[Concorrenza (concurrency)](https://broadrouter.com/it/glossary/concurrency/)

La concorrenza è il numero di richieste che un client ha in corso nello stesso momento. Le API LLM spesso la limitano per chiave o per piano, separatamente dalle richieste al minuto, perché ogni richiesta aperta occupa capacità GPU finché la sua risposta non è terminata.

[Finestra di contesto (context window)](https://broadrouter.com/it/glossary/context-window/)

La finestra di contesto è il numero massimo di token con cui un modello linguistico può lavorare in una singola richiesta. Comprende prompt, cronologia della conversazione, definizioni degli strumenti, immagini e output generato, token di ragionamento inclusi. Ciò che non ci sta va tagliato, riassunto o diviso su più richieste.

[Output strutturato (structured output)](https://broadrouter.com/it/glossary/structured-output/)

L’output strutturato è una funzionalità delle API LLM che vincola la risposta di un modello a un formato indicato dallo sviluppatore, di solito un JSON Schema, così il codice può interpretarla in modo affidabile. È più rigoroso della JSON mode, che garantisce un JSON valido ma non una struttura precisa.

## Domande frequenti

### BroadNet funziona sia su Dify Cloud sia su Dify self-hosted?

Sì. BroadNet Inference è un endpoint HTTPS pubblico, quindi Dify Cloud può raggiungerlo. Secondo la documentazione di Dify, solo owner e admin del workspace possono gestire i provider di modelli, e una chiave aggiunta vale per tutto il workspace.

### L’API Base URL deve includere /v1?

Sì, per i modelli LLM. Gli esempi del plugin usano un base URL che finisce con /v1 per i modelli di chat, e il suo README avverte che per alcuni altri tipi di modello il percorso di versione lo aggiunge da solo.

### Quale Function Call Type devo scegliere?

Tool Call per GLM 5.3 e Qwen3.8 27B, che BroadNet indica con strumenti. Per DeepSeek V4.1 Flash scegli Not Support, a meno che tu non abbia provato di persona le chiamate agli strumenti.

### I crediti AI di Dify valgono per i modelli BroadNet?

No. Secondo la documentazione di Dify, i crediti AI non si applicano ai provider che usi con il tuo account. BroadNet addebita la chiave che inserisci.

## Guide correlate

-   [Usare BroadNet Inference in n8n (credenziale OpenAI, Base URL)](https://broadrouter.com/it/guides/n8n-openai-compatible/)
-   [Collegare Open WebUI a BroadNet Inference](https://broadrouter.com/it/guides/open-webui-openai-api/)
-   [Perché un modello di ragionamento restituisce una risposta vuota](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/)
-   [Codici di errore di BroadNet Inference e quando ritentare](https://broadrouter.com/it/guides/errors-and-retries/)
-   [Tutti gli strumenti che funzionano con BroadNet Inference (in inglese)](https://broadrouter.com/integrations/): SDK, agenti di coding, interfacce di chat e strumenti di automazione, con le impostazioni esatte per ciascuno

Provalo sul tuo carico di lavoro reale. I nuovi account partono con USD 5 di credito per Gemma e trascrizione. DeepSeek, GLM e Qwen3.8 richiedono una ricarica.

[Inizia](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-dify-openai-api-compatible&utm_content=page-cta) ·

**Fonti**

-   [Documentazione di Dify, Model Providers (verificata il 2026-11-15)](https://docs.dify.ai/en/cloud/use-dify/workspace/model-providers)
-   [Dify Marketplace, plugin OpenAI-API-compatible di langgenius, versione 0.0.83 (verificato il 2026-11-15)](https://marketplace.dify.ai/plugin/langgenius/openai_api_compatible)
-   [Codice sorgente del plugin, campi del provider openai\_api\_compatible (verificato il 2026-11-15)](https://github.com/langgenius/dify-official-plugins/tree/main/models/openai_api_compatible)
-   [Riferimento API di BroadNet Inference (verificato il 2026-11-15) (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-dify-openai-api-compatible&utm_content=sources)
