---
title: "Spring AI: стартер OpenAI со своим base-url | BroadRouter"
description: "Как направить чат-стартер OpenAI из Spring AI на BroadNet Inference через spring.ai.openai.base-url, ID модели BroadNet и max-tokens и вызвать его из ChatClient."
url: https://broadrouter.com/ru/guides/spring-ai-openai-base-url/
lang: ru
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.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 — ID BroadNet, например broadnet/glm-5.3. spring.ai.openai.chat.max-tokens задайте с запасом на рассуждения. Spring AI 2.x использует SDK openai-java, который добавляет к базовому URL /chat/completions.

Spring AI — фреймворк проекта Spring для работы с ИИ на Java. Его чат-стартер OpenAI читает `base-url`, поэтому может обращаться к любому OpenAI-совместимому серверу. BroadNet Inference отдаёт стандартные chat completions по адресу `https://inference.broadnet.ai/v1`. BroadRouter — собственный сайт BroadNet; руководство опирается на справочник Spring AI 2.0.2.

## Добавьте стартер

Когда BOM Spring AI уже подключён (см. документацию 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'
```

Сохраняйте `/v1` в URL. В 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 говорит, что они взаимоисключающие и указывать оба — ошибка. Справочник API BroadNet описывает `max_tokens`. DeepSeek V4.1 Flash, GLM 5.3 и Qwen3.8 27B сначала рассуждают, и рассуждения учитываются в лимите.
-   **Текст рассуждений.** Spring AI умеет отдавать `reasoning_content` от OpenAI-совместимых серверов, которые его возвращают. Справочник API BroadNet сообщает число токенов рассуждений в `usage`, но сам текст рассуждений не обещает, так что не полагайтесь на него.
-   **Переопределение только для чата.** `spring.ai.openai.chat.base-url` и `spring.ai.openai.chat.api-key` имеют приоритет над общими свойствами для чат-модели. Используйте их, если другие модели OpenAI в Spring AI (например, эмбеддинги) должны остаться на 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/ru/pricing/).

## Решение проблем

-   **401.** Ключ неверен, истёк или на нём закончился лимит, либо `BROADNET_API_KEY` не задан для JVM.
-   **404.** В базовом URL нет `/v1` или ID модели указан неверно. Для платных моделей нужно пополнить баланс; грант $5 покрывает только `broadnet/gemma-4-26b-a4b`.
-   **Пустой `content()`.** Рассуждения израсходовали бюджет на выход. Увеличьте `max-tokens`. [Почему ответы приходят пустыми](https://broadrouter.com/ru/guides/reasoning-tokens-empty-response/).
-   **400, когда заданы оба лимита токенов.** Уберите `max-completion-tokens`.
-   **429.** Ключ с оплатой по факту допускает 30 запросов в минуту и 4 одновременно выполняемых. См. [ошибки и повторные запросы](https://broadrouter.com/ru/guides/errors-and-retries/).

## Термины в этом руководстве

[Лимит запросов (rate limit)](https://broadrouter.com/ru/glossary/rate-limit/)

Лимит запросов (rate limit) — это ограничение, которое API накладывает на объём использования клиентом за отрезок времени, например число запросов или токенов в минуту. Запросы сверх лимита отклоняются, обычно с HTTP 429 Too Many Requests, пока использование снова не опустится ниже порога.

[Оплата по факту (pay-as-you-go)](https://broadrouter.com/ru/glossary/pay-as-you-go/)

Оплата по факту (pay-as-you-go) — это модель ценообразования, при которой вы платите только за то, что использовали, по счётчику в единицах вроде токенов, запросов или минут аудио, без подписки и минимальных обязательств. Так тарифицирует большинство LLM API — с предоплаченного баланса или по периодическому счёту.

[Параллельность (concurrency)](https://broadrouter.com/ru/glossary/concurrency/)

Параллельность (concurrency) — это число запросов, которые клиент одновременно держит в работе. LLM API часто ограничивают её на ключ или тариф отдельно от лимита запросов в минуту, потому что каждый открытый запрос занимает мощности GPU, пока ответ не будет готов.

[Безлимитный тариф LLM (flat-rate LLM plan)](https://broadrouter.com/ru/glossary/flat-rate-llm-plan/)

Безлимитный тариф LLM, или тариф с фиксированной ценой, — это доступ к API языковой модели за фиксированную плату за период, например месяц, вместо оплаты за токены. Обычно такие тарифы ограничивают что-то другое — параллельность, скорость, набор моделей или окна использования, поэтому ограничения важны не меньше цены.

[Вызов инструментов (tool calling)](https://broadrouter.com/ru/glossary/tool-calling/)

Вызов инструментов (function calling) — это функция LLM API, при которой модель возвращает структурированный запрос на выполнение функции, заданной разработчиком, с аргументами в JSON. Приложение выполняет функцию и отправляет результат обратно; сама модель код никогда не выполняет.

[Chat Completions API](https://broadrouter.com/ru/glossary/chat-completions-api/)

Chat Completions API — это HTTP-эндпоинт OpenAI, POST /v1/chat/completions, который принимает имя модели и список сообщений с ролями и возвращает следующее сообщение модели. Формат его запроса и ответа стал общим стандартом, который повторяют OpenAI-совместимые провайдеры и SDK.

## Вопросы и ответы

### Нужно ли включать /v1 в spring.ai.openai.base-url?

Да. В 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 говорит, что эти параметры взаимоисключающие. Справочник API BroadNet описывает поле max\_tokens, и рассуждения учитываются в нём, поэтому оставьте 1000 токенов или больше.

### Работает ли вызов инструментов Spring AI с BroadNet?

Используйте GLM 5.3 или Qwen3.8 27B: для них BroadNet указывает инструменты. Для DeepSeek V4.1 Flash документация BroadNet вызов инструментов не указывает.

### Можно ли оставить OpenAI для эмбеддингов, а для чата использовать BroadNet?

Да. spring.ai.openai.chat.base-url и spring.ai.openai.chat.api-key переопределяют общие свойства только для чат-модели. Эндпоинта для эмбеддингов в справочнике API BroadNet нет.

## Похожие руководства

-   [BroadNet Inference из Go: SDK openai-go](https://broadrouter.com/ru/guides/openai-go-sdk/)
-   [OpenAI Python SDK и BroadNet Inference](https://broadrouter.com/ru/guides/openai-python-sdk/)
-   [Почему рассуждающая модель возвращает пустой ответ](https://broadrouter.com/ru/guides/reasoning-tokens-empty-response/)
-   [Коды ошибок BroadNet Inference и когда повторять запрос](https://broadrouter.com/ru/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=ru-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)
-   [Справочник API BroadNet Inference (дата обращения 2026-11-15) (на английском)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-guides-spring-ai-openai-base-url&utm_content=sources)
