---
title: "CrewAI: base_url personalizado compatível com a OpenAI"
description: "Aponte os agentes do CrewAI para a BroadNet Inference com LLM(custom_openai=True, base_url=...) e escolha modelos para ferramentas, contexto longo e preço fixo."
url: https://broadrouter.com/pt/guides/crewai-custom-openai-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/crewai-custom-openai-endpoint/) (atualizado em 2026-11-16).

# CrewAI com a BroadNet Inference como endpoint OpenAI personalizado

Atualizado em 2026-11-16

Crie o modelo com a classe LLM do crewai, passando model com um ID da BroadNet como broadnet/glm-5.3, custom\_openai=True, base\_url como https://inference.broadnet.ai/v1 e api\_key com a sua chave da BroadNet. Depois entregue esse LLM a cada Agent. O CrewAI usa o cliente OpenAI nativo e chat completions, então não é preciso instalar o LiteLLM.

O CrewAI é um framework Python para equipes de agentes. A documentação dele mostra um padrão de **endpoint personalizado compatível com a OpenAI**: um `LLM` com `custom_openai=True` e um `base_url`. A BroadNet Inference serve chat completions padrão em `https://inference.broadnet.ai/v1`, então se conecta exatamente aí. O BroadRouter é o site da própria BroadNet; este guia segue a documentação e o código-fonte do CrewAI na versão 1.15.41.

## Instalação

```bash
pip install crewai
export BROADNET_API_KEY='your-broadnet-key'
```

## Conexão

```python
import os
from crewai import LLM, Agent

llm = LLM(
    model="broadnet/glm-5.3",
    custom_openai=True,
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
    max_tokens=4000,  # reasoning counts toward this limit
)

# Quick test: one call straight to the model
print(llm.call("Say hello in five words."))

analyst = Agent(
    role="Analyst",
    goal="Summarize incidents",
    backstory="You write short incident summaries.",
    llm=llm,
)
print(analyst.kickoff("Summarize: the API returned 503 for four minutes after a deploy."))
```

Se `llm.call` imprimir uma resposta, a chave, a URL e o ID do modelo estão certos.

## Como o CrewAI roteia a requisição

O código-fonte do CrewAI define uma ordem: `custom_openai=True` vem primeiro e força o provedor OpenAI nativo, passando por cima do que o nome do modelo sugerir. Ele também lança um erro se nenhum endpoint personalizado for definido via `base_url`, `api_base`, `OPENAI_BASE_URL` ou `OPENAI_API_BASE`. A string do modelo é enviada como está, então `broadnet/glm-5.3` chega à BroadNet sem mudança.

Sem `custom_openai`, um nome como `broadnet/glm-5.3` seria lido como provedor `broadnet`, que o CrewAI não conhece, e cairia no LiteLLM. A alternativa documentada é `model="openai/broadnet/glm-5.3"` com um `base_url`: o CrewAI remove o prefixo `openai/` e envia o resto.

Mais duas coisas do código e da documentação do CrewAI:

-   **Campo de limite de tokens.** Quando você passa `max_tokens`, o cliente nativo envia `max_tokens` em chat completions, o campo descrito na referência da API da BroadNet. Se você passar `max_completion_tokens`, é ele que vai.
-   **Fique em chat completions.** A documentação do CrewAI mostra `api="responses"` para mudar para a Responses API. Não defina isso; a BroadNet não lista essa API.

## Qual modelo para qual agente

| Agente | Modelo | Por quê |
| --- | --- | --- |
| Agentes com ferramentas | `broadnet/glm-5.3` | A BroadNet lista ferramentas e saída estruturada; contexto de 1M |
| Entrada de imagem ou em árabe, com ferramentas | `broadnet/qwen3.8-27b` | Ferramentas e imagens; contexto de 262K |
| Leituras longas, plano de preço fixo | `broadnet/deepseek-v4.1-flash` | Planos ilimitados; ferramentas não listadas pela BroadNet |

Uma crew pode misturar os modelos: dê a cada `Agent` o seu próprio `LLM`.

## Solução de problemas

-   **401.** A chave está errada, expirada ou sem cota. Se você omitiu `api_key`, o CrewAI leu `OPENAI_API_KEY`, que pode conter uma chave da OpenAI.
-   **“custom\_openai=True requires base\_url”.** Passe `base_url` ou defina `OPENAI_BASE_URL`.
-   **Modelo não encontrado.** Confira se o ID bate exatamente com o da BroadNet. Modelos pagos exigem uma recarga; o crédito de $5 cobre só `broadnet/gemma-4-26b-a4b` e os dois modelos Transcribe.
-   **`EmptyLLMResponseError`.** O CrewAI tenta de novo uma vez após uma resposta vazia e depois lança esse erro. Aumente `max_tokens`. [Por que as respostas vêm vazias](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/).
-   **429 com vários agentes.** Uma chave de pagamento por uso permite 30 requisições por minuto e 4 em andamento, e uma sessão do plano roda uma requisição por vez. Veja [erros e novas tentativas](https://broadrouter.com/pt/guides/errors-and-retries/).

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

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

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

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

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

[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

### O que custom\_openai=True faz no CrewAI?

Segundo o código-fonte do CrewAI, ele força o provedor OpenAI nativo, seja qual for o nome do modelo, e exige base\_url, api\_base, OPENAI\_BASE\_URL ou OPENAI\_API\_BASE. A string do modelo é enviada como está, então broadnet/glm-5.3 chega à BroadNet sem mudança.

### Posso escrever model="openai/broadnet/glm-5.3" no lugar?

Sim. Com um base\_url personalizado, o CrewAI encaminha o prefixo openai/ para o cliente OpenAI nativo e remove o prefixo, então a BroadNet recebe broadnet/glm-5.3. custom\_openai=True é a forma mais clara.

### Por que minha crew falha com EmptyLLMResponseError?

O CrewAI repete uma vez a chamada quando a resposta vem vazia, sem conteúdo e sem chamada de ferramenta, e lança esse erro se a nova tentativa também vier vazia. Nos modelos de raciocínio da BroadNet, isso geralmente significa que o raciocínio gastou o orçamento de saída. Aumente max\_tokens.

### Qual modelo da BroadNet os agentes do CrewAI devem usar?

GLM 5.3 para agentes com ferramentas, já que a BroadNet lista ferramentas e saída estruturada para ele. O Qwen3.8 27B também tem ferramentas e aceita imagens.

## Guias relacionados

-   [Usar o Pydantic AI com a BroadNet Inference (OpenAICompatibleProvider)](https://broadrouter.com/pt/guides/pydantic-ai-openai-compatible/)
-   [Como usar o SDK Python da OpenAI com a BroadNet Inference](https://broadrouter.com/pt/guides/openai-python-sdk/)
-   [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-crewai-custom-openai-endpoint&utm_content=page-cta) ·

**Fontes**

-   [Documentação do CrewAI, LLMs (OpenAI, endpoint personalizado compatível com a OpenAI) (conferido em 2026-11-15)](https://docs.crewai.com/en/concepts/llms)
-   [Código-fonte do CrewAI, roteamento do LLM com custom\_openai (llm.py) (conferido em 2026-11-15)](https://github.com/crewAIInc/crewAI/blob/main/lib/crewai/src/crewai/llm.py)
-   [PyPI, crewai 1.15.41, Python 3.10 a 3.13 (conferido em 2026-11-15)](https://pypi.org/project/crewai/)
-   [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-crewai-custom-openai-endpoint&utm_content=sources)
