---
title: "Mastra でカスタム OpenAI 互換エンドポイント（model の url） | BroadRouter"
description: "id、url、apiKey を指定した model オブジェクトで Mastra のエージェントを BroadNet Inference 上で動かします。モデル ID に broadnet/ プレフィックスを二重に付ける理由も説明します。"
url: https://broadrouter.com/ja/guides/mastra-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/mastra-openai-compatible/)（2026-11-16 更新）。

# Mastra のエージェントを BroadNet Inference で動かす

更新日 2026-11-16

Mastra の Agent で、model を url が https://inference.broadnet.ai/v1、apiKey が BROADNET\_API\_KEY、id が broadnet/broadnet/glm-5.3 のオブジェクトにします。Mastra は id の最初の部分をプロバイダー名とみなして取り除くので、プレフィックスを二重にすると BroadNet には broadnet/glm-5.3 が届きます。カスタム URL はデフォルトで chat completions を使います。ツールには GLM 5.3 か Qwen3.8 27B を使ってください。

Mastra は、AI エージェントとワークフローのための TypeScript フレームワークです。組み込みのプロバイダーのほか、エージェントの `model` には、`id` と `url` を持つオブジェクトとして任意の OpenAI 互換エンドポイントを指定できます。BroadNet Inference は `https://inference.broadnet.ai/v1` で標準的な chat completions を提供しているのでこの方法で使えますが、モデル ID に 1 つ注意点があります。BroadRouter は BroadNet 自身のサイトです。この記事は [Mastra のモデルのドキュメント](https://mastra.ai/models)と @mastra/core 1.83.0 に基づいています。

## インストール

```bash
npm install @mastra/core zod
export BROADNET_API_KEY='your-broadnet-key'
```

## エージェントを接続する

```ts
import { Agent } from "@mastra/core/agent";

const broadnet = (model: string) => ({
  id: `broadnet/${model}`,              // Mastra strips the first segment
  url: "https://inference.broadnet.ai/v1",
  apiKey: process.env.BROADNET_API_KEY,
});

export const assistant = new Agent({
  id: "assistant",
  name: "Assistant",
  instructions: "You are a concise assistant.",
  model: broadnet("broadnet/glm-5.3"),     // sends broadnet/glm-5.3
});

const res = await assistant.generate("Give me three names for a Go linting tool.");
console.log(res.text);
```

### プレフィックスを二重にする理由

Mastra のドキュメントによると、`provider/model` と書いた `id` ではプロバイダーを除いたモデル名がリモートに送られ、`gateway/provider/model` と書けば名前にプロバイダーが残ります。BroadNet の ID にはスラッシュが含まれるので、長い形式が必要です。私たちのテスト結果は次のとおりです。

| Mastra の `id` | BroadNet が受け取ったモデル ID |
| --- | --- |
| `broadnet/glm-5.3` | `glm-5.3`（誤り） |
| `broadnet/broadnet/glm-5.3` | `broadnet/glm-5.3`（正しい） |

上のヘルパー関数が、この追加のセグメントを付けてくれます。

## ツール

```ts
import { createTool } from "@mastra/core/tools";
import { z } from "zod";

const weather = createTool({
  id: "get_weather",
  description: "Get the weather for a city",
  inputSchema: z.object({ city: z.string() }),
  execute: async (input) => ({ city: input.city, tempC: 21 }),
});

const agent = new Agent({
  id: "weather",
  name: "Weather",
  instructions: "Use the weather tool to answer.",
  tools: { weather },
  model: broadnet("broadnet/glm-5.3"),
});
```

ツールを使うエージェントには `broadnet/glm-5.3` か `broadnet/qwen3.8-27b` を使ってください。BroadNet のドキュメントでツールと構造化出力が記載されているのはこの 2 つのモデルだけです。

## ストリーミング

```ts
const stream = await assistant.stream("Explain vector search in two sentences.");
for await (const chunk of stream.textStream) process.stdout.write(chunk);
```

## 重要な設定

-   **`url`** はベース URL で、`/v1` で終わります。`/chat/completions` は Mastra が付けます。
-   **`api: "responses"` は追加しないでください。** Mastra のドキュメントによると、これを指定すると `/v1/responses` に切り替わります。BroadNet は Responses API を記載していません。
-   **出力上限。** DeepSeek V4.1 Flash、GLM 5.3、Qwen3.8 27B は回答の前に推論し、推論も出力の上限に含まれます。出力トークンに上限を設ける場合は 2,000 以上にしてください。

## モデルの選び方

| エージェント | モデル |
| --- | --- |
| ツール、構造化出力、ワークフロー | `broadnet/glm-5.3` |
| ツールと画像入力、またはアラビア語のテキスト | `broadnet/qwen3.8-27b` |
| 定額プランでのテキストのみのステップ | `broadnet/deepseek-v4.1-flash` |

[全モデルの料金](https://broadrouter.com/ja/pricing/)。Mastra を使わずに Vercel AI SDK を使う場合は、[AI SDK のガイド](https://broadrouter.com/ja/guides/vercel-ai-sdk-openai-compatible/)を参照してください。

## テスト方法

2026-11-15 に Node 24 で @mastra/core 1.83.0 をインストールし、`generate`、`stream`、ツールを使うエージェントを、BroadNet の chat completions の形式で応答しツール呼び出しを返すローカルのモックサーバーに向けて実行しました。記録されたリクエストを確認したところ、すべての呼び出しが `/v1/chat/completions` に届き、`apiKey` の値が Bearer キーとして付いていました。上の表のプレフィックスのルールは、こうして見つけたものです。BroadNet のキーは持っていなかったため、実際のモデル出力はテストしていません。

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

-   **404 やモデルが見つからない。** モデル ID のプレフィックスが落ちている可能性が高いです。`id` を `broadnet/broadnet/glm-5.3` と書いてください。次に `url` が `/v1` で終わっているか確認します。有料モデルにはチャージが必要です。$5 のクレジットで使えるのは `broadnet/gemma-4-26b-a4b` と 2 つの Transcribe モデルだけです。
-   **401。** プロセスに `BROADNET_API_KEY` が設定されていないか、キーが間違っている、または利用枠を使い切っています。
-   **返答が空になる。** 出力の上限を推論で使い切っています。[回答が空で返ってくる理由](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 が使う共通形式になりました。

[max\_tokens（最大出力トークン数）](https://broadrouter.com/ja/glossary/max-tokens/)

max\_tokens とは、モデルが 1 回の応答で生成できるトークン数の上限を決める LLM API のパラメーターです。生成が上限に達すると止まり、応答は途中で打ち切られたものとして、たとえば finish\_reason が "length" になります。

[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 キー、モデル名を変えるだけで利用できます。

[構造化出力（Structured Outputs）](https://broadrouter.com/ja/glossary/structured-output/)

構造化出力とは、モデルの回答を開発者が指定した形式（通常は JSON Schema）に制約し、コードで確実に解析できるようにする LLM API の機能です。有効な JSON であることだけを保証し、特定の形までは保証しない JSON モードより厳格です。

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

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

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

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

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

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

## よくある質問

### Mastra が broadnet/glm-5.3 ではなく glm-5.3 を送るのはなぜですか？

Mastra はモデルの id を「プロバイダー/モデル」として読み、最初のスラッシュより後ろの部分だけを送ります。私たちのテストでは、id を broadnet/glm-5.3 にすると glm-5.3 が送られ、BroadNet はこれを認識しません。id は broadnet/broadnet/glm-5.3 と書いてください。

### Mastra の url はベース URL と chat completions の URL のどちらですか？

ベース URL です。Mastra のドキュメントでは OpenAI 互換エンドポイントのベース URL を使うよう説明されているので、/chat/completions を付けずに https://inference.broadnet.ai/v1 を指定します。

### カスタム URL を使うと Mastra は Responses API を使いますか？

デフォルトでは使いません。Mastra のドキュメントによると、api を responses に設定しない限り、カスタムエンドポイントは chat completions を使います。BroadNet は chat completions を提供しているので、この設定は追加しないでください。

### Mastra のツールは BroadNet で動きますか？

動きます。BroadNet がツールを記載しているモデル、GLM 5.3 か Qwen3.8 27B を使ってください。私たちのモックテストでは、エージェントがツールのスキーマを送り、ツールを実行して結果を返しました。

## 関連ガイド

-   [Vercel AI SDK で BroadNet Inference を使う](https://broadrouter.com/ja/guides/vercel-ai-sdk-openai-compatible/)
-   [OpenAI Node.js SDK を BroadNet Inference で使う](https://broadrouter.com/ja/guides/openai-node-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-mastra-openai-compatible&utm_content=page-cta) ·

**出典**

-   [Mastra ドキュメント、Models（カスタムの OpenAI 互換エンドポイント）（2026-11-15 確認）](https://mastra.ai/models)
-   [Mastra の GitHub、@mastra/core 1.83.0 リリース、2026-11-13（2026-11-15 確認）](https://github.com/mastra-ai/mastra/releases/tag/%40mastra%2Fcore%401.83.0)
-   [BroadNet Inference API リファレンス（2026-11-15 確認）（英語）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-guides-mastra-openai-compatible&utm_content=sources)
