---
title: "smolagents: OpenAIModel con un api_base personalizado"
description: "Conecte smolagents de Hugging Face a BroadNet Inference con OpenAIModel y api_base, para CodeAgent con cualquier modelo o ToolCallingAgent con GLM 5.3 y Qwen3.8 27B."
url: https://broadrouter.com/es/guides/smolagents-openai-compatible/
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/smolagents-openai-compatible/) (actualizado el 2026-11-16).

# smolagents en BroadNet Inference con OpenAIModel

Actualizado 2026-11-16

Cree el OpenAIModel de smolagents con model\_id en un ID de BroadNet como broadnet/glm-5.3, api\_base en https://inference.broadnet.ai/v1 y api\_key en su clave de BroadNet, y páselo a CodeAgent o ToolCallingAgent. CodeAgent escribe Python en lugar de usar llamadas a herramientas nativas, así que puede funcionar con DeepSeek V4.1 Flash. ToolCallingAgent necesita GLM 5.3 o Qwen3.8 27B.

smolagents es la pequeña biblioteca de Python de Hugging Face para agentes. Su clase `OpenAIModel` “connects to an OpenAI-compatible API server” (traducción: se conecta a un servidor de API compatible con OpenAI), con `api_base` para la URL. BroadNet Inference sirve chat completions en `https://inference.broadnet.ai/v1`, así que funciona directamente. BroadRouter es el sitio de la propia BroadNet; esta guía sigue la documentación de smolagents 1.26.0.

## Instalación

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

## CodeAgent

```python
import os
from smolagents import OpenAIModel, CodeAgent

model = OpenAIModel(
    model_id="broadnet/deepseek-v4.1-flash",
    api_base="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
    max_tokens=4000,
)

agent = CodeAgent(tools=[], model=model)
print(agent.run("What is 6 * 7? Use Python to check."))
```

