---
title: "Spring AI OpenAI starter na may custom base-url | BroadRouter"
description: "Ituro ang OpenAI chat starter ng Spring AI sa BroadNet Inference gamit ang spring.ai.openai.base-url, BroadNet model ID at max-tokens, at tawagin mula sa ChatClient."
url: https://broadrouter.com/fil/guides/spring-ai-openai-base-url/
lang: fil
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Isinalin mula sa Ingles sa tulong ng AI. [Basahin ang orihinal sa Ingles](https://broadrouter.com/guides/spring-ai-openai-base-url/) (na-update noong 2026-11-16).

# Spring AI sa BroadNet Inference (OpenAI base-url)

Na-update 2026-11-16

Idagdag ang spring-ai-starter-model-openai, saka i-set ang spring.ai.openai.base-url sa https://inference.broadnet.ai/v1, ang spring.ai.openai.api-key sa BroadNet key mo at ang spring.ai.openai.chat.model sa BroadNet ID gaya ng broadnet/glm-5.3. I-set ang spring.ai.openai.chat.max-tokens nang may espasyo para sa reasoning. Sa Spring AI 2.x, openai-java SDK ang gamit, na nagdadagdag ng /chat/completions sa base URL.

Ang Spring AI ay framework ng Spring project para sa AI sa Java. Nagbabasa ng `base-url` ang OpenAI chat starter nito, kaya kaya nitong tumawag sa kahit anong OpenAI-compatible na server. Karaniwang chat completions ang sine-serve ng BroadNet Inference sa `https://inference.broadnet.ai/v1`. Ang BroadRouter ay sariling site ng BroadNet; sinusundan ng gabay na ito ang Spring AI 2.0.2 reference.

## Idagdag ang starter

Kapag nakalagay na ang Spring AI BOM (tingnan ang docs ng Spring AI tungkol sa dependency management):

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

## I-configure

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

Panatilihin ang `/v1` sa URL. Sa Spring AI 2.x, ipinapasa ang value sa openai-java client nang walang pagbabago (ibinabalik ito ng `OpenAiSetup.calculateBaseUrl` nang ganoon din), at ang client na iyon ang nagdadagdag ng `/chat/completions`. Ang default na pinapalitan nito ay `https://api.openai.com/v1`.

## Tawagin at i-test

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

Simulan ang app. Kapag may na-print na sagot, tama ang key, URL at model ID.

## Mga setting na mahalaga para sa BroadNet

-   **`max-tokens`, hindi `max-completion-tokens`.** Sabi ng docs ng Spring AI, hindi puwedeng sabay ang dalawa at error kapag pareho mong na-set. Ang `max_tokens` ang inilalarawan ng API reference ng BroadNet. Nagre-reason muna ang DeepSeek V4.1 Flash, GLM 5.3 at Qwen3.8 27B, at kasama ang reasoning sa limit.
-   **Reasoning text.** Kayang ilabas ng Spring AI ang `reasoning_content` mula sa mga OpenAI-compatible na server na nagbabalik nito. Iniuulat ng API reference ng BroadNet ang bilang ng reasoning tokens sa `usage` pero hindi nito ipinapangako ang mismong reasoning text, kaya huwag umasa rito.
-   **Override para sa chat lang.** Mas inuuna ang `spring.ai.openai.chat.base-url` at `spring.ai.openai.chat.api-key` kaysa sa mga shared property para sa chat model. Gamitin ang mga ito kung kailangang manatili sa OpenAI ang ibang Spring AI OpenAI model (gaya ng embeddings).
-   **Retries.** 10 ang default ng `spring.ai.retry.max-attempts`, na may exponential backoff. Sa isang pay-as-you-go key, puwede nitong ubusin ang per-minute na limit; pag-isipang babaan ito.

## Aling model ang pipiliin

| Gamit | `spring.ai.openai.chat.model` |
| --- | --- |
| Tool calling, structured output | `broadnet/glm-5.3` |
| Mga larawan o Arabic na text | `broadnet/qwen3.8-27b` |
| Mahahabang dokumento, flat-rate na plan | `broadnet/deepseek-v4.1-flash` |
| Libreng panimulang credit | `broadnet/gemma-4-26b-a4b` |

[Presyo ng bawat model](https://broadrouter.com/fil/pricing/).

## Troubleshooting

-   **401.** Mali, expired o naubusan ng allowance ang key, o hindi naka-set ang `BROADNET_API_KEY` para sa JVM.
-   **404.** Walang `/v1` ang base URL, o mali ang model ID. Kailangan ng top-up ang mga bayad na model; ang `broadnet/gemma-4-26b-a4b` at ang dalawang Transcribe model lang ang sakop ng $5 na credit.
-   **Walang lamang `content()`.** Naubos ng reasoning ang output budget. Taasan ang `max-tokens`. [Bakit walang laman ang mga sagot](https://broadrouter.com/fil/guides/reasoning-tokens-empty-response/).
-   **400 kapag naka-set ang parehong token limit.** Alisin ang `max-completion-tokens`.
-   **429.** Ang isang pay-as-you-go key ay may 30 request kada minuto at 4 na sabay na tumatakbo. Tingnan ang [errors and retries](https://broadrouter.com/fil/guides/errors-and-retries/).

## Mga termino sa gabay na ito

[API key](https://broadrouter.com/fil/glossary/api-key/)

Ang API key ay isang lihim na string na kumikilala at nagpapahintulot sa client na tumatawag sa isang API. Kadalasang hinihingi ito ng mga LLM API sa Authorization: Bearer header, at ang sinumang may hawak ng key ay makakagawa ng mga request na sisingilin sa account na may-ari nito.

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

Ang pay-as-you-go ay paraan ng pagpepresyo kung saan ang nagamit mo lang ang binabayaran mo, sinusukat kada yunit gaya ng token, request o minuto ng audio, nang walang subscription o minimum na commitment. Ganito naniningil ang karamihan ng LLM API, mula sa prepaid na balance o sa pana-panahong invoice.

[Token](https://broadrouter.com/fil/glossary/token/)

Ang token ay ang yunit ng text na binabasa at isinusulat ng isang language model: isang salita, bahagi ng salita, bantas o byte sequence na ginawa ng tokenizer ng model. Sa token binibilang, nililimitahan at kadalasang sinisingil ng mga LLM API ang paggamit.

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

Ang embeddings ay mga listahan ng floating-point na numero (vector) na binubuo ng isang model para kumatawan sa isang piraso ng text, larawan o ibang input. Magkakalapit ang vector ng mga input na magkatulad ang kahulugan, kaya magagamit ang layo ng mga vector para i-rank ang search results, i-cluster ang mga dokumento o hanapin ang magkakaugnay na item.

[Reasoning tokens](https://broadrouter.com/fil/glossary/reasoning-tokens/)

Ang reasoning tokens ay mga token na binubuo ng isang reasoning model para pag-isipan ang isang problema bago nito isulat ang nakikitang sagot. Kadalasang sinisingil ang mga ito bilang output token, binibilang sa output limit at sa context window, at puwedeng itago o ibuod ng API.

[Tool calling (function calling)](https://broadrouter.com/fil/glossary/tool-calling/)

Ang tool calling, tinatawag ding function calling, ay feature ng LLM API kung saan nagbabalik ang model ng structured na request para magpatakbo ng function na tinukoy ng developer, kasama ang JSON arguments. Ang application ang nagpapatakbo ng function at nagpapadala pabalik ng resulta; hindi kailanman nagpapatakbo ng code ang model mismo.

[Base URL](https://broadrouter.com/fil/glossary/base-url/)

Ang base URL ay ang fixed na root address ng isang API, gaya ng https://api.example.com/v1, na idinudugtong ng client sa unahan ng bawat endpoint path, gaya ng /chat/completions. Sa mga OpenAI-compatible SDK, kapag pinalitan ang base URL, kasama ang API key at model ID, sa ibang provider na tatawag ang parehong code.

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

Ang Chat Completions API ay HTTP endpoint ng OpenAI, POST /v1/chat/completions, na tumatanggap ng pangalan ng model at listahan ng mga message na may role, at ibinabalik ang susunod na message ng model. Ang hugis ng request at response nito ang naging karaniwang format na ginagamit din ng mga OpenAI-compatible na provider at SDK.

## Mga tanong

### Dapat bang may /v1 ang spring.ai.openai.base-url?

Oo. Sa Spring AI 2.x, ipinapasa ang value nang walang pagbabago sa openai-java client, na https://api.openai.com/v1 ang sariling default. Gamitin ang https://inference.broadnet.ai/v1.

### max-tokens ba o max-completion-tokens ang gagamitin ko sa BroadNet?

max-tokens. Sabi ng docs ng Spring AI, hindi puwedeng sabay ang dalawa. Ang max\_tokens field ang inilalarawan ng API reference ng BroadNet, at kasama rito ang reasoning, kaya maglaan ng 1,000 token o higit pa.

### Gumagana ba ang tool calling ng Spring AI sa BroadNet?

Gamitin ang GLM 5.3 o Qwen3.8 27B, na nakalista sa BroadNet na may tools. Walang nakalistang tool calling para sa DeepSeek V4.1 Flash sa docs ng BroadNet.

### Puwede ko bang panatilihin ang OpenAI para sa embeddings at gamitin ang BroadNet para sa chat?

Oo. Ino-override ng spring.ai.openai.chat.base-url at spring.ai.openai.chat.api-key ang mga shared property para sa chat model lang. Walang nakalistang embeddings endpoint sa API reference ng BroadNet.

## Mga kaugnay na gabay

-   [Tawagin ang BroadNet Inference mula sa Go gamit ang openai-go SDK](https://broadrouter.com/fil/guides/openai-go-sdk/)
-   [Paano gamitin ang OpenAI Python SDK sa BroadNet Inference](https://broadrouter.com/fil/guides/openai-python-sdk/)
-   [Bakit walang laman ang sagot ng isang reasoning model](https://broadrouter.com/fil/guides/reasoning-tokens-empty-response/)
-   [Mga error code ng BroadNet Inference at kailan dapat mag-retry](https://broadrouter.com/fil/guides/errors-and-retries/)
-   [Lahat ng tool na gumagana sa BroadNet Inference (Ingles)](https://broadrouter.com/integrations/): mga SDK, coding agent, chat UI at automation tool, kasama ang eksaktong setting ng bawat isa

Subukan ito sa totoong workload mo. May US$5 na panimulang credit ang mga bagong account para sa Gemma at transcription. Kailangan ng top-up para sa DeepSeek, GLM, at Qwen3.8.

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

**Mga source**

-   [Spring AI reference, OpenAI Chat (2.0.2) (sinuri noong 2026-11-15)](https://docs.spring.io/spring-ai/reference/api/chat/openai-chat.html)
-   [Source ng Spring AI sa v2.0.2, OpenAiSetup.calculateBaseUrl (sinuri noong 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 reference ng BroadNet Inference (sinuri noong 2026-11-15) (Ingles)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fil-guides-spring-ai-openai-base-url&utm_content=sources)
