BroadRouter
Başlayın

Base URL (temel URL)

Güncellendi

Base URL (temel URL), https://api.example.com/v1 gibi, bir istemcinin /chat/completions gibi her uç nokta yolunun önüne eklediği sabit kök adrestir. OpenAI uyumlu SDK'larda base URL, API anahtarı ve model kimliğiyle birlikte değiştirildiğinde aynı kod farklı bir sağlayıcıya yönelir.

Diğer adları: base URL, temel URL, API base URL, API temel adresi, api_base, base_url, baseURL, OPENAI_BASE_URL, uç nokta URL'si, endpoint URL

Bir SDK’nın yaptığı her istek, base URL artı bir yoldur. Base URL’yi doğru ayarlarsanız istemcinin geri kalanı değişmeden çalışır.

Nasıl çalışır

İstemci iki parçayı birleştirir:

Parça Örnek
Base URL https://inference.broadnet.ai/v1
Uç nokta yolu /chat/completions
Tam istek URL’si https://inference.broadnet.ai/v1/chat/completions

Kodda parametrenin adı kütüphaneye göre değişir:

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

İki resmi SDK da OPENAI_BASE_URL ortam değişkenine, hiçbir şey ayarlanmamışsa OpenAI’nin kendi adresine geri döner. Diğer araçlar api_base veya OPENAI_API_BASE gibi adlar kullanır.

Neden önemli

Base URL, bir OpenAI uyumlu API’yi zahmetsiz bir değişiklik hâline getiren şeydir. İstemlerinizin nereye gittiğini ve size kimin fatura kestiğini de belirler. Yanlış bir değer, trafiğinizi ve API anahtarınızı yanlış sağlayıcıya gönderebilir. Değeri birkaç yere sabit kodlamak yerine anahtarın yanında, yapılandırmada tutun.

Yönlendiriciler de aynı fikri kullanır: base URL’yi bir model sağlayıcısı yerine yönlendiriciye yöneltirsiniz.

BroadNet Inference’ta

Base URL her model için https://inference.broadnet.ai/v1 değeridir: sohbet, görsel ve konuşmadan metne. Sohbet /chat/completions yoluna, transkripsiyon /audio/transcriptions yoluna gider. curl hızlı başlangıcı ilk isteği, LangChain rehberi ise ayarın bir çatıda nerede durduğunu gösterir.

Sık yapılan hatalar

  • Eksik /v1. /v1 olmadan https://inference.broadnet.ai, SDK’dan 404 hataları üretir.
  • Yolun iki kez eklenmesi. .../v1/chat/completions gibi tam uç noktayı base URL olarak yapıştırmak, SDK’nın .../chat/completions/chat/completions adresini çağırmasına yol açar.
  • Kalıntı ortam değişkenleri. Kabuğunuzdaki eski bir OPENAI_BASE_URL, beklediğiniz değeri geçersiz kılar. İstekler yanlış yere gidiyorsa değeri yazdırın.
  • Düz HTTP. Her zaman https:// kullanın. Bearer anahtarlar TLS üzerinden taşınmalıdır.
  • URL’yi değiştirip modeli değiştirmemek. Her sağlayıcının broadnet/deepseek-v4.1-flash gibi kendi model kimlikleri vardır.

Bütün bir uygulamayı mı taşıyorsunuz? Geçiş kontrol listesini adım adım izleyin.

Sık sorulan sorular

Base URL /v1 ile mi bitmeli?

OpenAI uyumlu SDK'lar için, sağlayıcının yolları /v1 ile başlıyorsa evet. SDK daha sonra /chat/completions gibi yolları ekler. Kesin değer için sağlayıcının belgelerine bakın.

Base URL'yi kodu değiştirmeden ayarlayabilir miyim?

Evet. Resmi OpenAI Python ve Node SDK'ları, base URL vermediğinizde OPENAI_BASE_URL ortam değişkenini okur. Bazı araçlar kendi değişken adlarını kullanır; örneğin Aider'da OPENAI_API_BASE.

BroadNet Inference base URL'si nedir?

https://inference.broadnet.ai/v1

Markdown olarak okuChatGPT asistanına sorClaude asistanına sorPerplexity asistanına sor