---
title: "Jan: endpoint personalizado para API compatível com a OpenAI"
description: "Adicione a BroadNet Inference ao app desktop Jan como provedor personalizado compatível com a OpenAI, cadastre os IDs dos modelos e ative ferramentas e visão."
url: https://broadrouter.com/pt/guides/jan-custom-endpoint/
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/jan-custom-endpoint/) (atualizado em 2026-11-16).

# Jan com a BroadNet Inference: provedor compatível com a OpenAI

Atualizado em 2026-11-16

No Jan, abra Settings, Model Providers e clique em Add Provider. Escolha OpenAI-compatible, dê o nome BroadNet, defina Base URL como https://inference.broadnet.ai/v1 e cole a sua chave da BroadNet. Depois adicione os modelos de chat à mão com o botão +, por exemplo broadnet/glm-5.3, e ative Tools ou visão nas capabilities de cada modelo.

O Jan é um app desktop open source de chat que roda modelos locais e se conecta a APIs na nuvem. Qualquer serviço que fale o formato da OpenAI pode ser adicionado como **provedor personalizado**. A BroadNet Inference oferece chat completions padrão em `https://inference.broadnet.ai/v1`. O BroadRouter é o site da própria BroadNet; os passos seguem [a página Custom Endpoints do Jan](https://docs.jan.ai/desktop/remote-models/custom-endpoint) na versão 0.8.8.

## Configuração

1.  **Consiga uma chave.** Crie uma chave de pagamento por uso no console da BroadNet, ou compre uma chave por hora ou um plano.
    
2.  **Abra a janela.** Vá em **Settings** > **Model Providers** e clique no botão **Add Provider** ao lado da lista.
    
3.  **Escolha o formato da API.** Selecione **OpenAI-compatible**, o padrão.
    
4.  **Preencha os dados:**
    
    | Campo | Valor |
    | --- | --- |
    | Provider name | BroadNet |
    | Base URL | `https://inference.broadnet.ai/v1` |
    | API key | a sua chave da BroadNet |
    
5.  Clique em **Create**.
    
6.  **Adicione os modelos à mão.** Na seção **Models** do provedor, clique em **+** e digite exatamente cada ID de modelo de chat, por exemplo `broadnet/glm-5.3`.
    
7.  **Defina as capabilities.** Clique no lápis ao lado de cada modelo e ative o que ele suporta (tabela abaixo). O Jan não detecta isso em provedores personalizados.
    
8.  **Teste.** Abra um chat novo, escolha o modelo da BroadNet no seletor de modelos e envie uma mensagem curta.
    

O Jan busca `https://inference.broadnet.ai/v1/models` quando você salva. A documentação da BroadNet descreve esse endpoint como metadados do catálogo para monitores, e quando conferimos, em 15 de novembro de 2026, ele listava só os dois modelos de transcrição. Esses modelos não conversam; remova-os se aparecerem.

## IDs dos modelos e capabilities

| Modelo | ID | Ferramentas | Imagens | Contexto |
| --- | --- | --- | --- | --- |
| GLM 5.3 | `broadnet/glm-5.3` | Ligado | Desligado | 1.048.576 |
| Qwen3.8 27B | `broadnet/qwen3.8-27b` | Ligado | Ligado | 262.144 |
| DeepSeek V4.1 Flash | `broadnet/deepseek-v4.1-flash` | Desligado (não listado pela BroadNet) | Ligado | 1.048.576 |
| BroadNet Gemma 4 VL 26B | `broadnet/gemma-4-26b-a4b` | Desligado | Ligado | 32.768 |

`broadnet/gemma-4-26b-a4b` é o único modelo de chat que roda com o crédito inicial de $5, e é o modelo por trás da [chave por hora](https://broadrouter.com/pt/blog/hourly-llm-api-key-explained/) da BroadNet ($0.50 por uma hora, um stream). Os outros exigem uma recarga ou, no caso do DeepSeek V4.1 Flash, um [plano ilimitado](https://broadrouter.com/pt/guides/unlimited-llm-api-sessions/).

## Configurações que vale mudar

-   **Limite de saída.** Três dos modelos raciocinam antes de responder, e o raciocínio conta para `max_tokens`. Se você definir um limite de saída para um modelo da BroadNet, mantenha em 1.000 tokens ou mais.
-   **Samplers.** Em provedores personalizados, o Jan mostra o conjunto completo de parâmetros de amostragem, e a documentação dele avisa que endpoints personalizados podem ignorar sem aviso os samplers que não suportam. Se uma configuração como min-P parecer não fazer nada, é por isso.
-   **Chaves reserva.** O Jan pode guardar várias chaves por provedor e tenta a próxima em caso de 401, 403 ou 429. A [Política de Uso Aceitável](https://www.broadnet.ai/aup) da BroadNet proíbe contornar limites de taxa ou de concorrência, então use chaves extras para failover, não para multiplicar os seus limites.

## Solução de problemas

-   **404 em toda requisição.** Falta `/v1` no Base URL. A documentação do Jan chama isso de erro mais comum.
-   **401 ou 403.** A chave está errada, expirou ou ficou sem cota. Um resultado positivo em **Test keys** não prova que a chave funciona, porque o `/v1/models` da BroadNet respondia sem chave quando conferimos.
-   **Modelo não encontrado.** Confira o ID, incluindo o prefixo `broadnet/`. Os modelos pagos exigem uma recarga.
-   **Respostas vazias.** O raciocínio gastou o orçamento de saída. Aumente o limite de saída. [Por que as respostas vêm vazias](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/).
-   **429.** Uma chave de pagamento por uso permite 30 requisições por minuto e 4 em andamento; uma chave por hora roda um stream por vez. Veja [erros e novas tentativas](https://broadrouter.com/pt/guides/errors-and-retries/).

## Termos neste guia

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

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

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

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

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

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

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

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

## Perguntas frequentes

### Por que o Jan só mostra modelos de transcrição depois que adiciono a BroadNet?

O Jan busca https://inference.broadnet.ai/v1/models quando você salva. Quando conferimos, em 15 de novembro de 2026, o /v1/models público da BroadNet listava só os dois modelos de transcrição, que não funcionam no chat. Remova-os e adicione os IDs dos modelos de chat à mão.

### O botão Test keys do Jan diz OK. A minha chave é válida?

Não necessariamente. O Jan testa as chaves chamando /models, e o /v1/models da BroadNet respondia sem chave quando conferimos. Envie uma mensagem no chat para confirmar a chave.

### Posso usar a chave por hora da BroadNet no Jan?

Sim. A chave por hora roda o BroadNet Gemma 4 VL 26B, ID broadnet/gemma-4-26b-a4b, com um stream por vez, o que serve bem para uma única janela de chat.

### O Jan detecta se um modelo da BroadNet aceita imagens ou ferramentas?

Não. A documentação do Jan diz que as capabilities de provedores personalizados não são detectadas. Ative a entrada de imagens para DeepSeek V4.1 Flash, Qwen3.8 27B e Gemma 4 VL 26B, e Tools para GLM 5.3 e Qwen3.8 27B.

## Guias relacionados

-   [Como conectar o Open WebUI à BroadNet Inference](https://broadrouter.com/pt/guides/open-webui-openai-api/)
-   [Adicionar a BroadNet Inference ao LibreChat como custom endpoint](https://broadrouter.com/pt/guides/librechat-custom-endpoint/)
-   [Conectar o SillyTavern à BroadNet Inference (Custom OpenAI-compatible)](https://broadrouter.com/pt/guides/sillytavern-custom-openai-endpoint/)
-   [Por que um modelo de raciocínio devolve uma resposta vazia](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/)
-   [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-jan-custom-endpoint&utm_content=page-cta) ·

**Fontes**

-   [Documentação do Jan, Custom Endpoints (conferido em 2026-11-15)](https://docs.jan.ai/desktop/remote-models/custom-endpoint)
-   [Releases do Jan no GitHub, a mais recente é v0.8.8 (conferido em 2026-11-15)](https://github.com/janhq/jan/releases)
-   [Política de Uso Aceitável da BroadNet (conferido em 2026-11-15) (em inglês)](https://www.broadnet.ai/aup)
-   [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-jan-custom-endpoint&utm_content=sources)
