---
title: "CrewAI con base_url personalizado compatible con OpenAI"
description: "Conecte los agentes de CrewAI a BroadNet Inference con LLM(custom_openai=True, base_url=...) y elija modelos para herramientas, contexto largo y tarifa plana."
url: https://broadrouter.com/es/guides/crewai-custom-openai-endpoint/
lang: es
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traducido del inglés con ayuda de IA. [Lea el original en inglés](https://broadrouter.com/guides/crewai-custom-openai-endpoint/) (actualizado el 2026-11-16).

# CrewAI con BroadNet Inference como endpoint OpenAI personalizado

Actualizado 2026-11-16

Cree el modelo con la clase LLM de crewai, con model igual a un ID de BroadNet como broadnet/glm-5.3, custom\_openai=True, base\_url igual a https://inference.broadnet.ai/v1 y api\_key con su clave de BroadNet. Luego asigne ese LLM a cada Agent. CrewAI usa su cliente nativo de OpenAI y chat completions, así que no necesita instalar LiteLLM.

CrewAI es un framework de Python para equipos de agentes. Su documentación muestra un patrón de **endpoint personalizado compatible con OpenAI**: un `LLM` con `custom_openai=True` y un `base_url`. BroadNet Inference sirve chat completions estándar en `https://inference.broadnet.ai/v1`, así que encaja ahí. BroadRouter es el sitio de la propia BroadNet; esta guía sigue la documentación y el código fuente de CrewAI a la versión 1.15.41.

## Instalación

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

## Conexión

```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."))
```

Si `llm.call` imprime una respuesta, la clave, la URL y el ID del modelo son correctos.

## Cómo enruta CrewAI la solicitud

El código fuente de CrewAI fija un orden: `custom_openai=True` va primero y fuerza el proveedor nativo de OpenAI, por encima de lo que sugiera el nombre del modelo. Además lanza un error si no se define un endpoint personalizado mediante `base_url`, `api_base`, `OPENAI_BASE_URL` u `OPENAI_API_BASE`. El nombre del modelo se envía tal cual, así que `broadnet/glm-5.3` llega a BroadNet sin cambios.

Sin `custom_openai`, un nombre como `broadnet/glm-5.3` se interpretaría como el proveedor `broadnet`, que CrewAI no conoce, y recurriría a LiteLLM. La alternativa documentada es `model="openai/broadnet/glm-5.3"` con un `base_url`: CrewAI elimina el prefijo `openai/` y envía el resto.

Dos detalles más del código y la documentación de CrewAI:

-   **Campo del límite de tokens.** Cuando pasa `max_tokens`, el cliente nativo envía `max_tokens` en chat completions, el campo que describe la referencia de la API de BroadNet. Si pasa `max_completion_tokens`, se envía ese en su lugar.
-   **Quédese en chat completions.** La documentación de CrewAI muestra `api="responses"` para cambiar a la Responses API. No lo defina; BroadNet no ofrece esa API.

## Qué modelo para cada agente

| Agente | Modelo | Por qué |
| --- | --- | --- |
| Agentes con herramientas | `broadnet/glm-5.3` | BroadNet indica herramientas y salida estructurada; contexto de 1M |
| Entrada de imágenes o en árabe, con herramientas | `broadnet/qwen3.8-27b` | Herramientas e imágenes; contexto de 262K |
| Tareas de lectura largas, plan de tarifa plana | `broadnet/deepseek-v4.1-flash` | Planes ilimitados; BroadNet no indica herramientas |

Una crew puede combinarlos: dé a cada `Agent` su propio `LLM`.

## Solución de problemas

-   **401.** La clave es incorrecta, caducó o se quedó sin saldo. Si omitió `api_key`, CrewAI leyó `OPENAI_API_KEY`, que puede contener una clave de OpenAI.
-   **“custom\_openai=True requires base\_url”.** Pase `base_url` o defina `OPENAI_BASE_URL`.
-   **Modelo no encontrado.** Compruebe que el ID coincida exactamente con el de BroadNet. Los modelos de pago requieren una recarga; el crédito de $5 cubre solo `broadnet/gemma-4-26b-a4b` y los dos modelos Transcribe.
-   **`EmptyLLMResponseError`.** CrewAI reintenta una vez ante una respuesta vacía y después lanza este error. Aumente `max_tokens`. [Por qué las respuestas llegan vacías](https://broadrouter.com/es/guides/reasoning-tokens-empty-response/).
-   **429 con varios agentes.** Una clave de pago por uso permite 30 solicitudes por minuto y 4 en curso, y una sesión de plan atiende una solicitud a la vez. Consulte [errores y reintentos](https://broadrouter.com/es/guides/errors-and-retries/).

## Términos de esta guía

[Llamadas a herramientas (tool calling)](https://broadrouter.com/es/glossary/tool-calling/)

Las llamadas a herramientas (tool calling), también llamadas function calling, son una función de las APIs de LLM en la que el modelo devuelve una solicitud estructurada para ejecutar una función definida por el desarrollador, con argumentos JSON. La aplicación ejecuta la función y devuelve el resultado; el modelo nunca ejecuta código.

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

La API de Chat Completions es el endpoint HTTP de OpenAI, POST /v1/chat/completions, que recibe un nombre de modelo y una lista de mensajes etiquetados con su rol y devuelve el siguiente mensaje del modelo. Su forma de solicitud y respuesta se convirtió en el formato común que reutilizan los proveedores y SDKs compatibles con OpenAI.

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

El pago por uso es un modelo de precios en el que usted paga solo lo que usa, medido por unidades como tokens, solicitudes o minutos de audio, sin suscripción ni compromiso mínimo. La mayoría de las APIs de LLM cobran así, desde un saldo prepagado o con una factura periódica.

[Concurrencia (concurrency)](https://broadrouter.com/es/glossary/concurrency/)

La concurrencia es el número de solicitudes que un cliente tiene en curso al mismo tiempo. Las APIs de LLM suelen limitarla por clave o por plan, aparte de las solicitudes por minuto, porque cada solicitud abierta ocupa capacidad de GPU hasta que su respuesta termina.

[Límite de frecuencia (rate limit)](https://broadrouter.com/es/glossary/rate-limit/)

Un límite de frecuencia (rate limit) es un tope que una API impone a cuánto puede usarla un cliente en un periodo, como solicitudes por minuto o tokens por minuto. Las solicitudes que lo superan se rechazan, normalmente con HTTP 429 Too Many Requests, hasta que el uso vuelve a quedar por debajo.

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

Un token es la unidad de texto que un modelo de lenguaje lee y escribe: una palabra, parte de una palabra, un signo de puntuación o una secuencia de bytes producida por el tokenizador del modelo. Las APIs de LLM cuentan, limitan y normalmente facturan el uso en tokens.

[Crédito prepago (prepaid credit)](https://broadrouter.com/es/glossary/prepaid-credit/)

El crédito prepago es dinero que se añade a una cuenta de API antes de usarla. Cada solicitud descuenta su coste del saldo y, cuando el saldo se agota, las solicitudes medidas se detienen hasta que usted recargue. Limita el gasto a lo que ha pagado.

[max\_tokens (límite de tokens de salida)](https://broadrouter.com/es/glossary/max-tokens/)

max\_tokens es un parámetro de las APIs de LLM que fija el máximo de tokens que un modelo puede generar en una respuesta. Cuando la generación llega al límite, se detiene y la respuesta queda marcada como cortada, por ejemplo con finish\_reason en "length".

## Preguntas frecuentes

### ¿Qué hace custom\_openai=True en CrewAI?

El código fuente de CrewAI indica que fuerza el proveedor nativo de OpenAI sin importar cómo sea el nombre del modelo, y exige base\_url, api\_base, OPENAI\_BASE\_URL u OPENAI\_API\_BASE. El nombre del modelo se envía tal cual, así que broadnet/glm-5.3 llega a BroadNet sin cambios.

### ¿Puedo escribir model="openai/broadnet/glm-5.3" en su lugar?

Sí. Con un base\_url personalizado, CrewAI dirige el prefijo openai/ a su cliente nativo de OpenAI y lo elimina, así que BroadNet recibe broadnet/glm-5.3. custom\_openai=True es la forma más clara.

### ¿Por qué mi crew falla con EmptyLLMResponseError?

CrewAI reintenta una vez una respuesta vacía, sin contenido y sin llamadas a herramientas, y lanza este error si el reintento también llega vacío. Con los modelos de razonamiento de BroadNet, eso suele significar que el razonamiento agotó el presupuesto de salida. Aumente max\_tokens.

### ¿Qué modelo de BroadNet deberían usar los agentes de CrewAI?

GLM 5.3 para agentes con herramientas, ya que BroadNet indica que admite herramientas y salida estructurada. Qwen3.8 27B también admite herramientas y acepta imágenes.

## Guías relacionadas

-   [Pydantic AI con BroadNet Inference (OpenAICompatibleProvider)](https://broadrouter.com/es/guides/pydantic-ai-openai-compatible/)
-   [Usar el SDK de OpenAI para Python con BroadNet Inference](https://broadrouter.com/es/guides/openai-python-sdk/)
-   [¿Por qué un modelo de razonamiento devuelve una respuesta vacía?](https://broadrouter.com/es/guides/reasoning-tokens-empty-response/)
-   [Códigos de error de BroadNet Inference y cuándo reintentar](https://broadrouter.com/es/guides/errors-and-retries/)
-   [Todas las herramientas que funcionan con BroadNet Inference (en inglés)](https://broadrouter.com/integrations/): SDK, agentes de programación, interfaces de chat y herramientas de automatización, con la configuración exacta de cada una

Pruébelo con su carga de trabajo real. Las cuentas nuevas empiezan con USD 5 de crédito para Gemma y transcripción. DeepSeek, GLM y Qwen3.8 requieren una recarga.

[Comenzar](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-guides-crewai-custom-openai-endpoint&utm_content=page-cta) ·

**Fuentes**

-   [Documentación de CrewAI, LLMs (OpenAI, endpoint personalizado compatible con OpenAI) (consultada el 2026-11-15)](https://docs.crewai.com/en/concepts/llms)
-   [Código fuente de CrewAI, enrutamiento de LLM con custom\_openai (llm.py) (consultado el 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 (consultado el 2026-11-15)](https://pypi.org/project/crewai/)
-   [Referencia de la API de BroadNet Inference (consultada el 2026-11-15) (en inglés)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-guides-crewai-custom-openai-endpoint&utm_content=sources)
