BroadRouter
Mulakan

Base URL (URL asas)

Dikemas kini

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 SDK
client = OpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])
// 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 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 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 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 menunjukkan permintaan pertama, dan panduan LangChain 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.

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

Baca sebagai MarkdownTanya ChatGPTTanya ClaudeTanya Perplexity