---
title: "CrewAI でカスタムの OpenAI 互換 base_url を設定する | BroadRouter"
description: "LLM(custom_openai=True, base_url=...) で CrewAI のエージェントを BroadNet Inference に向け、ツール、長いコンテキスト、定額プランに合わせてモデルを選ぶ方法です。"
url: https://broadrouter.com/ja/guides/crewai-custom-openai-endpoint/
lang: ja
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# CrewAI で BroadNet Inference をカスタム OpenAI エンドポイントとして使う

更新日 2026-11-16

crewai の LLM クラスでモデルを作成し、model に broadnet/glm-5.3 などの BroadNet の ID、custom\_openai=True、base\_url に https://inference.broadnet.ai/v1、api\_key に BroadNet のキーを渡します。その LLM を各 Agent に渡します。CrewAI はネイティブの OpenAI クライアントと chat completions を使うので、LiteLLM のインストールは不要です。

CrewAI は、エージェントのチームを組むための Python フレームワークです。ドキュメントには**カスタムの OpenAI 互換エンドポイント**のパターンとして、`custom_openai=True` と `base_url` を指定した `LLM` が載っています。BroadNet Inference は `https://inference.broadnet.ai/v1` で標準的な chat completions を提供しているので、そこに組み込めます。BroadRouter は BroadNet 自身のサイトです。この記事はバージョン 1.15.41 時点の CrewAI のドキュメントとソースコードに沿っています。

## インストール

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

## 接続する

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

`llm.call` が回答を表示すれば、キー、URL、モデル ID は正しく設定されています。

## CrewAI がリクエストを振り分ける仕組み

CrewAI のソースコードには優先順位があります。`custom_openai=True` が最優先で、ネイティブの OpenAI プロバイダーを強制し、モデル名が示すものはすべて上書きされます。また、`base_url`、`api_base`、`OPENAI_BASE_URL`、`OPENAI_API_BASE` のいずれかでカスタムのエンドポイントを設定していないとエラーになります。モデルの文字列は書いたとおりに送られるので、`broadnet/glm-5.3` はそのまま BroadNet に届きます。

`custom_openai` がないと、`broadnet/glm-5.3` のような名前はプロバイダー `broadnet` と解釈されます。CrewAI はこのプロバイダーを知らないため、LiteLLM にフォールバックします。ドキュメントに載っている別の書き方は、`model="openai/broadnet/glm-5.3"` と `base_url` の組み合わせです。CrewAI は `openai/` プレフィックスを取り除き、残りを送ります。

CrewAI のコードとドキュメントからは、ほかにも 2 点わかります。

-   **トークン上限のフィールド。** `max_tokens` を渡すと、ネイティブのクライアントは chat completions で `max_tokens` を送ります。BroadNet の API リファレンスに記載されているフィールドです。`max_completion_tokens` を渡した場合は、そちらが送られます。
-   **chat completions のままにする。** CrewAI のドキュメントには、Responses API に切り替える `api="responses"` が載っています。これは設定しないでください。BroadNet はこの API を掲載していません。

## どのエージェントにどのモデルを使うか

| エージェント | モデル | 理由 |
| --- | --- | --- |
| ツールを使うエージェント | `broadnet/glm-5.3` | BroadNet がツールと構造化出力を掲載。1M コンテキスト |
| 画像やアラビア語の入力、ツールあり | `broadnet/qwen3.8-27b` | ツールと画像。262K コンテキスト |
| 長文を読むタスク、定額プラン | `broadnet/deepseek-v4.1-flash` | 無制限プラン。BroadNet はツールを掲載していない |

1 つの crew でこれらを組み合わせることもできます。`Agent` ごとに別の `LLM` を渡してください。

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

