API 401 या 404 त्रुटि: गलत कुंजी, बेस URL या मॉडल आईडी

आपका अनुरोध एक स्टेटस कोड के साथ विफल हो गया और आप सुनिश्चित नहीं हैं कि पहले क्या देखें। संक्षिप्त उत्तर: 401 आमतौर पर कुंजी की ओर इशारा करता है, 404 आमतौर पर इसका मतलब है कि आप गलत जगह पर दस्तक दे रहे हैं — या तो पता (बेस URL और पथ) या मॉडल आईडी। तीन चीजें, इस क्रम में जांचें, और एक curl कमांड जो समाधान साबित करता है।

OpenAI का error-codes पेज (26 अक्टूबर 2026 को जांचा गया) दो 401 संदेशों को सूचीबद्ध करता है: "Invalid Authentication" और "Incorrect API key provided"। दोनों के लिए दिया गया समाधान समान है: कुंजी जांचें या नई बनाएं। पेज API के लिए कोई 404 दर्ज नहीं करता, इसलिए 404 के लिए नीचे दिया गया नियम OpenAI-संगत एंडपॉइंट कैसे काम करते हैं से आता है, उस पेज से नहीं।

उन्हें अलग करने का त्वरित तरीका#

संदेश की शब्दावली सर्वर और आपके टूल (Cline, Aider, OpenCode और Continue प्रत्येक त्रुटियों को अपने तरीके से लपेटते हैं) पर निर्भर करती है, इसलिए संख्या से शुरू करें, फिर नीचे दिए गए curl जांच से पुष्टि करें।

401: कुंजी एंडपॉइंट से मेल नहीं खाती#

क्लासिक कहानी: आपने एक टूल को नए प्रदाता पर स्थानांतरित किया, बेस URL बदला, और कॉन्फ़िग में पुराने प्रदाता की कुंजी छोड़ दी। पता नया है, कुंजी पुरानी है, और सर्वर 401 का जवाब देता है। कुछ टूटा नहीं है; कुंजी बस किसी और घर की है।

क्या जांचें:

1. कुंजी किस प्रदाता ने जारी की? यह वही होना चाहिए जिसका पता आप कॉल कर रहे हैं। एक सेवा की कुंजी दूसरी पर मान्य नहीं है।
2. अनजाने अक्षर। कुंजी के साथ पेस्ट किया गया स्पेस या लाइन ब्रेक, या मान के अंदर आ गए उद्धरण।
3. टूल इसे कहां से पढ़ता है। एक एनवायरनमेंट वेरिएबल जो एक टर्मिनल में सेट है और जिससे आपके एडिटर ने शुरू किया उसमें नहीं, एक सामान्य कारण है। यदि टूल में कॉन्फ़िग फ़ाइल और एनवायरनमेंट वेरिएबल दोनों हैं, तो पता करें कि कौन जीतता है।
4. रद्द या हटाई गई कुंजी। आपने जो कुंजी हटाई या रद्द की, वह काम करना बंद कर देती है — नई बनाएं और कॉन्फ़िग में डालें।

यदि आप सुनिश्चित नहीं हैं कि कुंजियाँ कैसे काम करती हैं या उन्हें कहाँ रखें, API कुंजी क्या है और इसे सुरक्षित रूप से कैसे संग्रहीत करें इसे सरल शब्दों में समझाता है।

हर मॉडल पर 404: पता गलत है#

CheapTokens के लिए बेस URL https://api.cheaptokens.dev/v1 है। टूल और SDK एंडपॉइंट पथ स्वयं जोड़ते हैं, इसलिए सामान्य गलतियाँ /v1 के बारे में हैं:

• /v1 गायब: टूल अंततः https://api.cheaptokens.dev/chat/completions को कॉल करता है।
• /v1 दोगुना: आपने पूरा पथ उस फ़ील्ड में पेस्ट कर दिया जो पहले से इसे जोड़ता है, और https://api.cheaptokens.dev/v1/v1/chat/completions मिलता है।
• गलत प्रकार: OpenAI-शैली के टूल और OpenAI SDK /v1 के साथ पता लेते हैं। Anthropic SDK और Claude Code पता /v1 के बिना लेते हैं: https://api.cheaptokens.dev।

