SDK का हर अनुरोध base URL और एक पाथ को जोड़कर बनता है। base URL सही हो, तो बाक़ी क्लाइंट बिना बदलाव के चलता है।
यह कैसे काम करता है
क्लाइंट दो हिस्से जोड़ता है:
| हिस्सा | उदाहरण |
|---|---|
| base URL | https://inference.broadnet.ai/v1 |
| एंडपॉइंट पाथ | /chat/completions |
| पूरा अनुरोध URL | https://inference.broadnet.ai/v1/chat/completions |
कोड में पैरामीटर का नाम लाइब्रेरी पर निर्भर करता है:
# 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 });
दोनों आधिकारिक SDK, OPENAI_BASE_URL एनवायरनमेंट वेरिएबल पर लौटते हैं, और कुछ भी सेट न हो तो OpenAI के अपने पते पर। दूसरे टूल api_base या OPENAI_API_BASE जैसे नाम इस्तेमाल करते हैं।
यह क्यों मायने रखता है
base URL ही OpenAI-compatible API को आसान बदलाव बनाता है। यही तय करता है कि आपके प्रॉम्प्ट कहाँ जाते हैं और बिल कौन बनाता है। ग़लत वैल्यू ट्रैफ़िक, और आपकी API key, ग़लत प्रोवाइडर को भेज सकती है। इसे key के साथ कॉन्फ़िगरेशन में रखें, कई जगह हार्ड-कोड न करें।
राउटर भी यही तरीक़ा इस्तेमाल करते हैं: आप base URL को मॉडल प्रोवाइडर की जगह राउटर पर सेट करते हैं।
BroadNet Inference पर
हर मॉडल के लिए base URL https://inference.broadnet.ai/v1 है: चैट, विज़न और स्पीच-टू-टेक्स्ट। चैट /chat/completions पर जाती है और ट्रांसक्रिप्शन /audio/transcriptions पर। curl क्विकस्टार्ट पहला अनुरोध दिखाता है, और LangChain गाइड दिखाती है कि फ़्रेमवर्क में यह सेटिंग कहाँ है।
आम ग़लतियाँ
/v1का न होना./v1के बिनाhttps://inference.broadnet.aiसे SDK में 404 एरर आते हैं।- दोहराया गया पाथ. पूरा एंडपॉइंट, जैसे
.../v1/chat/completions, base URL में पेस्ट करने पर SDK.../chat/completions/chat/completionsकॉल करता है। - बचे हुए एनवायरनमेंट वेरिएबल. आपके शेल में पुराना
OPENAI_BASE_URLआपकी उम्मीद वाली वैल्यू को ओवरराइड कर देता है। अनुरोध ग़लत जगह जाएँ तो इसे प्रिंट करें। - सादा HTTP. हमेशा
https://इस्तेमाल करें। bearer key का TLS पर ही जाना ज़रूरी है। - URL बदलना पर मॉडल नहीं. हर प्रोवाइडर के अपने मॉडल ID होते हैं, जैसे
broadnet/deepseek-v4.1-flash।
पूरा ऐप माइग्रेट कर रहे हैं? माइग्रेशन चेकलिस्ट देखें।