---
title: "Dify: provedor OpenAI-API-compatible (base URL) | BroadRouter"
description: "Conecte o Dify à BroadNet Inference pelo plugin OpenAI-API-compatible, com os valores exatos dos campos, tamanhos de contexto e ajustes de function calling."
url: https://broadrouter.com/pt/guides/dify-openai-api-compatible/
lang: pt-BR
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traduzido do inglês com ajuda de IA. [Leia o original em inglês](https://broadrouter.com/guides/dify-openai-api-compatible/) (atualizado em 2026-11-16).

# BroadNet Inference no Dify com o plugin OpenAI-API-compatible

Atualizado em 2026-11-16

No Dify, instale o plugin OpenAI-API-compatible em Integrations, Model Provider e clique em Add Model. Escolha o tipo LLM e informe um ID da BroadNet como broadnet/glm-5.3, a sua chave da BroadNet e o API Base URL https://inference.broadnet.ai/v1. Defina Completion mode como Chat, o tamanho real do contexto, um limite de saída com espaço para o raciocínio e Tool Call só para GLM 5.3 ou Qwen3.8 27B.

O Dify é uma plataforma open source para criar apps e workflows com LLMs. Provedores que o Dify não lista pelo nome são adicionados pelo plugin de provedor de modelo **OpenAI-API-compatible**, publicado pela equipe do Dify (langgenius). A BroadNet Inference serve chat completions padrão em `https://inference.broadnet.ai/v1`, então se encaixa. O BroadRouter é o site da própria BroadNet; os nomes de campo abaixo vêm da versão 0.0.83 do plugin.

## Configuração

1.  **Pegue uma chave.** Crie uma chave de pagamento por uso no console da BroadNet.
    
2.  **Instale o plugin.** No Dify, vá em **Integrations** > **Model Provider**, encontre **OpenAI-API-compatible** entre os provedores disponíveis para instalar (ou abra no [Marketplace](https://marketplace.dify.ai/plugin/langgenius/openai_api_compatible)) e instale. Você precisa ser owner ou admin do workspace.
    
3.  **Adicione um modelo.** Clique em **Add Model** no card do provedor e preencha:
    
    | Campo | Valor |
    | --- | --- |
    | Model Type | LLM |
    | Model Name | `broadnet/glm-5.3` |
    | Model display name | GLM 5.3 (BroadNet) |
    | API Key | a sua chave da 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.  **Salve.** O Dify valida as credenciais antes de adicionar o modelo.
    
5.  **Teste.** Crie um app Chatbot, selecione **GLM 5.3 (BroadNet)** no seletor de modelos e envie uma mensagem no painel de pré-visualização.
    

Repita **Add Model** para cada modelo da BroadNet que quiser. O nome do modelo precisa bater exatamente com o ID da BroadNet, incluindo o prefixo `broadnet/`.

## Valores por modelo

| Model Name | Tamanho do contexto | 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 (não testado) | Support |
| `broadnet/gemma-4-26b-a4b` | 32768 | Not Support | Support |

Por que essas escolhas:

-   **Context size** tem padrão 4.096 no plugin. Se ficar assim, o Dify corta a memória e o contexto recuperado muito abaixo do que o modelo aceita.
-   **Upper bound for max tokens** também tem padrão 4.096. Três dos modelos raciocinam antes de responder, e o raciocínio conta para esse limite, então dê espaço a eles. 16.000 é uma sugestão nossa, não um limite da BroadNet.
-   **Token parameter name** definido como `max_tokens` corresponde ao campo da referência da API da BroadNet. O padrão do plugin é adivinhar pelo nome do modelo.
-   **API Type** fica em Chat Completions. A BroadNet não lista a Responses API.

## Transcrição

O plugin também pode adicionar modelos de fala para texto (speech-to-text). A BroadNet serve `/v1/audio/transcriptions` com `broadnet/cohere-transcribe-arabic` para árabe e `broadnet/cohere-transcribe` para 14 idiomas. O README do plugin diz que, para speech-to-text, ele mesmo adiciona o caminho da versão, então o exemplo dele usa o host sem `/v1` (aqui, `https://inference.broadnet.ai`). Não testamos esse caminho pelo Dify; confira primeiro com um arquivo WAV curto. Veja o [guia de fala para texto em árabe](https://broadrouter.com/pt/guides/arabic-speech-to-text-api/).

## Solução de problemas

-   **A validação das credenciais falha.** Confira a chave, o API Base URL (termina em `/v1` para LLMs) e o nome do modelo. Modelos pagos exigem uma recarga; o crédito de $5 cobre só `broadnet/gemma-4-26b-a4b` e os dois modelos Transcribe.
-   **Respostas vazias em um workflow.** O max tokens do nó LLM está baixo demais para um modelo de raciocínio. Aumente-o. [Por que as respostas vêm vazias](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/).
-   **O nó Agent nunca chama ferramentas.** Use GLM 5.3 ou Qwen3.8 27B com Function Call Type em Tool Call.
-   **429 sob carga.** Uma chave de pagamento por uso permite 30 requisições por minuto e 4 em andamento. Ramos paralelos e nós de iteração podem passar disso; reduza o paralelismo deles. Veja [erros e novas tentativas](https://broadrouter.com/pt/guides/errors-and-retries/).

## Termos neste guia

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

Um token é a unidade de texto que um modelo de linguagem lê e escreve: uma palavra, parte de uma palavra, um sinal de pontuação ou uma sequência de bytes gerada pelo tokenizador do modelo. As APIs de LLM contam, limitam e normalmente cobram o uso em tokens.

[Fala para texto (speech-to-text)](https://broadrouter.com/pt/glossary/speech-to-text/)

Fala para texto, ou reconhecimento automático de fala (ASR), é a tecnologia que converte áudio falado em texto. Uma API de fala para texto recebe um arquivo ou stream de áudio e retorna uma transcrição, normalmente cobrada por minuto de áudio. A precisão é medida pela taxa de erro de palavras e varia com sotaque, dialeto e qualidade da gravação.

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

A base URL é o endereço raiz fixo de uma API, como https://api.example.com/v1, que um cliente coloca antes de cada caminho de endpoint, como /chat/completions. Nos SDKs compatíveis com a OpenAI, trocar a base URL, junto com a chave de API e o ID do modelo, aponta o mesmo código para outro provedor.

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

A Chat Completions API é o endpoint HTTP da OpenAI, POST /v1/chat/completions, que recebe o nome de um modelo e uma lista de mensagens marcadas com papéis e devolve a próxima mensagem do modelo. O formato da requisição e da resposta virou o padrão comum que provedores e SDKs compatíveis com a OpenAI reutilizam.

[Pagamento por uso (pay-as-you-go)](https://broadrouter.com/pt/glossary/pay-as-you-go/)

Pagamento por uso é um modelo de preço em que você paga só pelo que usa, medido por unidade, como tokens, requisições ou minutos de áudio, sem assinatura nem compromisso mínimo. A maioria das APIs de LLM cobra assim, a partir de um saldo pré-pago ou de uma fatura periódica.

[Janela de contexto (context window)](https://broadrouter.com/pt/glossary/context-window/)

A janela de contexto é o número máximo de tokens com que um modelo de linguagem consegue trabalhar em uma única requisição. Ela abrange o prompt, o histórico da conversa, as definições de ferramentas, as imagens e a saída gerada, incluindo os tokens de raciocínio. O que não couber precisa ser cortado, resumido ou dividido em várias requisições.

[Concorrência (concurrency)](https://broadrouter.com/pt/glossary/concurrency/)

Concorrência é o número de requisições que um cliente tem em andamento ao mesmo tempo. APIs de LLM muitas vezes a limitam por chave ou por plano, separadamente das requisições por minuto, porque cada requisição aberta ocupa capacidade de GPU até a resposta terminar.

[Rate limit (limite de taxa)](https://broadrouter.com/pt/glossary/rate-limit/)

Um rate limit é um teto que uma API impõe a quanto um cliente pode usá-la em um intervalo de tempo, como requisições por minuto ou tokens por minuto. As requisições acima do limite são recusadas, normalmente com HTTP 429 Too Many Requests, até que o uso volte a ficar abaixo dele.

## Perguntas frequentes

### A BroadNet funciona no Dify Cloud e também no Dify self-hosted?

Sim. A BroadNet Inference é um endpoint HTTPS público, então o Dify Cloud consegue acessá-la. A documentação do Dify diz que só owners e admins do workspace podem gerenciar provedores de modelo, e uma chave adicionada vale para o workspace inteiro.

### O API Base URL deve incluir /v1?

Sim, para modelos LLM. Os exemplos do próprio plugin usam um base URL terminado em /v1 para modelos de chat, e o README avisa que, para alguns outros tipos de modelo, ele mesmo adiciona o caminho da versão.

### Qual Function Call Type devo escolher?

Tool Call para GLM 5.3 e Qwen3.8 27B, que a BroadNet lista com ferramentas. Escolha Not Support para o DeepSeek V4.1 Flash, a menos que você mesmo tenha testado chamadas de ferramenta nele.

### Os créditos de IA do Dify valem para os modelos da BroadNet?

Não. A documentação do Dify diz que os créditos de IA não valem para provedores que você usa com a sua própria conta. A BroadNet cobra a chave que você informar.

## Guias relacionados

-   [Como usar a BroadNet Inference no n8n (credencial OpenAI, Base URL)](https://broadrouter.com/pt/guides/n8n-openai-compatible/)
-   [Como conectar o Open WebUI à BroadNet Inference](https://broadrouter.com/pt/guides/open-webui-openai-api/)
-   [Por que um modelo de raciocínio devolve uma resposta vazia](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/)
-   [Códigos de erro da BroadNet Inference e quando tentar de novo](https://broadrouter.com/pt/guides/errors-and-retries/)
-   [Todas as ferramentas que funcionam com a BroadNet Inference (em inglês)](https://broadrouter.com/integrations/): SDKs, agentes de programação, interfaces de chat e ferramentas de automação, com as configurações exatas de cada uma

Teste com a sua carga de trabalho real. Contas novas começam com US$ 5 de crédito para Gemma e transcrição. DeepSeek, GLM e Qwen3.8 exigem uma recarga.

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

**Fontes**

-   [Documentação do Dify, Model Providers (conferido em 2026-11-15)](https://docs.dify.ai/en/cloud/use-dify/workspace/model-providers)
-   [Dify Marketplace, plugin OpenAI-API-compatible da langgenius, versão 0.0.83 (conferido em 2026-11-15)](https://marketplace.dify.ai/plugin/langgenius/openai_api_compatible)
-   [Código-fonte do plugin, campos do provedor openai\_api\_compatible (conferido em 2026-11-15)](https://github.com/langgenius/dify-official-plugins/tree/main/models/openai_api_compatible)
-   [Referência da API da BroadNet Inference (conferido em 2026-11-15) (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-guides-dify-openai-api-compatible&utm_content=sources)
