---
title: "smolagents の OpenAIModel でカスタム api_base を設定 | BroadRouter"
description: "OpenAIModel と api_base で Hugging Face の smolagents を BroadNet Inference に接続します。CodeAgent はどのモデルでも、ToolCallingAgent は GLM 5.3 と Qwen3.8 27B で動きます。"
url: https://broadrouter.com/ja/guides/smolagents-openai-compatible/
lang: ja
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

このページは英語の原文を AI の支援を受けて翻訳したものです。[英語の原文を読む](https://broadrouter.com/guides/smolagents-openai-compatible/)（2026-11-16 更新）。

# OpenAIModel で smolagents を BroadNet Inference で動かす

更新日 2026-11-16

smolagents の OpenAIModel を、model\_id に broadnet/glm-5.3 などの BroadNet の ID、api\_base に https://inference.broadnet.ai/v1、api\_key に BroadNet のキーを指定して作成し、CodeAgent か ToolCallingAgent に渡します。CodeAgent はネイティブのツール呼び出しではなく Python を書かせるので、DeepSeek V4.1 Flash でも動きます。ToolCallingAgent には GLM 5.3 か Qwen3.8 27B が必要です。

smolagents は、Hugging Face が提供するエージェント用の小さな Python ライブラリです。`OpenAIModel` クラスは “connects to an OpenAI-compatible API server”（訳：OpenAI 互換の API サーバーに接続する）もので、URL は `api_base` で指定します。BroadNet Inference は `https://inference.broadnet.ai/v1` で chat completions を提供しているので、そのまま使えます。BroadRouter は BroadNet 自身のサイトです。このガイドは smolagents 1.26.0 のドキュメントに基づいています。

## インストール

```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` はモデルに `<code>` タグで囲んだ Python を書かせ、それをローカルで実行します。リクエストは `</code>` などの停止シーケンスを付けた通常の chat completion で、`tools` フィールドはありません。つまりネイティブのツール呼び出しに依存しないので、BroadNet の[無制限プラン](https://broadrouter.com/ja/guides/unlimited-llm-api-sessions/)のモデルである `broadnet/deepseek-v4.1-flash` でも動きます。ただし、コードの品質はモデルによって異なるので、自分のタスクでテストしてください。

CodeAgent はモデルが書いたコードを実行します。ファイル、ネットワーク、認証情報に触れるツールを与える前に、smolagents の安全なコード実行に関するガイダンスを読んでください。

## 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` は、あなたのツールと独自の `final_answer` ツールを関数スキーマとして送り、`tool_choice: "required"` を指定します。`broadnet/glm-5.3` か `broadnet/qwen3.8-27b` を使ってください。BroadNet のドキュメントでツール対応が記載されているのはこの 2 つのモデルだけです。

## モデルの選び方

| エージェント | モデル |
| --- | --- |
| `CodeAgent`、定額プランでの長時間の実行 | `broadnet/deepseek-v4.1-flash` |
| `ToolCallingAgent` | `broadnet/glm-5.3` |
| どちらのエージェントでも、画像入力を使う場合 | `broadnet/qwen3.8-27b` |

プランのセッションは同時に 1 リクエストを処理し、エージェントはステップを 1 つずつ順番に送るので、1 つのセッションに 1 つのエージェントがちょうど合います。[全モデルの料金](https://broadrouter.com/ja/pricing/)。

## テスト方法

2026-11-15 に、クリーンな仮想環境に smolagents 1.26.0 をインストールし、BroadNet の chat completions の形式で応答するローカルのモックサーバーに対して両方のエージェントを実行しました。DeepSeek の ID を使った `CodeAgent` は、コードを含む応答を受け取って実行し、42 を返しました。そのリクエストには `max_tokens: 4000` と停止シーケンスが付いており、ツールはありませんでした。`ToolCallingAgent` についてはリクエストの形式を確認しました。モデル ID はそのまま送られ、2 つのツールスキーマと `tool_choice: "required"` が付いていました。smolagents はツールの結果を user メッセージとして送り返します。私たちのモックはこの形式に対応していなかったため、このエージェントを最終回答まで実行してはいません。BroadNet のキーは持っていなかったため、実際のモデル出力はテストしていません。

## トラブルシューティング

-   **401。** キーが間違っているか、期限切れか、利用枠を使い切っています。
-   **404。** `api_base` は `/v1` で終わっている必要があります。モデル ID も確認してください。有料モデルにはチャージが必要です。$5 のクレジットで使えるのは `broadnet/gemma-4-26b-a4b` と 2 つの Transcribe モデルだけです。
-   **「Make sure to provide correct code blobs」。** モデルの応答にコードブロックがありませんでした。推論は `max_tokens` に含まれるので上限を上げるか、別のモデルを試してください。[回答が空で返ってくる理由](https://broadrouter.com/ja/guides/reasoning-tokens-empty-response/)。
-   **ToolCallingAgent が終わらない。** `broadnet/glm-5.3` か `broadnet/qwen3.8-27b` に切り替えてください。
-   **429。** 従量課金のキーでは 1 分あたり 30 リクエストまでです。smolagents は `requests_per_minute` で自分でリクエストのペースを抑えられます。[エラーとリトライ](https://broadrouter.com/ja/guides/errors-and-retries/)を参照してください。

## このガイドの用語

[AI エージェント（AI agent）](https://broadrouter.com/ja/glossary/agent/)

AI エージェントとは、言語モデルが目標に向けて自分で手順を決めるシステムです。どのツールを呼ぶかを決め、結果を読み、最終回答を出すか上限に達するまで繰り返します。決まった箇所でモデルを呼ぶ固定のスクリプトは、ふつうワークフローと呼ばれます。

[Chat Completions API（チャット補完 API）](https://broadrouter.com/ja/glossary/chat-completions-api/)

Chat Completions API とは、OpenAI の HTTP エンドポイント POST /v1/chat/completions で、モデル名とロール付きメッセージのリストを受け取り、モデルの次のメッセージを返します。そのリクエストと応答の形は、OpenAI 互換のプロバイダーや SDK が使う共通形式になりました。

[OpenAI 互換 API（OpenAI-compatible API）](https://broadrouter.com/ja/glossary/openai-compatible-api/)

OpenAI 互換 API とは、POST /v1/chat/completions など OpenAI API と同じリクエスト形式とレスポンス形式を受け付ける HTTP API です。OpenAI の SDK やツールは、ベース URL、API キー、モデル名を変えるだけで利用できます。

[プリペイドクレジット（prepaid credit）](https://broadrouter.com/ja/glossary/prepaid-credit/)

プリペイドクレジットとは、使用前に API アカウントに入金しておくお金です。リクエストごとに費用が残高から差し引かれ、残高がなくなると、チャージするまで従量課金のリクエストは止まります。支出は支払った額までに抑えられます。

[レート制限（rate limit）](https://broadrouter.com/ja/glossary/rate-limit/)

レート制限とは、1 分あたりのリクエスト数やトークン数など、一定時間内にクライアントが API を使える量に API 側が設ける上限です。上限を超えたリクエストは、使用量が下回るまで通常 HTTP 429 Too Many Requests で拒否されます。

[従量課金（pay-as-you-go）](https://broadrouter.com/ja/glossary/pay-as-you-go/)

従量課金とは、使った分だけを支払う料金体系です。トークン、リクエスト、音声の分数などの単位で計測され、サブスクリプションや最低利用額はありません。多くの LLM API はこの方式で、前払いの残高か定期的な請求書から支払います。

## よくある質問

### OpenAIModel と OpenAIServerModel のどちらを使いますか？

smolagents 1.26 のドキュメントでは、OpenAI 互換サーバー全般に OpenAIModel を使うと説明しています。OpenAIServerModel もパッケージからエクスポートされていますが、ドキュメントで説明されているのは OpenAIModel です。

### smolagents は BroadNet の無制限プランで動きますか？

プランの対象は DeepSeek V4.1 Flash です。BroadNet はこのモデルのツール呼び出しを記載していませんが、CodeAgent はネイティブのツール呼び出しを必要とせず、モデルに Python コードを書かせます。私たちのモックテストでは、DeepSeek の ID を使った CodeAgent は tools フィールドのない通常のチャットリクエストを送りました。

### ToolCallingAgent に GLM 5.3 か Qwen3.8 27B が必要なのはなぜですか？

ツールを OpenAI の関数スキーマとして送り、tool\_choice を required にするためです。BroadNet のドキュメントでツール対応が記載されているのは GLM 5.3 と Qwen3.8 27B だけです。

### max\_tokens や temperature はどう渡しますか？

OpenAIModel のキーワード引数として渡します。smolagents のドキュメントによると、追加の引数はすべての補完呼び出しに転送されます。私たちのテストでは、すべてのリクエストに max\_tokens=4000 が付いていました。

## 関連ガイド

-   [OpenAI Python SDK を BroadNet Inference で使う](https://broadrouter.com/ja/guides/openai-python-sdk/)
-   [エージェント向け無制限 LLM API プランのしくみ](https://broadrouter.com/ja/guides/unlimited-llm-api-sessions/)
-   [推論モデルが空の回答を返す理由](https://broadrouter.com/ja/guides/reasoning-tokens-empty-response/)
-   [BroadNet Inference のエラーコードとリトライすべき場合](https://broadrouter.com/ja/guides/errors-and-retries/)
-   [BroadNet Inference で使えるすべてのツール（英語）](https://broadrouter.com/integrations/)：SDK、コーディングエージェント、チャット UI、自動化ツールと、それぞれの正確な設定

実際のワークロードで試してください。新規アカウントには US$5 の初回クレジットがあり、Gemma、文字起こし に使えます。DeepSeek、GLM、Qwen3.8 はチャージが必要です。

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

**出典**

-   [smolagents ドキュメント v1.26.0：Models リファレンス（OpenAIModel）（2026-11-15 確認）](https://huggingface.co/docs/smolagents/reference/models)
-   [PyPI の smolagents 1.26.0（2026-11-15 確認）](https://pypi.org/project/smolagents/)
-   [BroadNet Inference API リファレンス（2026-11-15 確認）（英語）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-guides-smolagents-openai-compatible&utm_content=sources)