यदि आपने कभी सोचा है कि बेस URL वास्तव में क्या है और टूल इसका कौन सा हिस्सा जोड़ता है, यह व्याख्या इसे समझाती है। Anthropic पक्ष के लिए, CheapTokens के साथ Anthropic Python SDK देखें।

एक मॉडल पर 404: मॉडल आईडी#

यह उन लोगों को पकड़ता है जो मूल्य तालिका या किसी अन्य प्रदाता से नाम कॉपी करते हैं। एक मूल्य तालिका DeepSeek-V4-Flash कह सकती है; API पूर्ण गेटवे आईडी चाहता है, डेवलपर प्रीफ़िक्स और रिलीज़ के साथ:

मूल्य लेबल से छोटी आईडी API द्वारा स्वीकार नहीं की जाती हैं, और वर्तनी मायने रखती है: बड़े अक्षर, स्लैश, -0731 प्रत्यय। आईडी को CheapTokens दस्तावेज़ से कॉपी करें, स्मृति से टाइप करने के बजाय — अलग-अलग प्रदाता एक ही मॉडल को अलग-अलग नाम देते हैं। अपनी कुंजी के लिए उपलब्ध सटीक आईडी देखने के लिए, उसी Authorization हेडर के साथ GET https://api.cheaptokens.dev/v1/models को कॉल करें और सूची से आईडी कॉपी करें:

curl https://api.cheaptokens.dev/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

यदि तालिका में नाम तर्क अजीब लगता है, AI मॉडल नाम कैसे पढ़ें उपनाम बनाम पिन किए गए संस्करण को समझाता है।

एक curl कमांड से समाधान साबित करें#

टूल को चित्र से बाहर निकालें और सीधे API को कॉल करें। कुंजी प्लेसहोल्डर को अपनी कुंजी से बदलें:

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [{"role": "user", "content": "Say hi in one word."}],
    "max_tokens": 20
  }'

इस एक अनुरोध में तीनों संदिग्ध हैं: हेडर में कुंजी, पहली पंक्ति में बेस URL, बॉडी में मॉडल आईडी। choices सरणी के साथ JSON उत्तर का मतलब है कि तीनों सही हैं, और आपका टूल जो कुछ अलग करता है वही समस्या है। यदि यह विफल होता है, तो एक बार में एक चीज बदलें:

• 401 → CheapTokens से प्राप्त कुंजी डालें और फिर से चलाएं।
• 404 → URL की ऊपर दिए गए URL से अक्षर-दर-अक्षर तुलना करें, फिर मॉडल आईडी की।

curl काम करने के बाद, वही तीन मान टूल में कॉपी करें: कुंजी, बेस URL (https://api.cheaptokens.dev/v1, या Anthropic SDK और Claude Code के लिए /v1 के बिना) और पूर्ण मॉडल आईडी।

यदि यह अभी भी काम नहीं करता#

• टूल में वही त्रुटि, curl ठीक है। टूल कहीं और से पुरानी कुंजी या URL पढ़ रहा है: दूसरी कॉन्फ़िग फ़ाइल, सहेजा गया प्रोफ़ाइल, एनवायरनमेंट वेरिएबल। बदलने के बाद टूल को पुनः आरंभ करें।
• सुनिश्चित नहीं कि मॉडल आईडी सही है। अपनी कुंजी के साथ GET /v1/models को कॉल करें और सूची से आईडी कॉपी करें।
• कनेक्शन अस्वीकृत, टाइमआउट, प्रमाणपत्र त्रुटियाँ। यह 401 या 404 नहीं है; सामान्य कनेक्शन त्रुटियाँ देखें।
• सुनिश्चित नहीं कि पहला अनुरोध कैसा दिखना चाहिए। आपका पहला API अनुरोध चरण-दर-चरण बताता है, और दस्तावेज़ में पूर्ण संदर्भ है।

रखने योग्य आदत: जब कोई कॉल विफल हो, तो पहले संख्या पढ़ें। 401 आमतौर पर कुंजी, 404 आमतौर पर पता या मॉडल आईडी, और curl इसे तय करता है। यह एक भी लॉग खोलने से पहले इनमें से अधिकांश त्रुटियों को सुलझा देता है।