---
title: "Spring AI: OpenAI-Starter mit eigener base-url | BroadRouter"
description: "Den OpenAI-Chat-Starter von Spring AI per spring.ai.openai.base-url, BroadNet-Modell-ID und max-tokens auf BroadNet Inference richten und über ChatClient aufrufen."
url: https://broadrouter.com/de/guides/spring-ai-openai-base-url/
lang: de
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Mit KI-Unterstützung aus dem Englischen übersetzt. [Englisches Original lesen](https://broadrouter.com/guides/spring-ai-openai-base-url/) (aktualisiert am 2026-11-16).

# Spring AI mit BroadNet Inference nutzen (OpenAI base-url)

Aktualisiert 2026-11-16

Fügen Sie spring-ai-starter-model-openai hinzu und setzen Sie spring.ai.openai.base-url auf https://inference.broadnet.ai/v1, spring.ai.openai.api-key auf Ihren BroadNet-Schlüssel und spring.ai.openai.chat.model auf eine BroadNet-ID wie broadnet/glm-5.3. Setzen Sie spring.ai.openai.chat.max-tokens mit Platz für Reasoning. Spring AI 2.x nutzt das openai-java-SDK, das /chat/completions an die Base-URL anhängt.

Spring AI ist das Framework des Spring-Projekts für KI in Java. Sein OpenAI-Chat-Starter liest eine `base-url` und kann daher jeden OpenAI-kompatiblen Server aufrufen. BroadNet Inference stellt unter `https://inference.broadnet.ai/v1` Standard-Chat-Completions bereit. BroadRouter ist die Website von BroadNet; diese Anleitung folgt der Referenz von Spring AI 2.0.2.

## Starter hinzufügen

Mit eingebundener Spring-AI-BOM (siehe die Spring-AI-Dokumentation zum Dependency Management):

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

## Konfigurieren

`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'
```

Lassen Sie `/v1` in der URL. In Spring AI 2.x geht der Wert unverändert an den openai-java-Client (`OpenAiSetup.calculateBaseUrl` gibt ihn so zurück, wie er ist), und dieser Client hängt `/chat/completions` an. Der Standardwert, den er ersetzt, ist `https://api.openai.com/v1`.

## Aufrufen und testen

```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());
    };
}
```

Starten Sie die App. Wird eine Antwort ausgegeben, stimmen Schlüssel, URL und Modell-ID.

## Wichtige Einstellungen für BroadNet

-   **`max-tokens`, nicht `max-completion-tokens`.** Laut Spring-AI-Dokumentation schließen sich beide gegenseitig aus, und beide zu setzen ist ein Fehler. Die API-Referenz von BroadNet beschreibt `max_tokens`. DeepSeek V4.1 Flash, GLM 5.3 und Qwen3.8 27B denken zuerst nach, und das Reasoning zählt zum Limit.
-   **Reasoning-Text.** Spring AI kann `reasoning_content` von OpenAI-kompatiblen Servern bereitstellen, die ihn zurückgeben. Die API-Referenz von BroadNet meldet die Zahl der Reasoning-Tokens in `usage`, sichert den Reasoning-Text selbst aber nicht zu; verlassen Sie sich also nicht darauf.
-   **Override nur für den Chat.** `spring.ai.openai.chat.base-url` und `spring.ai.openai.chat.api-key` haben für das Chat-Modell Vorrang vor den gemeinsamen Properties. Nutzen Sie sie, wenn andere OpenAI-Modelle in Spring AI (etwa Embeddings) bei OpenAI bleiben sollen.
-   **Retries.** `spring.ai.retry.max-attempts` steht standardmäßig auf 10, mit exponentiellem Backoff. Bei einem Pay-as-you-go-Schlüssel kann das das Minutenlimit aufbrauchen; erwägen Sie, den Wert zu senken.

## Welches Modell passt?

| Einsatz | `spring.ai.openai.chat.model` |
| --- | --- |
| Tool Calling, strukturierte Ausgabe | `broadnet/glm-5.3` |
| Bilder oder arabischer Text | `broadnet/qwen3.8-27b` |
| Lange Dokumente, Flatrate-Plan | `broadnet/deepseek-v4.1-flash` |
| Kostenloses Startguthaben | `broadnet/gemma-4-26b-a4b` |

[Preise für alle Modelle](https://broadrouter.com/de/pricing/).

## Fehlerbehebung

-   **401.** Der Schlüssel ist falsch, abgelaufen oder sein Kontingent ist aufgebraucht, oder `BROADNET_API_KEY` ist für die JVM nicht gesetzt.
-   **404.** In der Base-URL fehlt `/v1`, oder die Modell-ID ist falsch. Kostenpflichtige Modelle brauchen eine Aufladung; das Guthaben von $5 deckt nur `broadnet/gemma-4-26b-a4b` und die beiden Transcribe-Modelle ab.
-   **Leeres `content()`.** Das Reasoning hat das Output-Budget verbraucht. Erhöhen Sie `max-tokens`. [Warum Antworten leer zurückkommen](https://broadrouter.com/de/guides/reasoning-tokens-empty-response/).
-   **400, wenn beide Token-Limits gesetzt sind.** Entfernen Sie `max-completion-tokens`.
-   **429.** Ein Pay-as-you-go-Schlüssel erlaubt 30 Anfragen pro Minute und 4 gleichzeitig laufende. Siehe [Fehlercodes und Retries](https://broadrouter.com/de/guides/errors-and-retries/).

## Begriffe in dieser Anleitung

[Pay-as-you-go](https://broadrouter.com/de/glossary/pay-as-you-go/)

Pay-as-you-go ist ein Preismodell, bei dem Sie nur für tatsächliche Nutzung zahlen, gemessen pro Einheit wie Tokens, Anfragen oder Audiominuten, ohne Abonnement oder Mindestabnahme. Die meisten LLM-APIs rechnen so ab, aus einem vorausbezahlten Guthaben oder per regelmäßiger Rechnung.

[Rate Limit (Ratenbegrenzung)](https://broadrouter.com/de/glossary/rate-limit/)

Ein Rate Limit ist eine Obergrenze, die eine API festlegt, wie stark ein Client sie in einem Zeitfenster nutzen darf, etwa Anfragen pro Minute oder Tokens pro Minute. Anfragen über dem Limit werden abgelehnt, meist mit HTTP 429 Too Many Requests, bis die Nutzung wieder darunter liegt.

[Tool Calling (Function Calling)](https://broadrouter.com/de/glossary/tool-calling/)

Tool Calling, auch Function Calling genannt, ist eine Funktion von LLM-APIs, bei der das Modell eine strukturierte Anfrage zurückgibt, eine vom Entwickler definierte Funktion mit JSON-Argumenten auszuführen. Die Anwendung führt die Funktion aus und sendet das Ergebnis zurück; das Modell selbst führt nie Code aus.

[Concurrency (Parallelität)](https://broadrouter.com/de/glossary/concurrency/)

Concurrency (Parallelität) ist die Zahl der Anfragen, die ein Client gleichzeitig offen hat. LLM-APIs begrenzen sie oft pro Schlüssel oder Plan, getrennt von den Anfragen pro Minute, weil jede offene Anfrage GPU-Kapazität belegt, bis ihre Antwort fertig ist.

[Embeddings](https://broadrouter.com/de/glossary/embeddings/)

Embeddings sind Listen von Gleitkommazahlen (Vektoren), die ein Modell erzeugt, um einen Text, ein Bild oder einen anderen Input darzustellen. Inputs mit ähnlicher Bedeutung erhalten nah beieinanderliegende Vektoren; über den Abstand lassen sich Suchergebnisse ranken, Dokumente clustern oder verwandte Elemente finden.

[Kontextfenster (Context Window)](https://broadrouter.com/de/glossary/context-window/)

Das Kontextfenster ist die maximale Anzahl an Tokens, mit der ein Sprachmodell in einer einzelnen Anfrage arbeiten kann. Es umfasst Prompt, Gesprächsverlauf, Tool-Definitionen, Bilder und den erzeugten Output einschließlich Reasoning-Tokens. Was nicht hineinpasst, muss gekürzt, zusammengefasst oder auf mehrere Anfragen verteilt werden.

[LLM-Flatrate (Flat-rate LLM plan)](https://broadrouter.com/de/glossary/flat-rate-llm-plan/)

Eine LLM-Flatrate ist ein Plan, der für den Zugang zu einer Sprachmodell-API einen Festpreis pro Zeitraum, etwa pro Monat, berechnet statt pro Token. Solche Pläne begrenzen meist etwas anderes, etwa Parallelität, Geschwindigkeit, Modelle oder Nutzungsfenster. Die Limits zählen also so viel wie der Preis.

[Prepaid-Guthaben (Prepaid Credit)](https://broadrouter.com/de/glossary/prepaid-credit/)

Prepaid-Guthaben ist Geld, das vor der Nutzung auf ein API-Konto eingezahlt wird. Jede Anfrage zieht ihre Kosten vom Guthaben ab, und wenn es aufgebraucht ist, stoppen abgerechnete Anfragen, bis Sie aufladen. So sind die Ausgaben auf das eingezahlte Geld begrenzt.

## Häufige Fragen

### Gehört /v1 in spring.ai.openai.base-url?

Ja. In Spring AI 2.x wird der Wert unverändert an den openai-java-Client übergeben, dessen eigener Standardwert https://api.openai.com/v1 ist. Nutzen Sie https://inference.broadnet.ai/v1.

### Sollte ich bei BroadNet max-tokens oder max-completion-tokens verwenden?

max-tokens. Laut Spring-AI-Dokumentation schließen sich beide gegenseitig aus. Die API-Referenz von BroadNet beschreibt das Feld max\_tokens, und Reasoning zählt dazu; erlauben Sie also 1.000 Tokens oder mehr.

### Funktioniert Tool Calling von Spring AI mit BroadNet?

Nutzen Sie GLM 5.3 oder Qwen3.8 27B, die BroadNet mit Tools führt. Für DeepSeek V4.1 Flash nennt die BroadNet-Dokumentation kein Tool Calling.

### Kann ich OpenAI für Embeddings behalten und BroadNet für den Chat nutzen?

Ja. spring.ai.openai.chat.base-url und spring.ai.openai.chat.api-key überschreiben die gemeinsamen Properties nur für das Chat-Modell. Die API-Referenz von BroadNet führt keinen Embeddings-Endpunkt auf.

## Verwandte Anleitungen

-   [BroadNet Inference aus Go mit dem openai-go SDK aufrufen](https://broadrouter.com/de/guides/openai-go-sdk/)
-   [OpenAI Python SDK mit BroadNet Inference nutzen](https://broadrouter.com/de/guides/openai-python-sdk/)
-   [Warum ein Reasoning-Modell eine leere Antwort liefert](https://broadrouter.com/de/guides/reasoning-tokens-empty-response/)
-   [Fehlercodes von BroadNet Inference: Wann ist ein Retry sinnvoll?](https://broadrouter.com/de/guides/errors-and-retries/)
-   [Alle Tools, die mit BroadNet Inference funktionieren (auf Englisch)](https://broadrouter.com/integrations/): SDKs, Coding-Agenten, Chat-Oberflächen und Automatisierungstools, jeweils mit den genauen Einstellungen

Testen Sie es mit Ihrem echten Workload. Neue Konten starten mit USD 5 Guthaben für Gemma und Transkription. DeepSeek, GLM und Qwen3.8 erfordern eine Aufladung.

[Loslegen](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=de-guides-spring-ai-openai-base-url&utm_content=page-cta) ·

**Quellen**

-   [Spring-AI-Referenz, OpenAI Chat (2.0.2) (geprüft am 2026-11-15)](https://docs.spring.io/spring-ai/reference/api/chat/openai-chat.html)
-   [Spring-AI-Quellcode bei v2.0.2, OpenAiSetup.calculateBaseUrl (geprüft am 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-Referenz von BroadNet Inference (geprüft am 2026-11-15) (auf Englisch)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=de-guides-spring-ai-openai-base-url&utm_content=sources)