`CodeAgent` le pide al modelo que escriba Python entre etiquetas `<code>` y lo ejecuta localmente. La solicitud es un chat completion simple con secuencias de parada (stop sequences) como `</code>` y sin campo `tools`. Es decir, no depende de las llamadas a herramientas nativas, así que puede funcionar con `broadnet/deepseek-v4.1-flash`, el modelo de los [planes ilimitados](https://broadrouter.com/es/guides/unlimited-llm-api-sessions/) de BroadNet. La calidad del código sigue variando según el modelo, así que pruebe sus propias tareas.

CodeAgent ejecuta código que escribe el modelo. Lea las recomendaciones de smolagents sobre ejecución segura de código antes de darle herramientas que toquen archivos, redes o credenciales.

## ToolCallingAgent

```python
from smolagents import ToolCallingAgent, tool

@tool
def get_weather(city: str) -> str:
    """Get the weather for a city.

    Args:
        city: The city name.
    """
    return f"21C in {city}"

model = OpenAIModel(
    model_id="broadnet/glm-5.3",
    api_base="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
    max_tokens=4000,
)
agent = ToolCallingAgent(tools=[get_weather], model=model)
print(agent.run("What's the weather in Riyadh?"))
```

`ToolCallingAgent` envía sus herramientas, más su propia herramienta `final_answer`, como esquemas de funciones con `tool_choice: "required"`. Use `broadnet/glm-5.3` o `broadnet/qwen3.8-27b`; la documentación de BroadNet indica herramientas solo para estos dos modelos.

## Qué modelo elegir

| Agente | Modelo |
| --- | --- |
| `CodeAgent`, ejecuciones largas con un plan de tarifa plana | `broadnet/deepseek-v4.1-flash` |
| `ToolCallingAgent` | `broadnet/glm-5.3` |
| Cualquiera de los dos con entrada de imágenes | `broadnet/qwen3.8-27b` |

Una sesión de plan ejecuta una solicitud a la vez, y un agente envía sus pasos uno tras otro, así que una sesión sirve para un agente. [Precios de todos los modelos](https://broadrouter.com/es/pricing/).

## Cómo lo probamos

El 2026-11-15 instalamos smolagents 1.26.0 en un entorno virtual limpio y ejecutamos ambos agentes contra un servidor simulado local que habla el formato de chat completions de BroadNet. El `CodeAgent` con el ID de DeepSeek recibió una respuesta con código, la ejecutó y devolvió 42. Sus solicitudes llevaban `max_tokens: 4000`, secuencias de parada y ninguna herramienta. En el `ToolCallingAgent` revisamos la forma de la solicitud: el ID de modelo se envió sin cambios, con los dos esquemas de herramientas y `tool_choice: "required"`. smolagents devuelve los resultados de las herramientas como mensajes user. Nuestro servidor simulado no seguía ese formato, así que no llevamos ese agente hasta una respuesta final. No teníamos una clave de BroadNet, así que no probamos la salida de un modelo real.

## Solución de problemas

-   **401.** La clave es incorrecta, expiró o se quedó sin saldo.
-   **404.** `api_base` debe terminar en `/v1`. Revise el ID del modelo. Los modelos de pago requieren una recarga; el crédito de $5 cubre solo `broadnet/gemma-4-26b-a4b` y los dos modelos Transcribe.
-   **“Make sure to provide correct code blobs”.** (Traducción: asegúrese de proporcionar bloques de código correctos.) La respuesta del modelo no tenía bloque de código. Suba `max_tokens`, porque el razonamiento cuenta para él, o pruebe otro modelo. [Por qué las respuestas llegan vacías](https://broadrouter.com/es/guides/reasoning-tokens-empty-response/).
-   **ToolCallingAgent nunca termina.** Cambie a `broadnet/glm-5.3` o `broadnet/qwen3.8-27b`.
-   **429.** Una clave de pago por uso permite 30 solicitudes por minuto. smolagents puede limitarse a sí mismo con `requests_per_minute`. 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.

[Secuencias de parada (stop sequences)](https://broadrouter.com/es/glossary/stop-sequences/)

Las secuencias de parada (stop sequences) son cadenas que usted envía con la solicitud para que el modelo deje de generar en cuanto produzca una de ellas. OpenAI llama al campo stop y acepta hasta 4 secuencias; Anthropic lo llama stop\_sequences. Normalmente el texto coincidente no se incluye en la salida devuelta.

[API compatible con OpenAI](https://broadrouter.com/es/glossary/openai-compatible-api/)

Una API compatible con OpenAI es una API HTTP que acepta los mismos formatos de solicitud y respuesta que la API de OpenAI, como POST /v1/chat/completions, de modo que los SDKs y herramientas de OpenAI pueden usarla cambiando solo la URL base, la clave de API y el nombre del modelo.

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

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

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

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

[Plan de LLM con tarifa plana (flat-rate LLM plan)](https://broadrouter.com/es/glossary/flat-rate-llm-plan/)

Un plan de LLM con tarifa plana cobra un precio fijo por un periodo, como un mes, por acceder a la API de un modelo de lenguaje, en lugar de facturar por token. Estos planes suelen limitar otra cosa, como la concurrencia, la velocidad, los modelos o las ventanas de uso, así que los topes importan tanto como el precio.

## Preguntas frecuentes

### ¿Es OpenAIModel u OpenAIServerModel?

smolagents 1.26 documenta OpenAIModel para cualquier servidor compatible con OpenAI. El paquete todavía exporta OpenAIServerModel, pero la documentación describe OpenAIModel.

### ¿Puede smolagents funcionar con el plan ilimitado de BroadNet?

Los planes cubren DeepSeek V4.1 Flash. BroadNet no indica llamadas a herramientas para él, pero CodeAgent no necesita llamadas a herramientas nativas: le pide código Python al modelo. En nuestra prueba con un servidor simulado, un CodeAgent con el ID de DeepSeek envió solicitudes de chat simples sin campo tools.

### ¿Por qué ToolCallingAgent necesita GLM 5.3 o Qwen3.8 27B?

Envía las herramientas como esquemas de funciones de OpenAI con tool\_choice en required. La documentación de BroadNet indica herramientas solo para GLM 5.3 y Qwen3.8 27B.

### ¿Cómo paso max\_tokens o temperature?

Como argumentos con nombre a OpenAIModel. La documentación de smolagents dice que los argumentos adicionales se reenvían a cada llamada de completion. En nuestra prueba se envió max\_tokens=4000 en cada solicitud.

## Guías relacionadas

-   [Usar el SDK de OpenAI para Python con BroadNet Inference](https://broadrouter.com/es/guides/openai-python-sdk/)
-   [Cómo funcionan los planes de API de LLM ilimitada para agentes](https://broadrouter.com/es/guides/unlimited-llm-api-sessions/)
-   [¿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-smolagents-openai-compatible&utm_content=page-cta) ·

**Fuentes**

-   [Documentación de smolagents v1.26.0, referencia de modelos (OpenAIModel) (consultada el 2026-11-15)](https://huggingface.co/docs/smolagents/reference/models)
-   [PyPI, smolagents 1.26.0 (consultado el 2026-11-15)](https://pypi.org/project/smolagents/)
-   [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-smolagents-openai-compatible&utm_content=sources)