-   **401。** キーが間違っている、期限切れ、または利用枠を使い切っています。`api_key` を省略した場合、CrewAI は `OPENAI_API_KEY` を読みます。そこには OpenAI のキーが入っているかもしれません。
-   **“custom\_openai=True requires base\_url”。** `base_url` を渡すか、`OPENAI_BASE_URL` を設定してください。
-   **モデルが見つからない。** ID が BroadNet のものと完全に一致しているか確認してください。有料モデルにはチャージが必要です。$5 のクレジットで使えるのは `broadnet/gemma-4-26b-a4b` と 2 つの Transcribe モデルだけです。
-   **`EmptyLLMResponseError`。** CrewAI は空の回答を 1 回だけリトライし、その後このエラーを出します。`max_tokens` を大きくしてください。[回答が空で返ってくる理由](https://broadrouter.com/ja/guides/reasoning-tokens-empty-response/)。
-   **複数のエージェントで 429。** 従量課金のキーでは 1 分あたり 30 リクエスト、処理中のリクエストは同時に 4 個までで、プランのセッションは一度に 1 つのリクエストしか処理しません。[エラーとリトライ](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 キー、モデル名を変えるだけで利用できます。

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

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

[コンテキストウィンドウ（context window）](https://broadrouter.com/ja/glossary/context-window/)

コンテキストウィンドウとは、言語モデルが 1 回のリクエストで扱えるトークン数の上限です。プロンプト、会話履歴、ツール定義、画像、推論トークンを含む出力がすべて入ります。収まらない部分は削るか要約するか、複数のリクエストに分けます。

[トークン（token）](https://broadrouter.com/ja/glossary/token/)

トークンとは、言語モデルが読み書きするテキストの単位です。モデルのトークナイザーが作る単語、単語の一部、句読点、バイト列のいずれかにあたります。LLM API は利用量をトークンで数え、上限を設け、通常はトークン単位で課金します。

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

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

[ベース URL（base URL）](https://broadrouter.com/ja/glossary/base-url/)

ベース URL とは、https://api.example.com/v1 のような API の固定のルートアドレスで、クライアントが /chat/completions などのエンドポイントパスの前に付けます。OpenAI 互換の SDK では、API キーとモデル ID と一緒にベース URL を変えるだけで、同じコードを別のプロバイダーに向けられます。

## よくある質問

### CrewAI の custom\_openai=True は何をするのですか？

CrewAI のソースコードによると、モデル名がどう見えるかに関係なくネイティブの OpenAI プロバイダーを強制し、base\_url、api\_base、OPENAI\_BASE\_URL、OPENAI\_API\_BASE のいずれかを必須にします。モデルの文字列は書いたとおりに送られるので、broadnet/glm-5.3 はそのまま BroadNet に届きます。

### model="openai/broadnet/glm-5.3" と書いてもいいですか？

はい。カスタムの base\_url があると、CrewAI は openai/ プレフィックスをネイティブの OpenAI クライアントに振り分けてプレフィックスを取り除くので、BroadNet には broadnet/glm-5.3 が届きます。custom\_openai=True のほうが意図が明確です。

### crew が EmptyLLMResponseError で失敗するのはなぜですか？

CrewAI は、内容もツール呼び出しもない空の回答を 1 回だけ再試行し、再試行も空だとこのエラーを出します。BroadNet の推論モデルでは、たいてい推論が出力の上限を使い切ったことを意味します。max\_tokens を大きくしてください。

### CrewAI のエージェントにはどの BroadNet モデルを使えばいいですか？

ツールを使うエージェントには GLM 5.3 です。BroadNet がツールと構造化出力に対応として掲載しています。Qwen3.8 27B もツールに対応し、画像も受け付けます。

## 関連ガイド

-   [Pydantic AI を BroadNet Inference で使う（OpenAICompatibleProvider）](https://broadrouter.com/ja/guides/pydantic-ai-openai-compatible/)
-   [OpenAI Python SDK を BroadNet Inference で使う](https://broadrouter.com/ja/guides/openai-python-sdk/)
-   [推論モデルが空の回答を返す理由](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-crewai-custom-openai-endpoint&utm_content=page-cta) ·

**出典**

-   [CrewAI ドキュメント：LLM（OpenAI、カスタムの OpenAI 互換エンドポイント）（2026-11-15 確認）](https://docs.crewai.com/en/concepts/llms)
-   [CrewAI ソースコード：custom\_openai の LLM ルーティング（llm.py）（2026-11-15 確認）](https://github.com/crewAIInc/crewAI/blob/main/lib/crewai/src/crewai/llm.py)
-   [PyPI：crewai 1.15.41、Python 3.10〜3.13（2026-11-15 確認）](https://pypi.org/project/crewai/)
-   [BroadNet Inference API リファレンス（2026-11-15 確認）（英語）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-guides-crewai-custom-openai-endpoint&utm_content=sources)
