---
title: "Spring AI の OpenAI スターターでカスタム base-url | BroadRouter"
description: "spring.ai.openai.base-url、BroadNet のモデル ID、max-tokens を設定して Spring AI の OpenAI チャットスターターを BroadNet Inference に向け、ChatClient から呼び出します。"
url: https://broadrouter.com/ja/guides/spring-ai-openai-base-url/
lang: ja
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# Spring AI で BroadNet Inference を使う（OpenAI base-url）

更新日 2026-11-16

spring-ai-starter-model-openai を追加し、spring.ai.openai.base-url を https://inference.broadnet.ai/v1、spring.ai.openai.api-key を BroadNet のキー、spring.ai.openai.chat.model を broadnet/glm-5.3 などの BroadNet の ID にします。spring.ai.openai.chat.max-tokens は推論の分の余裕を持たせます。Spring AI 2.x は openai-java SDK を使い、base URL に /chat/completions を付け足します。

Spring AI は、Spring プロジェクトによる Java 向けの AI フレームワークです。OpenAI のチャットスターターは `base-url` を読み込むので、任意の OpenAI 互換サーバーを呼び出せます。BroadNet Inference は `https://inference.broadnet.ai/v1` で標準の chat completions を提供しています。BroadRouter は BroadNet 自身のサイトです。このガイドは Spring AI 2.0.2 のリファレンスに基づいています。

## スターターを追加する

Spring AI の BOM を設定したうえで（Spring AI の依存関係管理のドキュメントを参照）、次を追加します。

```xml
<dependency>
  <groupId>org.springframework.ai</groupId>
  <artifactId>spring-ai-starter-model-openai</artifactId>
</dependency>
```

## 設定する

`application.properties`：

```properties
spring.ai.openai.base-url=https://inference.broadnet.ai/v1
spring.ai.openai.api-key=${BROADNET_API_KEY}
spring.ai.openai.chat.model=broadnet/glm-5.3
spring.ai.openai.chat.max-tokens=2000
```

```bash
export BROADNET_API_KEY='your-broadnet-key'
```

URL の `/v1` は残してください。Spring AI 2.x では、この値はそのまま openai-java クライアントに渡され（`OpenAiSetup.calculateBaseUrl` がそのまま返します）、クライアントが `/chat/completions` を付け足します。置き換えられるデフォルト値は `https://api.openai.com/v1` です。

## 呼び出してテストする

```java
import org.springframework.ai.chat.client.ChatClient;
import org.springframework.boot.CommandLineRunner;
import org.springframework.context.annotation.Bean;

@Bean
CommandLineRunner smokeTest(ChatClient.Builder builder) {
    return args -> {
        ChatClient chat = builder.build();
        System.out.println(chat.prompt().user("Say hello in five words.").call().content());
    };
}
```

アプリを起動します。回答が出力されれば、キー、URL、モデル ID は正しく設定されています。

## BroadNet で重要な設定

-   **`max-completion-tokens` ではなく `max-tokens`。** Spring AI のドキュメントによると、この 2 つは同時に使えず、両方を設定するとエラーになります。BroadNet の API リファレンスが説明しているのは `max_tokens` です。DeepSeek V4.1 Flash、GLM 5.3、Qwen3.8 27B は先に推論し、推論はこの上限に含まれます。
-   **推論のテキスト。** Spring AI は、`reasoning_content` を返す OpenAI 互換サーバーからそれを取り出せます。BroadNet の API リファレンスは `usage` で推論トークン数を報告しますが、推論のテキストそのものを返すとは約束していないので、それに頼らないでください。
-   **チャットだけの上書き。** チャットモデルについては、`spring.ai.openai.chat.base-url` と `spring.ai.openai.chat.api-key` が共通のプロパティより優先されます。Spring AI のほかの OpenAI モデル（埋め込みなど）を OpenAI のまま使う必要がある場合に使ってください。
-   **リトライ。** `spring.ai.retry.max-attempts` のデフォルトは 10 で、指数バックオフを使います。従量課金のキーでは 1 分あたりの上限をすぐに使い切ってしまうことがあるので、下げることを検討してください。

