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

Diterjemahkan dari bahasa Inggris dengan bantuan AI. [Baca versi asli bahasa Inggris](https://broadrouter.com/guides/spring-ai-openai-base-url/) (diperbarui 2026-11-16).

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

Diperbarui 2026-11-16

Tambahkan spring-ai-starter-model-openai, lalu atur spring.ai.openai.base-url ke https://inference.broadnet.ai/v1, spring.ai.openai.api-key ke kunci BroadNet Anda, dan spring.ai.openai.chat.model ke ID BroadNet seperti broadnet/glm-5.3. Atur spring.ai.openai.chat.max-tokens dengan ruang untuk penalaran. Spring AI 2.x memakai SDK openai-java, yang menambahkan /chat/completions ke base URL.

Spring AI adalah framework dari proyek Spring untuk AI di Java. Starter chat OpenAI-nya membaca `base-url`, jadi bisa memanggil server apa pun yang kompatibel dengan OpenAI. BroadNet Inference melayani chat completions standar di `https://inference.broadnet.ai/v1`. BroadRouter adalah situs milik BroadNet sendiri; panduan ini mengikuti referensi Spring AI 2.0.2.

## Tambahkan starter

Dengan Spring AI BOM sudah terpasang (lihat dokumentasi dependency management 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'
```

Pertahankan `/v1` di URL. Di Spring AI 2.x nilainya diteruskan ke klien openai-java tanpa diubah (`OpenAiSetup.calculateBaseUrl` mengembalikannya apa adanya), dan klien itulah yang menambahkan `/chat/completions`. Nilai default yang digantikannya adalah `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());
    };
}
```

Jalankan aplikasinya. Jika sebuah jawaban tercetak, berarti kunci, URL, dan ID model sudah benar.

## Pengaturan yang penting untuk BroadNet

-   **`max-tokens`, bukan `max-completion-tokens`.** Dokumentasi Spring AI menyebut keduanya saling eksklusif dan mengatur keduanya akan menghasilkan error. Referensi API BroadNet menjelaskan `max_tokens`. DeepSeek V4.1 Flash, GLM 5.3, dan Qwen3.8 27B bernalar lebih dulu, dan penalaran ikut dihitung dalam batas itu.
-   **Teks penalaran.** Spring AI bisa menampilkan `reasoning_content` dari server kompatibel OpenAI yang mengembalikannya. Referensi API BroadNet melaporkan jumlah token reasoning di `usage` tetapi tidak menjanjikan teks penalarannya sendiri, jadi jangan mengandalkannya.
-   **Override khusus chat.** `spring.ai.openai.chat.base-url` dan `spring.ai.openai.chat.api-key` lebih diutamakan daripada properti bersama untuk model chat. Pakai ini jika model OpenAI lain di Spring AI (seperti embedding) harus tetap di OpenAI.
-   **Retry.** `spring.ai.retry.max-attempts` default-nya 10 dengan exponential backoff. Pada kunci bayar sesuai pemakaian, ini bisa cepat menghabiskan batas per menit; pertimbangkan untuk menurunkannya.

## Model mana yang dipilih

| Kegunaan | `spring.ai.openai.chat.model` |
| --- | --- |
| Tool calling, output terstruktur | `broadnet/glm-5.3` |
| Gambar atau teks Arab | `broadnet/qwen3.8-27b` |
| Dokumen panjang, paket tarif tetap | `broadnet/deepseek-v4.1-flash` |
| Kredit awal gratis | `broadnet/gemma-4-26b-a4b` |

[Harga semua model](https://broadrouter.com/id/pricing/).

## Pemecahan masalah

-   **401.** Kuncinya salah, kedaluwarsa, atau kuotanya habis, atau `BROADNET_API_KEY` belum diatur untuk JVM.
-   **404.** Base URL tidak memuat `/v1`, atau ID model salah. Model berbayar memerlukan top up; kredit $5 hanya mencakup `broadnet/gemma-4-26b-a4b`.
-   **`content()` kosong.** Penalaran menghabiskan anggaran output. Naikkan `max-tokens`. [Kenapa jawaban kembali kosong](https://broadrouter.com/id/guides/reasoning-tokens-empty-response/).
-   **400 saat kedua batas token diatur.** Hapus `max-completion-tokens`.
-   **429.** Kunci bayar sesuai pemakaian mengizinkan 30 permintaan per menit dan 4 yang berjalan bersamaan. Lihat [error dan retry](https://broadrouter.com/id/guides/errors-and-retries/).

## Istilah dalam panduan ini

[Bayar sesuai pemakaian (pay-as-you-go)](https://broadrouter.com/id/glossary/pay-as-you-go/)

Bayar sesuai pemakaian (pay-as-you-go) adalah model harga di mana Anda hanya membayar yang Anda pakai, dihitung per satuan seperti token, permintaan, atau menit audio, tanpa langganan atau komitmen minimum. Sebagian besar API LLM menagih dengan cara ini, dari saldo prabayar atau tagihan berkala.

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

Base URL adalah alamat root tetap sebuah API, seperti https://api.example.com/v1, yang ditempatkan client di depan setiap path endpoint, seperti /chat/completions. Di SDK yang kompatibel dengan OpenAI, mengganti base URL bersama kunci API dan ID model akan mengarahkan kode yang sama ke penyedia lain.

[Exponential backoff](https://broadrouter.com/id/glossary/exponential-backoff/)

Exponential backoff adalah strategi percobaan ulang di mana client menunggu makin lama setelah setiap percobaan yang gagal, biasanya menggandakan jedanya sampai batas tertentu, sebelum mencoba lagi. Menambahkan jitter acak pada setiap jeda menyebarkan percobaan ulang dari banyak client agar tidak menghantam server pada saat yang sama.

[Konkurensi (concurrency)](https://broadrouter.com/id/glossary/concurrency/)

Konkurensi (concurrency) adalah jumlah permintaan yang sedang berjalan dari sebuah client pada saat yang sama. API LLM sering membatasinya per kunci atau per paket, terpisah dari batas permintaan per menit, karena setiap permintaan yang terbuka menahan kapasitas GPU sampai responsnya selesai.

[Rate limit (batas laju)](https://broadrouter.com/id/glossary/rate-limit/)

Rate limit adalah batas yang diterapkan API pada seberapa banyak client boleh memakainya dalam rentang waktu tertentu, misalnya permintaan per menit atau token per menit. Permintaan yang melebihi batas ditolak, biasanya dengan HTTP 429 Too Many Requests, sampai pemakaian kembali di bawah batas.

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

Token adalah satuan teks yang dibaca dan ditulis model bahasa: sebuah kata, bagian kata, tanda baca, atau urutan byte yang dihasilkan tokenizer model. API LLM menghitung, membatasi, dan biasanya menagih pemakaian dalam token.

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

Tool calling, disebut juga function calling, adalah fitur API LLM di mana model mengembalikan permintaan terstruktur untuk menjalankan fungsi yang didefinisikan developer, lengkap dengan argumen JSON. Aplikasi yang menjalankan fungsi itu dan mengirim hasilnya kembali; model tidak pernah menjalankan kode sendiri.

[API kompatibel OpenAI](https://broadrouter.com/id/glossary/openai-compatible-api/)

API kompatibel OpenAI adalah API HTTP yang menerima format permintaan dan respons yang sama dengan API OpenAI, seperti POST /v1/chat/completions, sehingga SDK dan tool OpenAI bisa memakainya hanya dengan mengganti base URL, kunci API, dan nama model.

## Pertanyaan umum

### Apakah spring.ai.openai.base-url harus menyertakan /v1?

Ya. Di Spring AI 2.x nilainya diteruskan apa adanya ke klien openai-java, yang default-nya sendiri adalah https://api.openai.com/v1. Pakai https://inference.broadnet.ai/v1.

### Pakai max-tokens atau max-completion-tokens dengan BroadNet?

max-tokens. Dokumentasi Spring AI menyebut keduanya saling eksklusif. Referensi API BroadNet menjelaskan field max\_tokens, dan penalaran ikut dihitung di dalamnya, jadi beri ruang 1.000 token atau lebih.

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

Pakai GLM 5.3 atau Qwen3.8 27B, yang dicantumkan BroadNet dengan tools. Dokumentasi BroadNet tidak mencantumkan tool calling untuk DeepSeek V4.1 Flash.

### Bisakah tetap memakai OpenAI untuk embedding dan BroadNet untuk chat?

Bisa. spring.ai.openai.chat.base-url dan spring.ai.openai.chat.api-key menimpa properti bersama khusus untuk model chat. Referensi API BroadNet tidak mencantumkan endpoint embedding.

## Panduan terkait

-   [Memanggil BroadNet Inference dari Go dengan SDK openai-go](https://broadrouter.com/id/guides/openai-go-sdk/)
-   [Memakai OpenAI Python SDK dengan BroadNet Inference](https://broadrouter.com/id/guides/openai-python-sdk/)
-   [Kenapa model reasoning mengembalikan jawaban kosong](https://broadrouter.com/id/guides/reasoning-tokens-empty-response/)
-   [Kode error BroadNet Inference dan kapan harus mencoba ulang](https://broadrouter.com/id/guides/errors-and-retries/)
-   [Semua alat yang bisa dipakai dengan BroadNet Inference (bahasa Inggris)](https://broadrouter.com/integrations/): SDK, agen coding, antarmuka chat, dan alat otomatisasi, lengkap dengan pengaturan persis untuk masing-masing

Coba dengan beban kerja Anda yang sebenarnya. Akun baru mendapat kredit US$5 untuk Gemma dan transkripsi. DeepSeek, GLM, dan Qwen3.8 memerlukan top up.

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

**Sumber**

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