---
title: "Vercel AI SDK の createOpenAICompatible でベース URL を指定 | BroadRouter"
description: "@ai-sdk/openai-compatible の createOpenAICompatible を使い、Vercel AI SDK から BroadNet Inference を呼び出します。generateText、streamText、ツール、推論の強度を解説します。"
url: https://broadrouter.com/ja/guides/vercel-ai-sdk-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/vercel-ai-sdk-openai-compatible/)（2026-11-16 更新）。

# Vercel AI SDK で BroadNet Inference を使う

更新日 2026-11-16

ai と @ai-sdk/openai-compatible をインストールし、name を broadnet、baseURL を https://inference.broadnet.ai/v1、apiKey を BroadNet のキーにして createOpenAICompatible を呼び出します。プロバイダーに broadnet/glm-5.3 などの BroadNet のモデル ID を渡し、generateText や streamText をいつもどおり使います。キーはサーバー側に置き、推論モデルには maxOutputTokens を十分に与えてください。

Vercel の [AI SDK](https://ai-sdk.dev/providers/openai-compatible-providers) は、LLM アプリ向けの TypeScript ツールキットです。`@ai-sdk/openai-compatible` パッケージは、OpenAI の chat completions 形式に従う任意の API 用のプロバイダーを作成します。BroadNet Inference もこの形式に従っているので、変えるのはベース URL、キー、モデル ID だけです。素の OpenAI クライアントを使う場合は、[Node SDK のガイド](https://broadrouter.com/ja/guides/openai-node-sdk/)を参照してください。

## 設定手順

1.  **パッケージをインストールします。** 執筆時点で npm から入るのは `ai` 7.x と `@ai-sdk/openai-compatible` 3.x です。
    
    ```bash
    npm install ai @ai-sdk/openai-compatible
    export BROADNET_API_KEY='your-broadnet-key'
    ```
    
2.  **プロバイダーを作成します。**
    
    ```ts
    // broadnet.ts
    import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
    
    export const broadnet = createOpenAICompatible({
      name: 'broadnet',
      baseURL: 'https://inference.broadnet.ai/v1',
      apiKey: process.env.BROADNET_API_KEY,
      includeUsage: true, // usage data in streaming responses
    });
    ```
    
3.  **テキストを生成します。**
    
    ```ts
    import { generateText } from 'ai';
    import { broadnet } from './broadnet';
    
    const { text, usage, finishReason } = await generateText({
      model: broadnet('broadnet/glm-5.3'),
      prompt: 'Explain idempotency keys in two sentences.',
      maxOutputTokens: 4000, // reasoning counts toward this
    });
    
    console.log(text, finishReason, usage);
    ```
    

コード内の英語のコメントは、それぞれ「ストリーミングのレスポンスに使用量のデータを含める」「推論もこの上限に含まれる」という意味です。

4.  **ストリーミングにします。** `generateText` を `streamText` に替えて、`textStream` を読み取ります。その下で使われている通信形式は[ストリーミングのガイド](https://broadrouter.com/ja/guides/streaming-chat-completions/)で説明しています。

渡した `name` はプロバイダーオプションとプロバイダーメタデータのキーになるので、短く、変わらない名前にしてください。`provider('id')` と `provider.chatModel('id')` はどちらもチャットモデルを作成し、モデルごとの個別の設定はありません。キーはサーバー側に置いてください。このファイルをブラウザで動くコードに import すると、キーがすべての訪問者に送られてしまいます。

プロバイダーのドキュメントでは、対応機能としてテキスト生成、ストリーミング、ツール呼び出し、構造化出力、推論の内容、画像入力が挙げられており、一部はプロバイダー次第と注記されています。BroadNet では、DeepSeek V4.1 Flash、Qwen3.8 27B、Gemma 4 VL 26B が画像入力に対応し、GLM 5.3 はテキストのみです。

## 設定しておきたいオプション

-   **reasoningEffort。** プロバイダー名をキーにして `providerOptions` で渡します。AI SDK のドキュメントによると、指定できる値はプロバイダーによって異なります。BroadNet のドキュメントには `low` が載っています。

```ts
const result = await generateText({
  model: broadnet('broadnet/deepseek-v4.1-flash'),
  prompt: 'Classify: "refund my order" -> intent?',
  providerOptions: { broadnet: { reasoningEffort: 'low' } },
});
```

-   **supportsStructuredOutputs。** AI SDK は、プロバイダーでこれが `true` のときだけ JSON スキーマを送ります。BroadNet が構造化出力を記載しているのは GLM 5.3 と Qwen3.8 27B です。オンにする場合は、スキーマ付きの出力にはこれらのモデルを使ってください。
-   **maxRetries。** `generateText` はデフォルトで 2 回リトライします。レート制限に合わせて設定してください。
-   **推論の出力。** プロバイダーが推論の内容を返すと、AI SDK はそれを読み取ります。トップレベルの結果フィールド `reasoningText` は非推奨となり、`finalStep.reasoningText` に置き換えられています。推論の内容が必ずあることを前提にしたロジックは組まないでください。

## モデルの選び方

| 用途 | モデル | コンテキスト |
| --- | --- | --- |
| ツール呼び出し、構造化出力 | [`broadnet/glm-5.3`](https://broadrouter.com/ja/models/glm-5.3/) | 1,048,576 |
| 画像とツール、アラビア語 | [`broadnet/qwen3.8-27b`](https://broadrouter.com/ja/models/qwen3.8-27b/) | 262,144 |
| 長いコンテキスト、定額プラン | [`broadnet/deepseek-v4.1-flash`](https://broadrouter.com/ja/models/deepseek-v4.1-flash/) | 1,048,576 |
| 安価なテキストと画像の呼び出し | [`broadnet/gemma-4-26b-a4b`](https://broadrouter.com/ja/models/gemma-4-vl-26b/) | 32,768 |

各モデルのトークン単価は[料金ページ](https://broadrouter.com/ja/pricing/)にあります。

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

-   **401。** 実行環境に `BROADNET_API_KEY` がない（ホスティング先の環境変数の設定を確認してください）、キーが間違っている、期限切れ、または従量課金の利用枠を使い切っています。
-   **providerOptions が無視される。** キーはプロバイダーの `name` をキャメルケースにしたものと一致している必要があります。`name: 'broadnet'` なら `providerOptions.broadnet` を使います。
-   **モデルのエラー。** ID は `broadnet/` プレフィックスを含めて BroadNet のものと完全に一致している必要があります。GLM 5.3、Qwen3.8 27B、DeepSeek V4.1 Flash にはチャージが必要です。$5 の初回クレジットで使えるのは Gemma 4 VL 26B と 2 つの Transcribe モデルです。
-   **テキストが空で finishReason が “length”。** 推論が予算を使い切っています。`maxOutputTokens` を上げるか、`reasoningEffort` を下げてください。[回答が空になる理由](https://broadrouter.com/ja/guides/reasoning-tokens-empty-response/)。
-   **負荷がかかると 429。** 従量課金のキーは毎分 30 リクエスト、同時実行 4 リクエストまでです。サーバーレス関数はすぐにスケールアウトするので、アプリ側で同時実行数に上限を設けてください。[エラーとリトライ](https://broadrouter.com/ja/guides/errors-and-retries/)を参照してください。
-   **プランのキーでエージェントを並列に動かす場合。** 1 つの[無制限プランのセッション](https://broadrouter.com/ja/guides/unlimited-llm-api-sessions/)は同時に 1 リクエストしか処理しません。`Promise.all` で複数のエージェントを動かすなら、エージェントごとに 1 セッションが必要です。そうしないとリクエストは待ち行列に入ります。

## このガイドの用語

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

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

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

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

[同時実行数（concurrency）](https://broadrouter.com/ja/glossary/concurrency/)

同時実行数（concurrency）とは、クライアントが同時に処理中にしているリクエストの数です。開いているリクエストは応答が終わるまで GPU の容量を占有するため、LLM 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 はこの方式で、前払いの残高か定期的な請求書から支払います。

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

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

[JSON Schema（JSON スキーマ）](https://broadrouter.com/ja/glossary/json-schema/)

JSON Schema とは、JSON データの構造（型、必須フィールド、許可される値、入れ子）を記述・検証するための、JSON で書かれた語彙です。現行バージョンは 2020-12 です。LLM API はツールのパラメーターや、構造化出力が従うべき正確な形の定義に使います。

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

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

## よくある質問

### @ai-sdk/openai と @ai-sdk/openai-compatible のどちらを使えばよいですか？

サードパーティの OpenAI 互換 API には @ai-sdk/openai-compatible を使ってください。これは chat completions のエンドポイントを呼び出し、BroadNet Inference が提供しているのもこのエンドポイントです。

### 生成されたテキストが空になるのはなぜですか？

BroadNet では推論が max\_tokens に含まれます。maxOutputTokens が小さいと、回答を書き始める前にモデルが使い切ることがあります。値を上げるか、reasoningEffort を low にしてください。

### ストリーミング中にトークンの使用量を取得するには？

プロバイダーの作成時に includeUsage を true にしてください。AI SDK のドキュメントによると、ストリーミングのレスポンスに使用量のデータが追加されます。デフォルトは false です。

### BroadNet のモデルごとに個別の設定が必要ですか？

いいえ。1 つの createOpenAICompatible プロバイダーですべてのモデルを扱えます。任意の BroadNet チャットモデルの ID で broadnet('model-id') または broadnet.chatModel('model-id') を呼び出してください。

## 関連ガイド

-   [OpenAI Node.js SDK を BroadNet Inference で使う](https://broadrouter.com/ja/guides/openai-node-sdk/)
-   [chat completions のストリーミングと接続切断への対処](https://broadrouter.com/ja/guides/streaming-chat-completions/)
-   [推論モデルが空の回答を返す理由](https://broadrouter.com/ja/guides/reasoning-tokens-empty-response/)
-   [opencode に BroadNet Inference をカスタムプロバイダーとして追加する](https://broadrouter.com/ja/guides/opencode-custom-provider/)
-   [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-vercel-ai-sdk-openai-compatible&utm_content=page-cta) ·

**出典**

-   [AI SDK ドキュメント、OpenAI Compatible プロバイダー（2026-11-14 確認）](https://ai-sdk.dev/providers/openai-compatible-providers)
-   [AI SDK ドキュメント、generateText リファレンス（2026-11-14 確認）](https://ai-sdk.dev/docs/reference/ai-sdk-core/generate-text)
-   [npm の @ai-sdk/openai-compatible パッケージ（3.x、2026-11-14 確認）](https://www.npmjs.com/package/@ai-sdk/openai-compatible)
-   [BroadNet Inference API リファレンス（英語）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-guides-vercel-ai-sdk-openai-compatible&utm_content=sources)
