---
title: "Open WebUI com endpoint compatível com a OpenAI | BroadRouter"
description: "Adicione a BroadNet Inference ao Open WebUI como conexão compatível com a OpenAI, coloque os IDs na allowlist e resolva verificação, respostas vazias e 429."
url: https://broadrouter.com/pt/guides/open-webui-openai-api/
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/open-webui-openai-api/) (atualizado em 2026-11-16).

# Como conectar o Open WebUI à BroadNet Inference

Atualizado em 2026-11-16

No Open WebUI, vá em Settings > Connections, na seção de administração, clique em Add Connection em Manage OpenAI API Connections, defina URL como https://inference.broadnet.ai/v1 e API Key com a sua chave da BroadNet, depois adicione IDs de modelo como broadnet/glm-5.3 à allowlist Model IDs e salve.

O Open WebUI é uma interface de chat auto-hospedada. Ele se conecta a qualquer provedor que implemente o protocolo de chat completions da OpenAI, e a BroadNet Inference implementa. Os passos seguem [o guia do Open WebUI para provedores compatíveis com a OpenAI](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible).

## Configuração

1.  **Pegue uma chave da BroadNet.** Para uma interface de chat usada por várias pessoas, o certo é uma chave de pagamento por uso. Veja [chaves de API e listas de IPs permitidos](https://broadrouter.com/pt/guides/api-keys-ip-allow-lists/).
    
2.  **Abra a página de conexões.** Vá em **Settings > Connections**, na seção de administração, e encontre **Manage OpenAI API Connections**.
    
3.  **Clique em Add Connection** e preencha:
    
    | Campo | Valor |
    | --- | --- |
    | URL | `https://inference.broadnet.ai/v1` (sem barra no final) |
    | API Key | a sua chave da BroadNet |
    | Model IDs | adicione cada ID abaixo, um de cada vez, com o ícone **+** |
    
4.  **Adicione os IDs de modelo manualmente.** Digite `broadnet/glm-5.3`, clique em **+** e repita para os outros que quiser. A documentação da BroadNet descreve `GET /v1/models` como metadados públicos do catálogo para monitores, então não conte com ele para preencher o seletor de modelos.
    
5.  **Clique em Save.** A documentação do Open WebUI observa que salvar não testa a conexão.
    
6.  **Comece um chat** e escolha o modelo no seletor de modelos.
    

### Com variáveis de ambiente

Se você roda o Open WebUI no Docker, pode configurar a conexão na inicialização:

```bash
OPENAI_API_BASE_URL=https://inference.broadnet.ai/v1
OPENAI_API_KEY=your-broadnet-key
```

Para adicionar a BroadNet ao lado de uma conexão OpenAI que já existe, use as formas no plural, com os valores separados por ponto e vírgula: `OPENAI_API_BASE_URLS` e `OPENAI_API_KEYS`. `OPENAI_API_CONFIGS` define opções por conexão, como `model_ids`, indexadas pela posição da conexão nessa lista:

```bash
OPENAI_API_CONFIGS='{"0": {"enable": true, "model_ids": ["broadnet/glm-5.3", "broadnet/qwen3.8-27b"]}}'
```

A [referência de variáveis de ambiente](https://docs.openwebui.com/reference/env-configuration) do Open WebUI marca essas variáveis como ConfigVar. Elas são lidas na primeira inicialização e salvas no banco de dados. Daí em diante, vale o painel de administração. Edite a conexão em **Settings > Connections**, na seção de administração, ou defina `ENABLE_PERSISTENT_CONFIG=False` se quiser que o ambiente seja aplicado a cada inicialização.

## Qual modelo escolher

| Uso | Modelo | Contexto |
| --- | --- | --- |
| Chat geral, ferramentas, JSON | `broadnet/glm-5.3` | 1.048.576 |
| Perguntas sobre imagens, árabe | `broadnet/qwen3.8-27b` | 262.144 |
| Documentos longos, imagens | `broadnet/deepseek-v4.1-flash` | 1.048.576 |
| Custo baixo, crédito gratuito | `broadnet/gemma-4-26b-a4b` | 32.768 |

A BroadNet testou o Qwen3.8 27B em árabe, incluindo os dialetos do Golfo e egípcio; veja [como escolher um LLM para árabe](https://broadrouter.com/pt/blog/choosing-an-llm-for-arabic/). O Gemma 4 VL 26B é o único modelo de chat que funciona com o crédito inicial de $5; o crédito também cobre os dois modelos Transcribe. Os preços de cada um estão na [página de preços](https://broadrouter.com/pt/pricing/).

O Open WebUI repassa parâmetros padrão como `temperature` e `max_tokens` e suporta uso de ferramentas quando o modelo e o servidor suportam `tools`. A BroadNet lista ferramentas para GLM 5.3 e Qwen3.8 27B.

## Solução de problemas

-   **Verify Connection falha com 400, 401 ou 403.** O botão de verificação do Open WebUI chama `/models`. A documentação dele diz que chat completions pode funcionar mesmo assim. Adicione os IDs à allowlist e teste um chat. Se o chat também retornar 401, a chave está errada, expirou ou ficou sem cota de pagamento por uso.
-   **O modelo aparece na lista, mas a primeira mensagem falha.** Confira se o ID é exatamente o da BroadNet, com o prefixo `broadnet/`. GLM 5.3, Qwen3.8 27B e DeepSeek V4.1 Flash exigem uma recarga.
-   **Respostas vazias.** Os modelos de raciocínio (DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B) gastam primeiro tokens de saída no raciocínio. Se você definiu **max\_tokens** nos **Advanced Params** do modelo, aumente ou apague o valor. [Por que as respostas vêm vazias](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/).
-   **429 quando várias pessoas usam o chat.** Uma chave de pagamento por uso permite 30 requisições por minuto e 4 ao mesmo tempo. O Open WebUI também faz chamadas em segundo plano, como a geração de títulos dos chats, com a mesma chave. Veja [erros e novas tentativas](https://broadrouter.com/pt/guides/errors-and-retries/).
-   **Variáveis de ambiente alteradas não fazem nada.** A primeira inicialização salvou os valores antigos. Edite a conexão no painel de administração ou veja a seção sobre variáveis de ambiente acima.
-   **Usando uma chave de plano.** Uma [sessão do plano ilimitado](https://broadrouter.com/pt/guides/unlimited-llm-api-sessions/) roda uma requisição por vez, e as chaves não podem ser compartilhadas. Serve para a instância pessoal de uma pessoa; as requisições de outros usuários entram em fila.

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

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

[Tool calling (chamada de ferramentas)](https://broadrouter.com/pt/glossary/tool-calling/)

Tool calling, também chamado de function calling ou chamada de ferramentas, é um recurso de APIs de LLM em que o modelo devolve um pedido estruturado para executar uma função definida pelo desenvolvedor, com argumentos JSON. A aplicação executa a função e devolve o resultado; o modelo nunca executa código sozinho.

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

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

[Chave de API (API key)](https://broadrouter.com/pt/glossary/api-key/)

Uma chave de API é uma string secreta que identifica e autoriza um cliente que chama uma API. As APIs de LLM normalmente a esperam em um cabeçalho Authorization: Bearer, e qualquer pessoa que tenha a chave pode fazer requisições cobradas da conta dona dela.

[Crédito pré-pago (prepaid credit)](https://broadrouter.com/pt/glossary/prepaid-credit/)

Crédito pré-pago é dinheiro adicionado a uma conta de API antes do uso. Cada requisição desconta o próprio custo do saldo e, quando o saldo acaba, as requisições cobradas por uso param até você fazer uma recarga. Ele limita o gasto ao que você já pagou.

## Perguntas frequentes

### Por que o Verify Connection falha, mas o chat funciona?

O botão de verificação do Open WebUI chama o endpoint /models do provedor. A documentação dele diz que uma verificação com falha não significa que o chat está quebrado. Adicione manualmente os IDs de modelo da BroadNet à allowlist Model IDs.

### Dá para configurar a conexão com variáveis de ambiente?

Sim. Defina OPENAI\_API\_BASE\_URL como https://inference.broadnet.ai/v1 e OPENAI\_API\_KEY com a sua chave da BroadNet. O Open WebUI salva esses valores na primeira inicialização, então mudanças posteriores nas variáveis são ignoradas, a menos que ENABLE\_PERSISTENT\_CONFIG seja False.

### Por que o novo valor de OPENAI\_API\_BASE\_URL não fez efeito?

O Open WebUI trata essa variável como ConfigVar. Depois da primeira inicialização, ele usa o valor salvo no banco de dados. Mude a URL em Settings > Connections, na seção de administração, ou defina ENABLE\_PERSISTENT\_CONFIG=False para ler o ambiente a cada inicialização.

### Minha equipe toda pode compartilhar uma chave do plano ilimitado no Open WebUI?

Não. Os planos da BroadNet não permitem compartilhar chaves, e uma sessão do plano roda uma requisição por vez. Para um Open WebUI compartilhado, use uma chave de pagamento por uso.

## Guias relacionados

-   [Adicionar a BroadNet Inference ao LibreChat como custom endpoint](https://broadrouter.com/pt/guides/librechat-custom-endpoint/)
-   [Por que um modelo de raciocínio devolve uma resposta vazia](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/)
-   [Como funcionam os planos de API de LLM ilimitada para agentes](https://broadrouter.com/pt/guides/unlimited-llm-api-sessions/)
-   [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-open-webui-openai-api&utm_content=page-cta) ·

**Fontes**

-   [Documentação do Open WebUI, provedores compatíveis com a OpenAI (conferido em 2026-11-16)](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible)
-   [Documentação do Open WebUI, configuração por variáveis de ambiente (conferido em 2026-11-14)](https://docs.openwebui.com/reference/env-configuration)
-   [Referência da API da BroadNet Inference (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-guides-open-webui-openai-api&utm_content=sources)
