Base URL की गलती: protocol, path और endpoint कैसे जांचें
Base URL को क्रम से जांचने की व्यावहारिक विधि: protocol, domain, API version, endpoint और client settings — हर बदलाव के बाद एक छोटा test request।
यदि API key बन चुकी है लेकिन client 401, 404, 405, model not found लौटाता है या login page खोल देता है, तो key, model और address एक साथ न बदलें। पहले पहचानें कि client को OpenAI-compatible contract चाहिए या Anthropic-compatible; फिर address को https → domain → base path → endpoint क्रम में जांचें। हर बदलाव के बाद एक ही छोटा request भेजें। इससे पता चलता है कि configuration किस परत पर contract से अलग हुआ।
BetterToken में यह फर्क खास है: OpenAI-compatible clients का Base URL https://www.bettertoken.ai/v1%60?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-022&utm_content=base-url-oshibka-kak-proverit-put-i-protokol है, जबकि Claude Code Anthropic-compatible Base URL https://bettertoken.ai` लेता है और जरूरी path खुद जोड़ता है। ये एक ही string के दो रूप नहीं हैं और इन्हें बदला नहीं जा सकता। सही tool के मौजूदा मान BetterToken Docs में जांचें।
Base URL और पूरे request URL को अलग समझें
Base URL वह address है जिसे provider field या client config में डालते हैं। पूरा request URL तब बनता है जब library या CLI resource path जोड़ता है।
यदि आप raw Anthropic Messages request खुद लिख रहे हैं, पूरा path https://www.bettertoken.ai/v1/messages%60?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-022&utm_content=base-url-oshibka-kak-proverit-put-i-protokol है। लेकिन Claude Code के Base URL field का यह मान नहीं है। OpenAI-compatible client में base address सामान्यतः /v1` पर खत्म होता है; endpoint client जोड़ता है। यह भेद Claude Code guide और Codex guide में दर्ज है।
सही क्रम में पांच जांच
हर चरण के बाद वही छोटा request दोहराएं, ताकि एक response में कई कारण न मिल जाएं।
- Client किस protocol की अपेक्षा करता है, यह तय करें।
- Endpoint के बिना केवल सही Base URL डालें।
- देखें कि request URL में
/v1ठीक एक बार है। - Streaming और tools के बिना minimal request चलाएं।
- Client को पूरी तरह restart करके वही test दोहराएं।
1. Model नाम नहीं, protocol जांचें
Tool में integration type देखें। Codex, Cursor, Cline, OpenCode और कई अन्य tools OpenAI-compatible setting उपयोग करते हैं। Claude Code Anthropic-compatible contract उपयोग करता है। गलत contract मिलने पर model बदलने से error ठीक नहीं होगा: client और server को अलग fields तथा paths चाहिए। Model नाम देखकर अनुमान न लगाएं; अपने tool के Docs में provider, API key और Base URL section खोलें।
2. Base URL से अतिरिक्त path हटाएं
OpenAI-compatible setup में इस्तेमाल करें:
Claude Code में /v1 और /messages के बिना इस्तेमाल करें:
अक्सर कोई curl example का पूरा URL GUI के Base URL field में paste कर देता है। Client फिर अपना endpoint जोड़ता है और route मौजूद नहीं रहता। base_url, endpoint base या API base नाम वाले field में सामान्यतः resource name नहीं जाता।
3. /v1 का owner तय करें
API version ठीक एक बार दिखनी चाहिए। BetterToken की OpenAI-compatible setting में /v1 Base URL में पहले से है। यदि SDK version prefix अलग से set करने देता है, Docs के स्पष्ट निर्देश के बिना दूसरा /v1 न जोड़ें। Logs में .../v1/v1/... लगभग हमेशा join error है। इसके उलट OpenAI-compatible request में /v1 न होना 404 या JSON की जगह HTML दे सकता है।
4. Minimal request से endpoint जांचें
Streaming, tools या लंबे context से पहले उसी client से एक छोटा request चलाएं। Raw OpenAI-compatible request में endpoint Base URL के बाद resource है; Anthropic Messages के लिए वह /v1/messages है। Current Model ID अपने Setup panel या model plaza से लें और अपना API key ही इस्तेमाल करें। Key को issue, screenshot या साझा command में न डालें। यदि response में success JSON, model और usage मिलते हैं, address layer ठीक है; तभी limits, model या task parameters जांचें।
5. बदलाव के बाद client restart करें
कई CLI और desktop apps environment variables और config केवल startup पर पढ़ते हैं। File save करना काफी नहीं: process बंद करें, नया terminal खोलें या app restart करें, फिर वही छोटा test चलाएं। वरना editor में नया Base URL दिखेगा लेकिन test पुराने value पर चलेगा।
सामान्य responses को कैसे पढ़ें
401 हमेशा गलत address नहीं है और 404 हमेशा missing model नहीं है। पहले URL, फिर authentication, फिर model और अंत में advanced features जांचना इसी कारण उपयोगी है।
Codex और Claude Code के लिए त्वरित तरीका
Codex के लिए OpenAI-compatible provider और current Codex instructions उपयोग करें: Base URL `https://www.bettertoken.ai/v1%60,?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-022&utm_content=base-url-oshibka-kak-proverit-put-i-protokol अपना BetterToken API key और वर्तमान Model ID। Codex restart करें और test directory में छोटा read-only request चलाएं। Dashboard में request time, status, model और token usage देखें।
Claude Code के लिए Claude Code instructions उपयोग करें: Anthropic-compatible Base URL https://bettertoken.ai, अपना key और guide में दिया model। इस field में OpenAI का /v1 न डालें और /messages manually न जोड़ें। Restart के बाद एक छोटा request चलाएं; tools या MCP बाद में जोड़ें।
किन बातों से बचें
- Base URL, API key और Model ID को एक साथ न बदलें।
- हर tool में एक ही address न डालें; protocol client तय करता है।
- तारीख या tool page जांचे बिना पुरानी guide का path न लें।
- पहला test write access वाले कामकाजी repository में न चलाएं; खाली test folder और read-only task लें।
- पूरा API key support को न भेजें; status, time, tool name और sanitized request URL काफी हैं।
अगला कदम
अपने tool के लिए BetterToken Docs खोलें, BetterToken account में अपना API key बनाएं, चुने गए protocol का वर्तमान Base URL copy करें और छोटा test चलाएं। Test सफल होने पर Dashboard में status, model और token usage मिलाएं; यह केवल saved settings पर भरोसा करने से अधिक विश्वसनीय है।