---
title: "Spring AI OpenAI starter với base-url tùy chỉnh | BroadRouter"
description: "Trỏ OpenAI chat starter của Spring AI tới BroadNet Inference bằng spring.ai.openai.base-url, một model ID BroadNet và max-tokens, rồi gọi từ ChatClient."
url: https://broadrouter.com/vi/guides/spring-ai-openai-base-url/
lang: vi
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Được dịch từ tiếng Anh với sự hỗ trợ của AI. [Đọc bản gốc tiếng Anh](https://broadrouter.com/guides/spring-ai-openai-base-url/) (cập nhật ngày 2026-11-16).

# Dùng Spring AI với BroadNet Inference (OpenAI base-url)

Cập nhật 2026-11-16

Thêm spring-ai-starter-model-openai, rồi đặt spring.ai.openai.base-url là https://inference.broadnet.ai/v1, spring.ai.openai.api-key là key BroadNet và spring.ai.openai.chat.model là một ID BroadNet như broadnet/glm-5.3. Đặt spring.ai.openai.chat.max-tokens có chừa chỗ cho suy luận. Spring AI 2.x dùng SDK openai-java, vốn tự nối /chat/completions vào base URL.

Spring AI là framework của dự án Spring để dùng AI trong Java. OpenAI chat starter của nó đọc thuộc tính `base-url`, nên có thể gọi bất kỳ server tương thích OpenAI nào. BroadNet Inference phục vụ chat completions chuẩn tại `https://inference.broadnet.ai/v1`. BroadRouter là website của chính BroadNet; bài này làm theo tài liệu tham chiếu Spring AI 2.0.2.

## Thêm starter

Khi đã có Spring AI BOM (xem tài liệu quản lý dependency của Spring AI):

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

## Cấu hình

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

Hãy giữ `/v1` trong URL. Trong Spring AI 2.x, giá trị này được chuyển nguyên văn cho client openai-java (`OpenAiSetup.calculateBaseUrl` trả về đúng như cũ), và client đó tự thêm `/chat/completions`. Giá trị mặc định bị thay thế là `https://api.openai.com/v1`.

## Gọi và chạy thử

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

Khởi động ứng dụng. Nếu có câu trả lời được in ra, key, URL và model ID đều đúng.

## Những cài đặt quan trọng với BroadNet

-   **`max-tokens`, không phải `max-completion-tokens`.** Tài liệu Spring AI nói hai thuộc tính này loại trừ nhau và đặt cả hai sẽ gây lỗi. Tài liệu tham chiếu API của BroadNet mô tả `max_tokens`. DeepSeek V4.1 Flash, GLM 5.3 và Qwen3.8 27B suy luận trước, và phần suy luận được tính vào giới hạn.
-   **Văn bản suy luận.** Spring AI có thể hiển thị `reasoning_content` từ các server tương thích OpenAI có trả về trường này. Tài liệu tham chiếu API của BroadNet báo số token suy luận trong `usage` nhưng không cam kết trả về chính văn bản suy luận, nên đừng phụ thuộc vào nó.
-   **Ghi đè chỉ cho chat.** `spring.ai.openai.chat.base-url` và `spring.ai.openai.chat.api-key` được ưu tiên hơn các thuộc tính dùng chung, chỉ cho model chat. Hãy dùng chúng nếu các model OpenAI khác trong Spring AI (như embeddings) phải ở lại OpenAI.
-   **Thử lại.** `spring.ai.retry.max-attempts` mặc định là 10 với exponential backoff. Trên key trả theo mức dùng, điều đó có thể nhanh chóng dùng hết giới hạn mỗi phút; hãy cân nhắc giảm giá trị này.

## Chọn model nào

| Mục đích | `spring.ai.openai.chat.model` |
| --- | --- |
| Gọi tool, đầu ra có cấu trúc | `broadnet/glm-5.3` |
| Hình ảnh hoặc văn bản tiếng Ả Rập | `broadnet/qwen3.8-27b` |
| Tài liệu dài, gói giá cố định | `broadnet/deepseek-v4.1-flash` |
| Tín dụng ban đầu miễn phí | `broadnet/gemma-4-26b-a4b` |

[Giá của mọi model](https://broadrouter.com/vi/pricing/).

## Xử lý sự cố

-   **401.** Key sai, đã hết hạn hoặc đã hết hạn mức, hoặc `BROADNET_API_KEY` chưa được đặt cho JVM.
-   **404.** Base URL thiếu `/v1`, hoặc model ID sai. Các model trả phí cần nạp tiền; tín dụng $5 chỉ dùng được cho `broadnet/gemma-4-26b-a4b` và hai model Transcribe.
-   **`content()` rỗng.** Suy luận đã dùng hết ngân sách đầu ra. Hãy tăng `max-tokens`. [Vì sao câu trả lời trả về rỗng](https://broadrouter.com/vi/guides/reasoning-tokens-empty-response/).
-   **Lỗi 400 khi đặt cả hai giới hạn token.** Hãy bỏ `max-completion-tokens`.
-   **429.** Key trả theo mức dùng cho phép 30 request mỗi phút và 4 request đang xử lý cùng lúc. Xem [lỗi và thử lại](https://broadrouter.com/vi/guides/errors-and-retries/).

## Thuật ngữ trong hướng dẫn này

[Trả theo mức dùng (pay-as-you-go)](https://broadrouter.com/vi/glossary/pay-as-you-go/)

Trả theo mức dùng (pay-as-you-go) là mô hình giá mà bạn chỉ trả cho những gì đã dùng, đo theo đơn vị như token, request hoặc phút âm thanh, không có gói đăng ký hay cam kết tối thiểu. Hầu hết API LLM tính phí theo cách này, trừ vào số dư trả trước hoặc qua hóa đơn định kỳ.

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

Token là đơn vị văn bản mà model ngôn ngữ đọc và viết: một từ, một phần của từ, một dấu câu hoặc một chuỗi byte do tokenizer của model tạo ra. API LLM đếm, giới hạn và thường tính phí theo token.

[API tương thích OpenAI (OpenAI-compatible API)](https://broadrouter.com/vi/glossary/openai-compatible-api/)

API tương thích OpenAI là một HTTP API nhận cùng định dạng request và phản hồi như OpenAI API, ví dụ POST /v1/chat/completions, nên SDK và công cụ của OpenAI dùng được nó chỉ bằng cách đổi base URL, API key và tên model.

[Embedding (vector nhúng)](https://broadrouter.com/vi/glossary/embeddings/)

Embedding là danh sách số thực (vector) mà một model tạo ra để biểu diễn đoạn văn bản, hình ảnh hay đầu vào khác. Đầu vào có nghĩa tương tự nhận vector gần nhau, nên khoảng cách giữa vector dùng được để xếp hạng kết quả tìm kiếm, gom cụm tài liệu hoặc tìm mục liên quan.

[Giới hạn tần suất (rate limit)](https://broadrouter.com/vi/glossary/rate-limit/)

Giới hạn tần suất (rate limit) là mức trần mà API đặt ra cho lượng sử dụng của một client trong một khoảng thời gian, như số request mỗi phút hoặc số token mỗi phút. Request vượt giới hạn bị từ chối, thường với HTTP 429 Too Many Requests, cho đến khi mức dùng giảm xuống dưới giới hạn.

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

Base URL là địa chỉ gốc cố định của một API, như https://api.example.com/v1, mà client đặt trước mọi đường dẫn endpoint, như /chat/completions. Trong SDK tương thích OpenAI, đổi base URL cùng với API key và model ID sẽ trỏ cùng một đoạn code sang nhà cung cấp khác.

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

Chat Completions API là endpoint HTTP của OpenAI, POST /v1/chat/completions, nhận tên model và danh sách message có gắn vai trò rồi trả về message tiếp theo của model. Cấu trúc request và response của nó đã trở thành định dạng chung mà các nhà cung cấp và SDK tương thích OpenAI dùng lại.

[Concurrency (request đồng thời)](https://broadrouter.com/vi/glossary/concurrency/)

Concurrency (request đồng thời) là số request mà một client đang xử lý cùng lúc. Các API LLM thường giới hạn nó theo key hoặc theo gói, tách biệt với số request mỗi phút, vì mỗi request đang mở chiếm dụng năng lực GPU cho tới khi response kết thúc.

## Câu hỏi thường gặp

### spring.ai.openai.base-url có cần chứa /v1 không?

Có. Trong Spring AI 2.x, giá trị này được chuyển nguyên văn cho client openai-java, mà giá trị mặc định của chính client đó là https://api.openai.com/v1. Hãy dùng https://inference.broadnet.ai/v1.

### Với BroadNet nên dùng max-tokens hay max-completion-tokens?

Dùng max-tokens. Tài liệu Spring AI nói hai thuộc tính này loại trừ nhau. Tài liệu tham chiếu API của BroadNet mô tả trường max\_tokens, và suy luận được tính vào đó, nên hãy cho phép từ 1.000 token trở lên.

### Gọi tool của Spring AI có chạy với BroadNet không?

Hãy dùng GLM 5.3 hoặc Qwen3.8 27B, là các model BroadNet liệt kê có tool. Tài liệu BroadNet không liệt kê gọi tool cho DeepSeek V4.1 Flash.

### Có thể giữ OpenAI cho embeddings và dùng BroadNet cho chat không?

Có. spring.ai.openai.chat.base-url và spring.ai.openai.chat.api-key ghi đè các thuộc tính dùng chung, chỉ cho model chat. Tài liệu tham chiếu API của BroadNet không liệt kê endpoint embeddings.

## Hướng dẫn liên quan

-   [Gọi BroadNet Inference từ Go bằng SDK openai-go](https://broadrouter.com/vi/guides/openai-go-sdk/)
-   [Dùng OpenAI Python SDK với BroadNet Inference](https://broadrouter.com/vi/guides/openai-python-sdk/)
-   [Vì sao model suy luận trả về câu trả lời rỗng](https://broadrouter.com/vi/guides/reasoning-tokens-empty-response/)
-   [Mã lỗi BroadNet Inference và khi nào nên thử lại](https://broadrouter.com/vi/guides/errors-and-retries/)
-   [Mọi công cụ dùng được với BroadNet Inference (tiếng Anh)](https://broadrouter.com/integrations/): SDK, agent lập trình, giao diện chat và công cụ tự động hóa, kèm cấu hình chính xác cho từng công cụ

Hãy thử với khối lượng công việc thực tế của bạn. Tài khoản mới được tặng US$5 tín dụng ban đầu cho Gemma và chuyển giọng nói thành văn bản. DeepSeek, GLM và Qwen3.8 cần nạp tiền.

[Bắt đầu](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-guides-spring-ai-openai-base-url&utm_content=page-cta) ·

**Nguồn**

-   [Tài liệu tham chiếu Spring AI, OpenAI Chat (2.0.2) (kiểm tra ngày 2026-11-15)](https://docs.spring.io/spring-ai/reference/api/chat/openai-chat.html)
-   [Mã nguồn Spring AI tại v2.0.2, OpenAiSetup.calculateBaseUrl (kiểm tra ngày 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)
-   [Tài liệu tham chiếu API BroadNet Inference (kiểm tra ngày 2026-11-15) (tiếng Anh)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-guides-spring-ai-openai-base-url&utm_content=sources)
