---
title: "smolagents OpenAIModel na may custom api_base | BroadRouter"
description: "Ikonekta ang smolagents ng Hugging Face sa BroadNet Inference sa OpenAIModel at api_base: CodeAgent sa kahit anong model, ToolCallingAgent sa GLM 5.3 at Qwen3.8 27B."
url: https://broadrouter.com/fil/guides/smolagents-openai-compatible/
lang: fil
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Isinalin mula sa Ingles sa tulong ng AI. [Basahin ang orihinal sa Ingles](https://broadrouter.com/guides/smolagents-openai-compatible/) (na-update noong 2026-11-16).

# smolagents sa BroadNet Inference gamit ang OpenAIModel

Na-update 2026-11-16

Gumawa ng OpenAIModel ng smolagents na may model\_id na BroadNet ID gaya ng broadnet/glm-5.3, api\_base na https://inference.broadnet.ai/v1 at api\_key na BroadNet key mo, saka ipasa ito sa CodeAgent o ToolCallingAgent. Python ang isinusulat ng CodeAgent sa halip na native tool calls, kaya puwede itong tumakbo sa DeepSeek V4.1 Flash. Kailangan ng ToolCallingAgent ang GLM 5.3 o Qwen3.8 27B.

Ang smolagents ay maliit na Python library ng Hugging Face para sa mga agent. Ang `OpenAIModel` class nito ay “connects to an OpenAI-compatible API server” (Salin: kumokonekta sa isang OpenAI-compatible na API server), na may `api_base` para sa URL. Chat completions ang sine-serve ng BroadNet Inference sa `https://inference.broadnet.ai/v1`, kaya direkta itong gumagana. Ang BroadRouter ay sariling site ng BroadNet; sinusundan ng gabay na ito ang docs ng smolagents 1.26.0.

## I-install

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

Hinihiling ng `CodeAgent` sa model na sumulat ng Python sa pagitan ng mga `<code>` tag at pinapatakbo ito nang lokal. Plain chat completion ang request, may stop sequence gaya ng `</code>`, at walang `tools` field. Ibig sabihin, hindi ito umaasa sa native tool calling, kaya puwede itong tumakbo sa `broadnet/deepseek-v4.1-flash`, ang model sa mga [unlimited na plan](https://broadrouter.com/fil/guides/unlimited-llm-api-sessions/) ng BroadNet. Nag-iiba pa rin ang kalidad ng code depende sa model, kaya i-test ang sarili mong mga task.

Pinapatakbo ng CodeAgent ang code na isinusulat ng model. Basahin ang gabay ng smolagents tungkol sa ligtas na pagpapatakbo ng code bago mo ito bigyan ng tools na humahawak ng mga file, network o credentials.

## 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?"))
```

Ipinapadala ng `ToolCallingAgent` ang tools mo, kasama ang sarili nitong `final_answer` tool, bilang function schema na may `tool_choice: "required"`. Gamitin ang `broadnet/glm-5.3` o `broadnet/qwen3.8-27b`; ang dalawang model na ito lang ang may nakalistang tools sa docs ng BroadNet.

## Aling model ang pipiliin

| Agent | Model |
| --- | --- |
| `CodeAgent`, mahahabang run sa flat-price na plan | `broadnet/deepseek-v4.1-flash` |
| `ToolCallingAgent` | `broadnet/glm-5.3` |
| Alinmang agent na may image input | `broadnet/qwen3.8-27b` |

Isang request lang sa isang pagkakataon ang pinapatakbo ng isang plan session, at sunod-sunod na ipinapadala ng agent ang mga hakbang nito, kaya isang agent ang kasya sa isang session. [Presyo ng bawat model](https://broadrouter.com/fil/pricing/).

## Paano namin ito sinubok

Noong 2026-11-15, nag-install kami ng smolagents 1.26.0 sa isang malinis na virtual environment at pinatakbo ang dalawang agent laban sa isang lokal na mock server na sumusunod sa chat-completions na format ng BroadNet. Nakatanggap ng code reply ang `CodeAgent` sa DeepSeek ID, pinatakbo ito at ibinalik ang 42. May `max_tokens: 4000`, stop sequences at walang tools ang mga request nito. Para sa `ToolCallingAgent`, sinuri namin ang hugis ng request: ipinadala ang model ID nang walang pagbabago, kasama ang dalawang tool schema at `tool_choice: "required"`. Ibinabalik ng smolagents ang mga resulta ng tool bilang user message. Hindi sinunod ng mock namin ang format na iyon, kaya hindi namin pinatakbo ang agent na iyon hanggang sa final answer. Wala kaming BroadNet key, kaya hindi namin sinubok ang totoong output ng model.

## Troubleshooting

-   **401.** Mali, expired o naubusan ng allowance ang key.
-   **404.** Kailangang nagtatapos sa `/v1` ang `api_base`. Suriin ang model ID. Kailangan ng top-up ang mga bayad na model; ang `broadnet/gemma-4-26b-a4b` at ang dalawang Transcribe model lang ang sakop ng $5 na credit.
-   **“Make sure to provide correct code blobs”.** Walang code block ang reply ng model. Taasan ang `max_tokens`, dahil kasama rito ang reasoning, o sumubok ng ibang model. [Bakit walang laman ang mga sagot](https://broadrouter.com/fil/guides/reasoning-tokens-empty-response/).
-   **Hindi natatapos ang ToolCallingAgent.** Lumipat sa `broadnet/glm-5.3` o `broadnet/qwen3.8-27b`.
-   **429.** Ang isang pay-as-you-go key ay may 30 request kada minuto. Puwedeng limitahan ng smolagents ang sarili nito gamit ang `requests_per_minute`. Tingnan ang [errors and retries](https://broadrouter.com/fil/guides/errors-and-retries/).

## Mga termino sa gabay na ito

[AI agent](https://broadrouter.com/fil/glossary/agent/)

Ang AI agent ay isang system kung saan ang language model mismo ang nagdidirekta ng mga hakbang nito tungo sa isang layunin: pinipili nito kung aling tools ang tatawagin, binabasa ang mga resulta at umuulit hanggang makabuo ng huling sagot o maabot ang limit. Workflow naman ang karaniwang tawag sa fixed na script na tumatawag sa model sa takdang punto.

[Tool calling (function calling)](https://broadrouter.com/fil/glossary/tool-calling/)

Ang tool calling, tinatawag ding function calling, ay feature ng LLM API kung saan nagbabalik ang model ng structured na request para magpatakbo ng function na tinukoy ng developer, kasama ang JSON arguments. Ang application ang nagpapatakbo ng function at nagpapadala pabalik ng resulta; hindi kailanman nagpapatakbo ng code ang model mismo.

[API key](https://broadrouter.com/fil/glossary/api-key/)

Ang API key ay isang lihim na string na kumikilala at nagpapahintulot sa client na tumatawag sa isang API. Kadalasang hinihingi ito ng mga LLM API sa Authorization: Bearer header, at ang sinumang may hawak ng key ay makakagawa ng mga request na sisingilin sa account na may-ari nito.

[Stop sequences](https://broadrouter.com/fil/glossary/stop-sequences/)

Ang stop sequences ay mga string na ipinapadala mo kasama ng request para tumigil ang model sa pagbuo ng sagot sa sandaling maisulat nito ang isa sa mga iyon. Sa OpenAI, stop ang field at hanggang 4 na sequence ang tinatanggap; sa Anthropic, stop\_sequences. Karaniwang hindi kasama sa ibinabalik na output ang tumugmang text.

[Pay-as-you-go](https://broadrouter.com/fil/glossary/pay-as-you-go/)

Ang pay-as-you-go ay paraan ng pagpepresyo kung saan ang nagamit mo lang ang binabayaran mo, sinusukat kada yunit gaya ng token, request o minuto ng audio, nang walang subscription o minimum na commitment. Ganito naniningil ang karamihan ng LLM API, mula sa prepaid na balance o sa pana-panahong invoice.

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

Ang Chat Completions API ay HTTP endpoint ng OpenAI, POST /v1/chat/completions, na tumatanggap ng pangalan ng model at listahan ng mga message na may role, at ibinabalik ang susunod na message ng model. Ang hugis ng request at response nito ang naging karaniwang format na ginagamit din ng mga OpenAI-compatible na provider at SDK.

[Flat-rate LLM plan (unlimited na plan)](https://broadrouter.com/fil/glossary/flat-rate-llm-plan/)

Ang flat-rate LLM plan ay naniningil ng fixed na presyo para sa isang period, gaya ng isang buwan, para sa access sa language model API sa halip na maningil kada token. Kadalasang may ibang nililimitahan ang ganitong plan, gaya ng concurrency, bilis, mga model o usage window, kaya kasinghalaga ng presyo ang mga limit.

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

Ang OpenAI-compatible API ay isang HTTP API na tumatanggap ng parehong request at response format gaya ng OpenAI API, halimbawa POST /v1/chat/completions, kaya magagamit ito ng mga OpenAI SDK at tool sa pagpalit lang ng base URL, API key at pangalan ng model.

## Mga tanong

### OpenAIModel ba o OpenAIServerModel?

Ang OpenAIModel ang dinodokumento ng smolagents 1.26 para sa kahit anong OpenAI-compatible na server. Ine-export pa rin ng package ang OpenAIServerModel, pero OpenAIModel ang inilalarawan sa docs.

### Puwede bang patakbuhin ang smolagents sa unlimited na plan ng BroadNet?

Sakop ng mga plan ang DeepSeek V4.1 Flash. Walang nakalistang tool calling para dito sa BroadNet, pero hindi kailangan ng CodeAgent ang native tool calls; Python code ang hinihingi nito sa model. Sa mock test namin, plain chat request na walang tools field ang ipinadala ng CodeAgent sa DeepSeek ID.

### Bakit kailangan ng ToolCallingAgent ang GLM 5.3 o Qwen3.8 27B?

Ipinapadala nito ang tools bilang OpenAI function schema na may tool\_choice na required. Sa docs ng BroadNet, GLM 5.3 at Qwen3.8 27B lang ang may nakalistang tools.

### Paano ko ipapasa ang max\_tokens o temperature?

Bilang keyword argument sa OpenAIModel. Sabi ng docs ng smolagents, ipinapasa ang mga dagdag na argument sa bawat completion call. Sa test namin, ipinadala ang max\_tokens=4000 sa bawat request.

## Mga kaugnay na gabay

-   [Paano gamitin ang OpenAI Python SDK sa BroadNet Inference](https://broadrouter.com/fil/guides/openai-python-sdk/)
-   [Paano gumagana ang unlimited LLM API plans para sa mga agent](https://broadrouter.com/fil/guides/unlimited-llm-api-sessions/)
-   [Bakit walang laman ang sagot ng isang reasoning model](https://broadrouter.com/fil/guides/reasoning-tokens-empty-response/)
-   [Mga error code ng BroadNet Inference at kailan dapat mag-retry](https://broadrouter.com/fil/guides/errors-and-retries/)
-   [Lahat ng tool na gumagana sa BroadNet Inference (Ingles)](https://broadrouter.com/integrations/): mga SDK, coding agent, chat UI at automation tool, kasama ang eksaktong setting ng bawat isa

Subukan ito sa totoong workload mo. May US$5 na panimulang credit ang mga bagong account para sa Gemma at transcription. Kailangan ng top-up para sa DeepSeek, GLM, at Qwen3.8.

[Magsimula](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=fil-guides-smolagents-openai-compatible&utm_content=page-cta) ·

**Mga source**

-   [smolagents docs v1.26.0, Models reference (OpenAIModel) (sinuri noong 2026-11-15)](https://huggingface.co/docs/smolagents/reference/models)
-   [PyPI, smolagents 1.26.0 (sinuri noong 2026-11-15)](https://pypi.org/project/smolagents/)
-   [API reference ng BroadNet Inference (sinuri noong 2026-11-15) (Ingles)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fil-guides-smolagents-openai-compatible&utm_content=sources)
