---
title: "Spring AI OpenAI starter 配置自定义 base-url | BroadRouter"
description: "用 spring.ai.openai.base-url、BroadNet 模型 ID 和 max-tokens 把 Spring AI 的 OpenAI chat starter 指向 BroadNet Inference，再通过 ChatClient 调用。"
url: https://broadrouter.com/zh/guides/spring-ai-openai-base-url/
lang: zh-Hans
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 更新）。

# 在 BroadNet Inference 上使用 Spring AI（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 ID（如 broadnet/glm-5.3）。设置 spring.ai.openai.chat.max-tokens 时给思考留出空间。Spring AI 2.x 使用 openai-java SDK，它会在 base URL 后追加 /chat/completions。

Spring AI 是 Spring 项目推出的 Java AI 框架。它的 OpenAI chat starter 会读取 `base-url`，因此可以调用任何 OpenAI 兼容服务器。BroadNet Inference 在 `https://inference.broadnet.ai/v1` 上提供标准的对话补全。BroadRouter 是 BroadNet 自己的网站；本文依据 Spring AI 2.0.2 参考文档。

## 添加 starter

在已引入 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-tokens`，不用 `max-completion-tokens`。** Spring AI 的文档说两者互斥，同时设置会报错。BroadNet 的 API 参考文档描述的是 `max_tokens`。DeepSeek V4.1 Flash、GLM 5.3 和 Qwen3.8 27B 会先思考，思考内容计入这个上限。
-   **思考文本。** 对于会返回 `reasoning_content` 的 OpenAI 兼容服务器，Spring AI 可以把它暴露出来。BroadNet 的 API 参考文档在 `usage` 中报告思考 token 数，但没有承诺返回思考文本本身，所以不要依赖它。
-   **只覆盖对话模型。** 对于对话模型，`spring.ai.openai.chat.base-url` 和 `spring.ai.openai.chat.api-key` 优先于共享属性。如果其他 Spring AI OpenAI 模型（例如 embeddings）必须继续使用 OpenAI，就用这两个属性。
-   **重试。** `spring.ai.retry.max-attempts` 默认为 10，并采用指数退避。在按量付费密钥上，这可能很快耗尽每分钟的请求限额；可以考虑调低。

## 选哪个模型

| 用途 | `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/zh/pricing/)。

## 故障排查

-   **401。** 密钥错误、已过期或额度已用完，或者 JVM 中没有设置 `BROADNET_API_KEY`。
-   **404。** base URL 缺少 `/v1`，或者模型 ID 错误。付费模型需要先充值；$5 额度只能用于 `broadnet/gemma-4-26b-a4b` 和两个 Transcribe 模型。
-   **`content()` 为空。** 思考用掉了输出预算。调高 `max-tokens`。[为什么回答会是空的](https://broadrouter.com/zh/guides/reasoning-tokens-empty-response/)。
-   **同时设置了两种 token 上限，返回 400。** 删除 `max-completion-tokens`。
-   **429。** 按量付费密钥每分钟允许 30 个请求，同时最多 4 个在处理中。参见[错误码与重试](https://broadrouter.com/zh/guides/errors-and-retries/)。

## 本指南涉及的术语

[嵌入向量（embeddings）](https://broadrouter.com/zh/glossary/embeddings/)

嵌入向量（embeddings）是模型为一段文本、一张图片或其他输入生成的浮点数列表（向量）。意思相近的输入会得到彼此接近的向量，因此可以用向量之间的距离来给搜索结果排序、对文档聚类或查找相关条目。

[Token（词元）](https://broadrouter.com/zh/glossary/token/)

token（词元）是大语言模型读写文本的基本单位：由模型的分词器切分出的一个词、词的一部分、一个标点或一段字节序列。大模型 API 按 token 计数、设定限制，通常也按 token 计费。

[按量付费（pay-as-you-go）](https://broadrouter.com/zh/glossary/pay-as-you-go/)

按量付费是一种计价模式：你只为实际用量付费，按 token、请求次数或音频分钟等单位计量，没有订阅费，也没有最低消费承诺。大多数大模型 API 都这样计费，从预付余额中扣减或定期开具账单。

[Base URL（base\_url）](https://broadrouter.com/zh/glossary/base-url/)

base URL 是 API 固定的根地址，例如 https://api.example.com/v1，客户端会把它加在每个端点路径（例如 /chat/completions）前面。在 OpenAI 兼容 SDK 中，修改 base URL，再配合 API 密钥和模型 ID，就能让同一份代码改用另一家服务商。

[并发（concurrency）](https://broadrouter.com/zh/glossary/concurrency/)

并发（concurrency）是客户端在同一时刻正在进行中的请求数。大模型 API 往往按密钥或套餐单独限制并发，与每分钟请求数分开计算，因为每个未完成的请求在响应结束前都会占用 GPU 资源。

[大模型包月套餐（flat-rate LLM plan）](https://broadrouter.com/zh/glossary/flat-rate-llm-plan/)

大模型包月套餐（固定价格套餐）是按一个周期（如一个月）收取固定费用、提供大模型 API 使用权的计价方式，不按 token 计费。这类套餐通常会限制别的东西，如并发、速度、模型或使用时间窗口，所以限制条件和价格同样重要。

[结构化输出（structured output）](https://broadrouter.com/zh/glossary/structured-output/)

结构化输出是大模型 API 的一项功能，它把模型的回复约束为开发者指定的格式（通常是 JSON Schema），让代码能可靠地解析。它比 JSON mode 更严格：JSON mode 只保证输出是合法 JSON，不保证特定结构。

[上下文窗口（context window）](https://broadrouter.com/zh/glossary/context-window/)

上下文窗口是语言模型在单次请求中能处理的最大 token 数。它涵盖提示词、对话历史、工具定义、图片以及生成的输出（包括思考 token）。放不下的内容必须删减、摘要，或拆分到多个请求中。

## 常见问题

### 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 的文档说两者互斥。BroadNet 的 API 参考文档描述的是 max\_tokens 字段，思考内容计入其中，所以请留出 1,000 token 或更多。

### Spring AI 的工具调用在 BroadNet 上能用吗？

请使用 BroadNet 列出了工具支持的 GLM 5.3 或 Qwen3.8 27B。BroadNet 的文档没有为 DeepSeek V4.1 Flash 列出工具调用。

### 能否 embeddings 继续用 OpenAI，对话改用 BroadNet？

可以。spring.ai.openai.chat.base-url 和 spring.ai.openai.chat.api-key 只对对话模型覆盖共享属性。BroadNet 的 API 参考文档没有列出 embeddings 端点。

## 相关指南

-   [用 Go 和 openai-go SDK 调用 BroadNet Inference](https://broadrouter.com/zh/guides/openai-go-sdk/)
-   [用 OpenAI Python SDK 调用 BroadNet Inference](https://broadrouter.com/zh/guides/openai-python-sdk/)
-   [推理模型为什么返回空回答](https://broadrouter.com/zh/guides/reasoning-tokens-empty-response/)
-   [BroadNet Inference 错误码，以及什么时候该重试](https://broadrouter.com/zh/guides/errors-and-retries/)
-   [所有可与 BroadNet Inference 配合使用的工具（英文）](https://broadrouter.com/integrations/)：SDK、编程智能体、聊天界面和自动化工具，并附每个工具的具体设置

用你的真实业务负载试一试。新账户可获得 US$5 初始额度，用于 Gemma和转写。DeepSeek、GLM和Qwen3.8 需要先充值。

[开始使用](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-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=zh-guides-spring-ai-openai-base-url&utm_content=sources)
