---
title: "Starter OpenAI Spring AI dengan base-url tersuai | BroadRouter"
description: "Halakan starter chat OpenAI Spring AI ke BroadNet Inference dengan spring.ai.openai.base-url, ID model BroadNet dan max-tokens, kemudian panggil dari ChatClient."
url: https://broadrouter.com/ms/guides/spring-ai-openai-base-url/
lang: ms
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Diterjemahkan daripada bahasa Inggeris dengan bantuan AI. [Baca versi asal dalam bahasa Inggeris](https://broadrouter.com/guides/spring-ai-openai-base-url/) (dikemas kini 2026-11-16).

# Guna Spring AI dengan BroadNet Inference (OpenAI base-url)

Dikemas kini 2026-11-16

Tambah spring-ai-starter-model-openai, kemudian tetapkan spring.ai.openai.base-url kepada https://inference.broadnet.ai/v1, spring.ai.openai.api-key kepada kunci BroadNet anda dan spring.ai.openai.chat.model kepada ID BroadNet seperti broadnet/glm-5.3. Tetapkan spring.ai.openai.chat.max-tokens dengan ruang untuk penaakulan. Spring AI 2.x menggunakan SDK openai-java, yang menambah /chat/completions pada base URL.

Spring AI ialah rangka kerja projek Spring untuk AI dalam Java. Starter chat OpenAInya membaca `base-url`, jadi ia boleh memanggil mana-mana pelayan serasi OpenAI. BroadNet Inference menyediakan chat completions standard di `https://inference.broadnet.ai/v1`. BroadRouter ialah laman web BroadNet sendiri; panduan ini mengikut rujukan Spring AI 2.0.2.

## Tambah starter

Dengan Spring AI BOM sudah disediakan (lihat dokumentasi pengurusan kebergantungan Spring AI):

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

## Konfigurasi

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

Kekalkan `/v1` dalam URL. Dalam Spring AI 2.x, nilai itu dihantar kepada klien openai-java tanpa diubah (`OpenAiSetup.calculateBaseUrl` memulangkannya seadanya), dan klien itu menambah `/chat/completions`. Nilai lalai yang digantikannya ialah `https://api.openai.com/v1`.

## Panggil dan uji

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

Mulakan aplikasi. Jawapan yang dicetak bermakna kunci, URL dan ID model adalah betul.

## Tetapan yang penting untuk BroadNet

-   **`max-tokens`, bukan `max-completion-tokens`.** Dokumentasi Spring AI menyatakan kedua-duanya tidak boleh digunakan bersama dan menetapkan kedua-duanya ialah ralat. Rujukan API BroadNet menerangkan `max_tokens`. DeepSeek V4.1 Flash, GLM 5.3 dan Qwen3.8 27B membuat penaakulan dahulu, dan penaakulan dikira dalam had itu.
-   **Teks penaakulan.** Spring AI boleh mendedahkan `reasoning_content` daripada pelayan serasi OpenAI yang memulangkannya. Rujukan API BroadNet melaporkan bilangan token penaakulan dalam `usage` tetapi tidak menjanjikan teks penaakulan itu sendiri, jadi jangan bergantung padanya.
-   **Override untuk chat sahaja.** `spring.ai.openai.chat.base-url` dan `spring.ai.openai.chat.api-key` diutamakan berbanding sifat kongsi untuk model chat. Gunakannya jika model Spring AI OpenAI yang lain (seperti embeddings) perlu kekal pada OpenAI.
-   **Cuba semula.** `spring.ai.retry.max-attempts` bernilai lalai 10 dengan backoff eksponen. Pada kunci bayar ikut guna, ini boleh menghabiskan had seminit; pertimbangkan untuk merendahkannya.

## Model mana yang patut dipilih

| Kegunaan | `spring.ai.openai.chat.model` |
| --- | --- |
| Tool calling, output berstruktur | `broadnet/glm-5.3` |
| Imej atau teks bahasa Arab | `broadnet/qwen3.8-27b` |
| Dokumen panjang, pelan kadar tetap | `broadnet/deepseek-v4.1-flash` |
| Kredit permulaan percuma | `broadnet/gemma-4-26b-a4b` |

[Harga setiap model](https://broadrouter.com/ms/pricing/).

## Penyelesaian masalah

-   **401.** Kunci salah, tamat tempoh atau kehabisan elaun, atau `BROADNET_API_KEY` tidak ditetapkan untuk JVM.
-   **404.** Base URL tiada `/v1`, atau ID model salah. Model berbayar memerlukan tambah nilai; kredit $5 hanya meliputi `broadnet/gemma-4-26b-a4b` dan dua model Transcribe.
-   **`content()` kosong.** Penaakulan menghabiskan bajet output. Naikkan `max-tokens`. [Mengapa jawapan kosong](https://broadrouter.com/ms/guides/reasoning-tokens-empty-response/).
-   **400 apabila kedua-dua had token ditetapkan.** Buang `max-completion-tokens`.
-   **429.** Kunci bayar ikut guna membenarkan 30 permintaan seminit dan 4 serentak. Lihat [ralat dan cuba semula](https://broadrouter.com/ms/guides/errors-and-retries/).

## Istilah dalam panduan ini

[Bayar ikut guna (pay-as-you-go)](https://broadrouter.com/ms/glossary/pay-as-you-go/)

Bayar ikut guna ialah model harga di mana anda hanya membayar apa yang anda guna, dimeter mengikut unit seperti token, permintaan atau minit audio, tanpa langganan atau komitmen minimum. Kebanyakan API LLM mengebil dengan cara ini, daripada baki prabayar atau invois berkala.

[Embedding (vektor teks)](https://broadrouter.com/ms/glossary/embeddings/)

Embedding ialah senarai nombor titik terapung (vektor) yang dihasilkan oleh model untuk mewakili sekeping teks, imej atau input lain. Input yang maknanya serupa mendapat vektor yang berdekatan, jadi jarak antara vektor boleh digunakan untuk menyusun hasil carian, mengelompokkan dokumen atau mencari item berkaitan.

[Keserentakan (concurrency)](https://broadrouter.com/ms/glossary/concurrency/)

Keserentakan ialah bilangan permintaan yang sedang berjalan serentak daripada satu klien. API LLM sering mengehadkannya bagi setiap kunci atau pelan, berasingan daripada permintaan seminit, kerana setiap permintaan yang terbuka memegang kapasiti GPU sehingga responsnya selesai.

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

Token ialah unit teks yang dibaca dan ditulis oleh model bahasa: satu perkataan, sebahagian perkataan, tanda baca atau jujukan bait yang dihasilkan oleh tokenizer model itu. API LLM mengira, mengehadkan dan biasanya mengebil penggunaan dalam token.

[Tool calling (panggilan alatan)](https://broadrouter.com/ms/glossary/tool-calling/)

Tool calling, juga dipanggil function calling, ialah ciri API LLM di mana model memulangkan permintaan berstruktur untuk menjalankan fungsi yang ditakrifkan oleh pembangun, bersama argumen JSON. Aplikasi menjalankan fungsi itu dan menghantar hasilnya kembali; model sendiri tidak pernah menjalankan kod.

[Backoff eksponen (exponential backoff)](https://broadrouter.com/ms/glossary/exponential-backoff/)

Backoff eksponen ialah strategi cuba semula di mana klien menunggu lebih lama selepas setiap percubaan yang gagal, biasanya menggandakan kelewatan sehingga had tertentu, sebelum mencuba lagi. Menambah jitter rawak pada setiap penantian menyebarkan cubaan semula daripada banyak klien supaya mereka tidak mengenai pelayan pada saat yang sama.

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

Base URL ialah alamat akar tetap sesuatu API, seperti https://api.example.com/v1, yang diletakkan oleh klien di hadapan setiap laluan endpoint, seperti /chat/completions. Dalam SDK serasi OpenAI, menukar base URL, bersama kunci API dan ID model, menghalakan kod yang sama kepada penyedia lain.

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

Chat Completions API ialah endpoint HTTP OpenAI, POST /v1/chat/completions, yang menerima nama model dan senarai mesej bertanda peranan, lalu memulangkan mesej seterusnya daripada model. Bentuk permintaan dan responsnya menjadi format biasa yang digunakan semula oleh penyedia dan SDK yang serasi OpenAI.

## Soalan lazim

### Patutkah spring.ai.openai.base-url termasuk /v1?

Ya. Dalam Spring AI 2.x, nilai itu dihantar tanpa diubah kepada klien openai-java, yang nilai lalainya sendiri ialah https://api.openai.com/v1. Gunakan https://inference.broadnet.ai/v1.

### Patutkah saya guna max-tokens atau max-completion-tokens dengan BroadNet?

max-tokens. Dokumentasi Spring AI menyatakan kedua-duanya tidak boleh digunakan bersama. Rujukan API BroadNet menerangkan medan max\_tokens, dan penaakulan dikira di dalamnya, jadi peruntukkan 1,000 token atau lebih.

### Adakah tool calling Spring AI berfungsi dengan BroadNet?

Gunakan GLM 5.3 atau Qwen3.8 27B, yang disenaraikan BroadNet dengan tools. Dokumentasi BroadNet tidak menyenaraikan tool calling untuk DeepSeek V4.1 Flash.

### Bolehkah saya kekalkan OpenAI untuk embeddings dan guna BroadNet untuk chat?

Boleh. spring.ai.openai.chat.base-url dan spring.ai.openai.chat.api-key mengatasi sifat kongsi untuk model chat sahaja. Rujukan API BroadNet tidak menyenaraikan endpoint embeddings.

## Panduan berkaitan

-   [Panggil BroadNet Inference daripada Go dengan SDK openai-go](https://broadrouter.com/ms/guides/openai-go-sdk/)
-   [Cara guna OpenAI Python SDK dengan BroadNet Inference](https://broadrouter.com/ms/guides/openai-python-sdk/)
-   [Mengapa model penaakulan memulangkan jawapan kosong](https://broadrouter.com/ms/guides/reasoning-tokens-empty-response/)
-   [Kod ralat BroadNet Inference dan bila perlu cuba semula](https://broadrouter.com/ms/guides/errors-and-retries/)
-   [Semua alat yang berfungsi dengan BroadNet Inference (Bahasa Inggeris)](https://broadrouter.com/integrations/): SDK, ejen pengekodan, antara muka sembang dan alat automasi, dengan tetapan tepat bagi setiap satu

Cuba dengan beban kerja sebenar anda. Akaun baharu bermula dengan kredit US$5 untuk Gemma dan transkripsi. DeepSeek, GLM dan Qwen3.8 memerlukan tambah nilai.

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

**Sumber**

-   [Rujukan Spring AI, OpenAI Chat (2.0.2) (disemak 2026-11-15)](https://docs.spring.io/spring-ai/reference/api/chat/openai-chat.html)
-   [Kod sumber Spring AI pada v2.0.2, OpenAiSetup.calculateBaseUrl (disemak 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)
-   [Rujukan API BroadNet Inference (disemak 2026-11-15) (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-guides-spring-ai-openai-base-url&utm_content=sources)
