---
title: "Base URL trong API LLM là gì? Kèm ví dụ | BroadRouter"
description: "Base URL là địa chỉ gốc mà SDK đặt trước mọi đường dẫn API. Cách nó hoạt động trong client tương thích OpenAI và những lỗi cấu hình thường gây ra lỗi 404."
url: https://broadrouter.com/vi/glossary/base-url/
lang: vi
updated: 2026-11-15
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/glossary/base-url/) (cập nhật ngày 2026-11-15).

# Base URL

Cập nhật 2026-11-15

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.

Còn gọi là: base URL là gì, đổi base\_url, địa chỉ API, base\_url OpenAI, API base URL, api\_base, baseURL, OPENAI\_BASE\_URL, endpoint URL

Mọi request mà SDK gửi đi đều là base URL cộng với một đường dẫn. Đặt đúng base URL thì phần còn lại của client chạy mà không cần sửa gì.

## Cách hoạt động

Client ghép hai phần:

| Phần | Ví dụ |
| --- | --- |
| Base URL | `https://inference.broadnet.ai/v1` |
| Đường dẫn endpoint | `/chat/completions` |
| URL request đầy đủ | `https://inference.broadnet.ai/v1/chat/completions` |

Trong code, tên tham số tùy thuộc vào thư viện:

```python
# Python SDK
client = OpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])
```

```js
// Node SDK
const client = new OpenAI({ baseURL: "https://inference.broadnet.ai/v1", apiKey: process.env.BROADNET_API_KEY });
```

Cả hai SDK chính thức đều dùng biến môi trường `OPENAI_BASE_URL` làm phương án dự phòng, và dùng địa chỉ của chính OpenAI khi không có gì được đặt. Các công cụ khác dùng những tên như `api_base` hoặc `OPENAI_API_BASE`.

## Vì sao quan trọng

Base URL là thứ biến [API tương thích OpenAI](https://broadrouter.com/vi/glossary/openai-compatible-api/) thành một thay đổi thay thế trực tiếp. Nó cũng quyết định prompt của bạn đi đâu và ai tính tiền bạn. Một giá trị sai có thể gửi traffic, cùng với [API key](https://broadrouter.com/vi/glossary/api-key/) của bạn, đến nhầm nhà cung cấp. Hãy để nó trong cấu hình cạnh key, đừng hard-code ở nhiều chỗ.

Router cũng dùng cùng ý tưởng này: bạn trỏ base URL đến [router](https://broadrouter.com/vi/glossary/llm-router/) thay vì đến một nhà cung cấp model.

## Trên BroadNet Inference

Base URL là `https://inference.broadnet.ai/v1` cho mọi model: chat, vision và chuyển giọng nói thành văn bản. Chat gửi đến `/chat/completions` và chép lời gửi đến `/audio/transcriptions`. [Hướng dẫn nhanh với curl](https://broadrouter.com/vi/guides/curl-quickstart/) trình bày request đầu tiên, và [hướng dẫn LangChain](https://broadrouter.com/vi/guides/langchain-openai-base-url/) cho thấy thiết lập này nằm ở đâu trong một framework.

## Lỗi thường gặp

-   **Thiếu `/v1`.** `https://inference.broadnet.ai` không có `/v1` khiến SDK gặp lỗi 404.
-   **Lặp đường dẫn.** Dán cả endpoint đầy đủ, như `.../v1/chat/completions`, làm base URL sẽ khiến SDK gọi `.../chat/completions/chat/completions`.
-   **Biến môi trường còn sót lại.** Một `OPENAI_BASE_URL` cũ trong shell sẽ ghi đè giá trị bạn mong đợi. Hãy in nó ra khi request đi nhầm chỗ.
-   **HTTP thường.** Luôn dùng `https://`. Bearer key phải được truyền qua TLS.
-   **Đổi URL nhưng không đổi model.** Mỗi nhà cung cấp có model ID riêng, như `broadnet/deepseek-v4.1-flash`.

Chuyển cả một ứng dụng? Hãy làm theo [checklist chuyển đổi](https://broadrouter.com/vi/blog/openai-compatible-api-migration-checklist/).

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

### Base URL có nên kết thúc bằng /v1 không?

Với SDK tương thích OpenAI thì có, khi đường dẫn của nhà cung cấp bắt đầu bằng /v1. SDK sau đó nối thêm các đường dẫn như /chat/completions. Hãy kiểm tra tài liệu của nhà cung cấp để biết giá trị chính xác.

### Có đặt base URL được mà không cần sửa code không?

Có. OpenAI Python SDK và Node SDK chính thức đọc biến môi trường OPENAI\_BASE\_URL khi bạn không truyền base URL. Một số công cụ dùng tên biến riêng, như OPENAI\_API\_BASE trong Aider.

### Base URL của BroadNet Inference là gì?

https://inference.broadnet.ai/v1

## Xem thêm

-   [API tương thích OpenAI (OpenAI-compatible API)](https://broadrouter.com/vi/glossary/openai-compatible-api/) (thuật ngữ)
-   [API key (khóa API)](https://broadrouter.com/vi/glossary/api-key/) (thuật ngữ)
-   [LLM router](https://broadrouter.com/vi/glossary/llm-router/) (thuật ngữ)
-   [Dùng OpenAI Python SDK với BroadNet Inference](https://broadrouter.com/vi/guides/openai-python-sdk/) (hướng dẫn)
-   [Dùng OpenAI Node.js SDK với BroadNet Inference](https://broadrouter.com/vi/guides/openai-node-sdk/) (hướng dẫn)
-   [Dùng LangChain với BroadNet Inference](https://broadrouter.com/vi/guides/langchain-openai-base-url/) (hướng dẫn)
-   [Gửi request đầu tiên tới BroadNet Inference bằng curl](https://broadrouter.com/vi/guides/curl-quickstart/) (hướng dẫn)
-   [Chuyển sang API tương thích OpenAI: checklist khi chuyển đổi](https://broadrouter.com/vi/blog/openai-compatible-api-migration-checklist/) (bài viết)

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-glossary-base-url&utm_content=page-cta) ·

**Nguồn**

-   [README của OpenAI Python SDK (base\_url và OPENAI\_BASE\_URL)](https://github.com/openai/openai-python)
-   [OpenAI Node SDK (baseURL, mặc định lấy từ OPENAI\_BASE\_URL)](https://github.com/openai/openai-node)
-   [Hướng dẫn nhanh của OpenRouter (ví dụ base URL của bên thứ ba)](https://openrouter.ai/docs/quickstart)
-   [Tài liệu tham chiếu API BroadNet Inference (tiếng Anh)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-glossary-base-url&utm_content=sources)
