---
title: "Apakah itu base URL dalam API LLM? Dengan contoh | BroadRouter"
description: "Base URL ialah alamat akar yang diletakkan SDK di hadapan setiap laluan API. Cara ia berfungsi dalam klien serasi OpenAI, dan kesilapan yang menyebabkan ralat 404."
url: https://broadrouter.com/ms/glossary/base-url/
lang: ms
updated: 2026-11-15
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/glossary/base-url/) (dikemas kini 2026-11-15).

# Base URL (URL asas)

Dikemas kini 2026-11-15

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.

Juga dikenali sebagai: URL asas, base URL API, API base URL, api\_base, baseURL, base\_url, OPENAI\_BASE\_URL, endpoint URL

Setiap permintaan yang dibuat oleh SDK ialah base URL ditambah satu laluan. Jika base URL betul, bahagian lain klien berfungsi tanpa perubahan.

## Cara ia berfungsi

Klien menggabungkan dua bahagian:

| Bahagian | Contoh |
| --- | --- |
| Base URL | `https://inference.broadnet.ai/v1` |
| Laluan endpoint | `/chat/completions` |
| URL permintaan penuh | `https://inference.broadnet.ai/v1/chat/completions` |

Dalam kod, nama parameter bergantung pada pustaka:

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

Kedua-dua SDK rasmi beralih kepada pembolehubah persekitaran `OPENAI_BASE_URL`, dan kepada alamat OpenAI sendiri apabila tiada apa-apa ditetapkan. Alat lain menggunakan nama seperti `api_base` atau `OPENAI_API_BASE`.

## Mengapa ia penting

Base URL ialah sebab [API serasi OpenAI](https://broadrouter.com/ms/glossary/openai-compatible-api/) boleh ditukar dengan mudah. Ia juga menentukan ke mana prompt anda pergi dan siapa yang mengebil anda. Nilai yang salah boleh menghantar trafik, dan [kunci API](https://broadrouter.com/ms/glossary/api-key/) anda, kepada penyedia yang salah. Simpan nilainya dalam konfigurasi bersebelahan kunci, bukan dikod keras di beberapa tempat.

Router menggunakan idea yang sama: anda menghalakan base URL ke [router](https://broadrouter.com/ms/glossary/llm-router/) dan bukannya ke penyedia model.

## Di BroadNet Inference

Base URL ialah `https://inference.broadnet.ai/v1` untuk setiap model: chat, penglihatan dan speech-to-text. Chat dihantar ke `/chat/completions` dan transkripsi ke `/audio/transcriptions`. [Mula pantas curl](https://broadrouter.com/ms/guides/curl-quickstart/) menunjukkan permintaan pertama, dan [panduan LangChain](https://broadrouter.com/ms/guides/langchain-openai-base-url/) menunjukkan di mana tetapan itu berada dalam rangka kerja.

## Kesilapan biasa

-   **Tiada `/v1`.** `https://inference.broadnet.ai` tanpa `/v1` menghasilkan ralat 404 daripada SDK.
-   **Laluan berganda.** Menampal endpoint penuh, seperti `.../v1/chat/completions`, sebagai base URL menyebabkan SDK memanggil `.../chat/completions/chat/completions`.
-   **Pembolehubah persekitaran yang tertinggal.** `OPENAI_BASE_URL` lama dalam shell anda mengatasi apa yang anda jangkakan. Cetak nilainya apabila permintaan pergi ke tempat yang salah.
-   **HTTP biasa.** Sentiasa gunakan `https://`. Bearer key mesti dihantar melalui TLS.
-   **Menukar URL tetapi bukan model.** Setiap penyedia mempunyai ID model sendiri, seperti `broadnet/deepseek-v4.1-flash`.

Memindahkan seluruh aplikasi? Ikut [senarai semak migrasi](https://broadrouter.com/ms/blog/openai-compatible-api-migration-checklist/).

## Soalan lazim

### Patutkah base URL berakhir dengan /v1?

Untuk SDK serasi OpenAI, ya, apabila laluan penyedia bermula dengan /v1. SDK kemudian menambah laluan seperti /chat/completions. Semak dokumentasi penyedia untuk nilai yang tepat.

### Bolehkah saya menetapkan base URL tanpa menukar kod?

Boleh. SDK OpenAI Python dan Node rasmi membaca pembolehubah persekitaran OPENAI\_BASE\_URL apabila anda tidak menghantar base URL. Sesetengah alat menggunakan nama pembolehubah sendiri, seperti OPENAI\_API\_BASE dalam Aider.

### Apakah base URL BroadNet Inference?

https://inference.broadnet.ai/v1

## Lihat juga

-   [API serasi OpenAI (OpenAI-compatible API)](https://broadrouter.com/ms/glossary/openai-compatible-api/) (istilah)
-   [Kunci API (API key)](https://broadrouter.com/ms/glossary/api-key/) (istilah)
-   [Penghala LLM (LLM router)](https://broadrouter.com/ms/glossary/llm-router/) (istilah)
-   [Cara guna OpenAI Python SDK dengan BroadNet Inference](https://broadrouter.com/ms/guides/openai-python-sdk/) (panduan)
-   [Cara guna OpenAI Node.js SDK dengan BroadNet Inference](https://broadrouter.com/ms/guides/openai-node-sdk/) (panduan)
-   [Cara guna LangChain dengan BroadNet Inference](https://broadrouter.com/ms/guides/langchain-openai-base-url/) (panduan)
-   [Permintaan pertama ke BroadNet Inference dengan curl](https://broadrouter.com/ms/guides/curl-quickstart/) (panduan)
-   [Beralih ke API serasi OpenAI: senarai semak migrasi](https://broadrouter.com/ms/blog/openai-compatible-api-migration-checklist/) (artikel)

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

**Sumber**

-   [README OpenAI Python SDK (base\_url dan OPENAI\_BASE\_URL)](https://github.com/openai/openai-python)
-   [OpenAI Node SDK (baseURL, lalai kepada OPENAI\_BASE\_URL)](https://github.com/openai/openai-node)
-   [Mula pantas OpenRouter (contoh base URL pihak ketiga)](https://openrouter.ai/docs/quickstart)
-   [Rujukan API BroadNet Inference (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-glossary-base-url&utm_content=sources)
