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./v1olmadanhttps://inference.broadnet.ai, SDK’dan 404 hataları üretir. - Yolun iki kez eklenmesi.
.../v1/chat/completionsgibi tam uç noktayı base URL olarak yapıştırmak, SDK’nın.../chat/completions/chat/completionsadresini ç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-flashgibi kendi model kimlikleri vardır.
Bütün bir uygulamayı mı taşıyorsunuz? Geçiş kontrol listesini adım adım izleyin.