## モデルの選び方

| 用途 | `spring.ai.openai.chat.model` |
| --- | --- |
| ツール呼び出し、構造化出力 | `broadnet/glm-5.3` |
| 画像やアラビア語のテキスト | `broadnet/qwen3.8-27b` |
| 長いドキュメント、定額プラン | `broadnet/deepseek-v4.1-flash` |
| 無料の初回クレジット | `broadnet/gemma-4-26b-a4b` |

[全モデルの料金](https://broadrouter.com/ja/pricing/)。

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

-   **401。** キーが間違っているか、期限切れか、利用枠を使い切っています。または JVM に `BROADNET_API_KEY` が設定されていません。
-   **404。** base URL に `/v1` がないか、モデル ID が間違っています。有料モデルにはチャージが必要です。$5 のクレジットで使えるのは `broadnet/gemma-4-26b-a4b` と 2 つの Transcribe モデルだけです。
-   **`content()` が空。** 推論が出力の枠を使い切りました。`max-tokens` を上げてください。[回答が空で返ってくる理由](https://broadrouter.com/ja/guides/reasoning-tokens-empty-response/)。
-   **両方のトークン上限を設定して 400 になる。** `max-completion-tokens` を削除してください。
-   **429。** 従量課金のキーでは 1 分あたり 30 リクエスト、処理中のリクエストは同時に 4 個までです。[エラーとリトライ](https://broadrouter.com/ja/guides/errors-and-retries/)を参照してください。

## このガイドの用語

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

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

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

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

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

[従量課金（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 が使う共通形式になりました。

[エンベディング（埋め込み、embeddings）](https://broadrouter.com/ja/glossary/embeddings/)

エンベディング（埋め込み）とは、テキストや画像などの入力を表すためにモデルが出力する浮動小数点数のリスト（ベクトル）です。意味の近い入力ほどベクトルも近いので、その距離で検索結果の順位付け、文書の分類、関連項目の発見ができます。

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

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

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

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

## よくある質問

### spring.ai.openai.base-url に /v1 は含めますか？

はい。Spring AI 2.x ではこの値がそのまま openai-java クライアントに渡され、クライアント自体のデフォルトは https://api.openai.com/v1 です。https://inference.broadnet.ai/v1 を使ってください。

### BroadNet では max-tokens と max-completion-tokens のどちらを使いますか？

max-tokens です。Spring AI のドキュメントによると、この 2 つは同時に使えません。BroadNet の API リファレンスは max\_tokens フィールドを説明しており、推論もこれに含まれるので、1,000 トークン以上を確保してください。

### Spring AI のツール呼び出しは BroadNet で動きますか？

BroadNet がツール対応として記載している GLM 5.3 か Qwen3.8 27B を使ってください。BroadNet のドキュメントには DeepSeek V4.1 Flash のツール呼び出しの記載がありません。

### 埋め込みは OpenAI のまま、チャットだけ BroadNet にできますか？

できます。spring.ai.openai.chat.base-url と spring.ai.openai.chat.api-key は、チャットモデルに限って共通のプロパティを上書きします。BroadNet の API リファレンスには埋め込みのエンドポイントは記載されていません。

## 関連ガイド

-   [Go の openai-go SDK から BroadNet Inference を呼び出す](https://broadrouter.com/ja/guides/openai-go-sdk/)
-   [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-spring-ai-openai-base-url&utm_content=page-cta) ·

**出典**

-   [Spring AI リファレンス：OpenAI Chat（2.0.2）（2026-11-15 確認）](https://docs.spring.io/spring-ai/reference/api/chat/openai-chat.html)
-   [Spring AI のソース（v2.0.2）：OpenAiSetup.calculateBaseUrl（2026-11-16 確認）](https://github.com/spring-projects/spring-ai/blob/v2.0.2/models/spring-ai-openai/src/main/java/org/springframework/ai/openai/setup/OpenAiSetup.java)
-   [BroadNet Inference API リファレンス（2026-11-15 確認）（英語）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-guides-spring-ai-openai-base-url&utm_content=sources)
