---
title: "goose: provedor personalizado compatível com a OpenAI"
description: "Conecte o agente de IA goose à BroadNet Inference como custom provider OpenAI Compatible, pelo goose Desktop, pelo goose configure ou por um arquivo JSON."
url: https://broadrouter.com/pt/guides/goose-custom-provider/
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/goose-custom-provider/) (atualizado em 2026-11-16).

# Adicionar a BroadNet Inference ao goose como provedor personalizado

Atualizado em 2026-11-16

No goose, adicione um custom provider do tipo OpenAI Compatible, com API URL https://inference.broadnet.ai/v1/chat/completions, a sua chave da BroadNet e modelos disponíveis como broadnet/glm-5.3. Use o botão Add Custom Provider do goose Desktop, o goose configure no terminal ou um arquivo JSON em ~/.config/goose/custom\_providers/. O goose depende de tool calling, então comece com GLM 5.3 ou Qwen3.8 27B.

O goose é um agente de IA open source com app desktop e CLI. Serviços que não vêm integrados são adicionados como **custom providers**, e o goose aceita os compatíveis com a OpenAI. A BroadNet Inference oferece chat completions padrão, então funciona desse jeito. O BroadRouter é o site da própria BroadNet; os passos seguem [a documentação de provedores do goose](https://goose-docs.ai/docs/getting-started/providers/) na versão 1.59.

A documentação do goose avisa que ele “extensively uses tool calling” (tradução: usa tool calling intensamente) e que modelos sem esse recurso só conseguem conversar, com todas as extensões desativadas. A BroadNet lista tool calling para GLM 5.3 e Qwen3.8 27B, então use um desses dois para trabalho de agente.

## Opção 1: goose Desktop

1.  Abra a barra lateral e clique em **Settings**, depois na aba **Models**.
    
2.  Clique em **Configure providers** e depois em **Add Custom Provider**, no fim da página.
    
3.  Preencha os dados:
    
    | Campo | Valor |
    | --- | --- |
    | Provider Type | **OpenAI Compatible** |
    | Display Name | BroadNet Inference |
    | API URL | `https://inference.broadnet.ai/v1/chat/completions` |
    | API Key | a sua chave da BroadNet |
    | Available Models | `broadnet/glm-5.3, broadnet/qwen3.8-27b` |
    | Streaming Support | ligado |
    
4.  Clique em **Create Provider** e selecione o provedor e um modelo.
    

## Opção 2: goose CLI

Rode `goose configure`, escolha **Custom Providers** e depois **Add A Custom Provider**, e responda às perguntas com os mesmos valores: tipo de API OpenAI Compatible, a API URL acima, autenticação **Yes** com uma chave de API fixa, a lista de modelos separados por vírgula e streaming ligado.

## Opção 3: um arquivo JSON

Crie `~/.config/goose/custom_providers/broadnet.json` (no Windows, `%APPDATA%\Block\goose\config\custom_providers\`):

```json
{
  "name": "broadnet",
  "engine": "openai",
  "display_name": "BroadNet Inference",
  "description": "BroadNet Inference, OpenAI-compatible",
  "api_key_env": "BROADNET_API_KEY",
  "base_url": "https://inference.broadnet.ai/v1/chat/completions",
  "models": [
    { "name": "broadnet/glm-5.3", "context_limit": 1048576 },
    { "name": "broadnet/qwen3.8-27b", "context_limit": 262144 },
    { "name": "broadnet/deepseek-v4.1-flash", "context_limit": 1048576 }
  ],
  "supports_streaming": true,
  "requires_auth": true
}
```

Depois inicie uma sessão com ele:

```bash
export BROADNET_API_KEY='your-broadnet-key'
goose session start --provider broadnet
```

O arquivo pode ir para um repositório do seu time, porque a chave fica no ambiente.

## Teste

Comece com uma pergunta simples, como “what can you do?”. Se vier resposta, a conexão funciona. Depois peça algo que precise de uma das extensões ativas. Se o goose chamar a ferramenta, o tool calling também funciona. Se ele só responder com texto e nunca chamar uma ferramenta, troque para `broadnet/glm-5.3`.

## Preços no goose

O goose consegue estimar o custo se cada modelo no arquivo JSON tiver `input_token_cost` e `output_token_cost` em USD por token. Pegue os valores na [página de preços](https://broadrouter.com/pt/pricing/) da BroadNet e divida o preço por milhão por 1.000.000. Sem os dois campos, o goose usa os preços do próprio catálogo, que podem não bater com os da BroadNet.

## Solução de problemas

-   **401.** A chave está errada, expirou ou ficou sem cota, ou `BROADNET_API_KEY` não está definida no shell que inicia o goose.
-   **404.** Confira a API URL: ela deve ser `https://inference.broadnet.ai/v1/chat/completions`. Confira se o ID do modelo é exatamente o da BroadNet. Os modelos pagos exigem uma recarga; o crédito de $5 cobre só `broadnet/gemma-4-26b-a4b` e os dois modelos Transcribe, e o contexto de 32.768 tokens do Gemma é pequeno para trabalho de agente.
-   **Respostas vazias.** No DeepSeek V4.1 Flash, no GLM 5.3 e no Qwen3.8 27B, o raciocínio conta para 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. Veja [erros e novas tentativas](https://broadrouter.com/pt/guides/errors-and-retries/).
-   **Requisições esperam ou falham com duas sessões do goose na mesma chave de plano.** Uma [sessão do plano](https://broadrouter.com/pt/guides/unlimited-llm-api-sessions/) roda uma requisição por vez, então dê a cada sessão do goose a sua própria.

## Termos neste guia

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

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

[Streaming](https://broadrouter.com/pt/glossary/streaming/)

Streaming é uma forma de devolver a resposta de um modelo de linguagem em pequenos pedaços enquanto ela ainda está sendo gerada, em vez de uma resposta única no final. APIs compatíveis com a OpenAI fazem streaming via server-sent events quando a requisição define stream como true.

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

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

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

[Agente de IA (AI agent)](https://broadrouter.com/pt/glossary/agent/)

Um agente de IA é um sistema em que um modelo de linguagem conduz os próprios passos rumo a um objetivo: decide quais ferramentas chamar, lê os resultados e repete até produzir uma resposta final ou atingir um limite. Um script fixo que chama um modelo em pontos definidos costuma ser chamado de workflow.

## Perguntas frequentes

### A API URL do goose deve terminar em /v1 ou em /v1/chat/completions?

O exemplo de custom provider da própria documentação do goose usa a URL completa de chat completions, então use https://inference.broadnet.ai/v1/chat/completions. Isso também mantém o goose em chat completions, que é o que a BroadNet oferece.

### Qual modelo da BroadNet funciona melhor com o goose?

GLM 5.3 (broadnet/glm-5.3). A documentação do goose diz que ele usa tool calling intensamente, e a BroadNet lista ferramentas só para GLM 5.3 e Qwen3.8 27B.

### Posso usar o goose no plano ilimitado da BroadNet?

Os planos cobrem só o DeepSeek V4.1 Flash, e a documentação da BroadNet não lista tool calling para ele. O goose diz que modelos sem tool calling só conseguem conversar com as extensões desativadas, então teste antes de comprar um mês.

### Onde o goose guarda a chave de API?

No chaveiro do sistema, ou em secrets.yaml se o keyring estiver desligado. Com um arquivo JSON, o goose lê a variável indicada em api\_key\_env.

## Guias relacionados

-   [Usar o Kilo Code com a BroadNet Inference (provedor OpenAI Compatible)](https://broadrouter.com/pt/guides/kilo-code-openai-compatible/)
-   [Adicionar a BroadNet Inference ao opencode como provedor personalizado](https://broadrouter.com/pt/guides/opencode-custom-provider/)
-   [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-goose-custom-provider&utm_content=page-cta) ·

**Fontes**

-   [Documentação do goose, Model providers e Configure Custom Provider (conferido em 2026-11-15)](https://goose-docs.ai/docs/getting-started/providers/)
-   [goose no GitHub (aaif-goose/goose), versão mais recente v1.59.1 (conferido em 2026-11-15)](https://github.com/aaif-goose/goose)
-   [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-goose-custom-provider&utm_content=sources)
