BroadRouter
Mulai

Base URL

Diperbarui

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.

Disebut juga: base URL, URL dasar, API base URL, api_base, base_url, baseURL, OPENAI_BASE_URL, URL endpoint, endpoint URL

Setiap permintaan yang dibuat SDK adalah base URL ditambah sebuah path. Jika base URL-nya benar, bagian client lainnya berjalan tanpa perubahan.

Cara kerjanya

Client menggabungkan dua bagian:

Bagian Contoh
Base URL https://inference.broadnet.ai/v1
Path endpoint /chat/completions
URL permintaan lengkap https://inference.broadnet.ai/v1/chat/completions

Di kode, nama parameternya bergantung pada library:

# 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 SDK resmi beralih ke environment variable OPENAI_BASE_URL, lalu ke alamat OpenAI sendiri jika tidak ada yang diatur. Tool lain memakai nama seperti api_base atau OPENAI_API_BASE.

Kenapa ini penting

Base URL-lah yang membuat API kompatibel OpenAI bisa dipakai sebagai pengganti langsung. Base URL juga menentukan ke mana prompt Anda dikirim dan siapa yang menagih Anda. Nilai yang salah bisa mengirim trafik, beserta kunci API Anda, ke penyedia yang salah. Simpan di konfigurasi di samping kunci, jangan di-hard-code di beberapa tempat.

Router memakai ide yang sama: Anda mengarahkan base URL ke router, bukan ke penyedia model.

Di BroadNet Inference

Base URL-nya https://inference.broadnet.ai/v1 untuk setiap model: chat, visi, dan speech-to-text. Chat menuju /chat/completions dan transkripsi menuju /audio/transcriptions. Panduan cepat curl menunjukkan permintaan pertama, dan panduan LangChain menunjukkan letak pengaturannya di sebuah framework.

Kesalahan umum

  • /v1 terlewat. https://inference.broadnet.ai tanpa /v1 menghasilkan error 404 dari SDK.
  • Path ganda. Menempelkan endpoint lengkap, seperti .../v1/chat/completions, sebagai base URL membuat SDK memanggil .../chat/completions/chat/completions.
  • Environment variable sisa. OPENAI_BASE_URL lama di shell Anda menimpa nilai yang Anda harapkan. Cetak nilainya jika permintaan terkirim ke tempat yang salah.
  • HTTP biasa. Selalu gunakan https://. Bearer key harus dikirim lewat TLS.
  • Mengganti URL tetapi tidak mengganti model. Setiap penyedia punya ID model sendiri, seperti broadnet/deepseek-v4.1-flash.

Memindahkan seluruh aplikasi? Ikuti checklist migrasi langkah demi langkah.

Pertanyaan umum

Apakah base URL harus diakhiri /v1?

Untuk SDK yang kompatibel dengan OpenAI, ya, jika path penyedia dimulai dengan /v1. SDK lalu menambahkan path seperti /chat/completions. Periksa dokumentasi penyedia untuk nilai yang tepat.

Bisakah saya mengatur base URL tanpa mengubah kode?

Bisa. SDK OpenAI resmi untuk Python dan Node membaca environment variable OPENAI_BASE_URL jika Anda tidak mengisi base URL. Sebagian tool memakai nama variabel sendiri, seperti OPENAI_API_BASE di Aider.

Apa base URL BroadNet Inference?

https://inference.broadnet.ai/v1

Baca sebagai MarkdownTanya ChatGPTTanya ClaudeTanya Perplexity