पहले यह curl टेस्ट चलाएँ
कोड बदलने से पहले, अपने ऐप को बाहर रखें। यह एकमात्र कमांड एपीआई को न्यूनतम वैध अनुरोध भेजता है:
curl -i https://api.unrestrictedaiapi.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
GET /v1/models की कोई लागत नहीं है, इसलिए यह एक कुंजी की जाँच करने का सुरक्षित तरीका है। -i फ़्लैग स्टेटस लाइन और हेडर प्रिंट करता है।
- 200 और मॉडल सूची: कुंजी ठीक है। आपका ऐप कुछ अलग भेज रहा है, इसलिए एनवायरनमेंट वेरिएबल्स और बेस यूआरएल वाले अनुभागों पर जाएँ।
- 401: कुंजी या हेडर गलत है। अगले अनुभाग पर आगे बढ़ें।
- कनेक्शन या DNS त्रुटि: बेस यूआरएल गलत है, जो 401 से अलग समस्या है।
कुंजी को टेस्ट में हाथ से पेस्ट करें, वेरिएबल के माध्यम से नहीं। इससे एनवायरनमेंट को संदिग्धों की सूची से हटा दिया जाता है।
कारण 1: हेडर बिल्कुल सही नहीं है
एपीआई Authorization: Bearer <key> की उम्मीद करता है। छोटी-मोटी भूलें सभी LLM API त्रुटि 401 पैदा करती हैं:
Authorization: YOUR_KEYजिसमें Bearer शब्द गायब है।Authorization: Bearer: YOUR_KEYजिसमें अतिरिक्त कोलन है।Authorization: Bearer "YOUR_KEY"जिसमें वैल्यू के अंदर कोट्स हैं।Authorization: Bearer YOUR_KEYजिसमें दो स्पेस हैं।X-API-Keyयाapi-keyनाम का एक हेडर,Authorizationके बजाय। ये अन्य सेवाओं की रीति-रिवाज हैं।
यदि आप ओपनएआई एसडीके का उपयोग करते हैं, तो आप हेडर स्वयं नहीं लिखते। एसडीके इसे api_key आर्गुमेंट से बनाता है। यदि फिर भी 401 दिखता है, तो एसडीके को पास की गई वैल्यू समस्या है, हेडर फॉर्मेट नहीं।
कारण 2: कुंजी स्वयं क्षतिग्रस्त है
कुंजियाँ लंबी यादृच्छिक स्ट्रिंग्स होती हैं, इसलिए कॉपी करने की भूलें आम हैं और आँखों से पकड़ना मुश्किल है।
- ट्रेलिंग न्यूलाइन या स्पेस। टर्मिनल या टेक्स्ट फ़ाइल से कॉपी करने से अक्सर एक जोड़ दिया जाता है। कई एचटीटीपी लाइब्रेरीएँ तब एक अमान्य हेडर या एक ऐसी कुंजी भेजती हैं जो मेल नहीं खाती।
- ट्रंकेटेड कुंजी। डबल-क्लिक करने से केवल स्ट्रिंग का हिस्सा चुना जाता है यदि कुंजी में ऐसे वर्ण हैं जो शब्द चयन को तोड़ देते हैं। इसके बजाय API कुंजी पृष्ठ पर कॉपी बटन का उपयोग करें।
- स्मार्ट कोटेशन चिह्न। शब्द संसाधक या चैट ऐप के माध्यम से पेस्ट करने से सीधे कोटेशन चिह्न बड़े कोटेशन चिह्नों में बदल सकते हैं।
- पुरानी या घुमाई गई कुंजी। यदि आपने एक नई कुंजी बनाई है, तो पुरानी कुंजी अब वह नहीं हो सकती जिसे आप उपयोग कर रहे हैं।
पायथन में अदृश्य अक्षरों की जाँच करने के लिए, मान का repr प्रिंट करें:
import os
key = os.environ.get("API_KEY", "")
print(repr(key), len(key))
print(repr(key.strip()) == repr(key))
यदि दूसरी पंक्ति False प्रिंट करती है, तो आपके पास कुंजी के चारों ओर स्पेस है। इसे पढ़ते समय .strip() कॉल करें।
कारण 3: गलत बेस URL
मौजूदा ऐप को नए प्रदाता पर स्विच करते समय यह सबसे आम गलती है। आपकी कुंजी केवल उस होस्ट पर मान्य है जिसने इसे जारी किया था। इस साइट के लिए बेस URL है:
{"base_url": "https://api.unrestrictedaiapi.com/v1"}
दो विफलता पैटर्न बार-बार सामने आते हैं:
- आपने नई कुंजी सेट की लेकिन पुराना बेस URL छोड़ दिया। अनुरोध पुराने प्रदाता पर जाता है, जो एक ऐसी कुंजी को अस्वीकार करता है जिसे वह कभी नहीं देखता, और 401 लौटाता है। त्रुटि पाठ में फिर से पुराने प्रदाता का जिक्र आता है, जो एक उपयोगी संकेत है।
- आपने नया बेस URL सेट किया लेकिन वातावरण में पुरानी कुंजी छोड़ दी। अनुरोध हम तक पहुँचता है, और हम दूसरे प्रदाता की कुंजी को अस्वीकार करते हैं।
पथ की भी जाँच करें। बेस URL पहले से ही /v1 पर समाप्त होता है, इसलिए SDKs इसके साथ /chat/completions जोड़ते हैं। यदि आप URL स्वयं बनाते हैं, तो पूर्ण पथ /v1/chat/completions होता है, न कि /v1/v1/chat/completions।
कारण 4: वातावरण चर और कॉन्फ़िगरेशन फ़ाइलें
यदि curl काम करता है लेकिन आपका ऐप फेल होता है, तो इसका मतलब है कि ऐप को वह कुंजी मिल रही है जो आप सोचते हैं उससे अलग है।
- वेरिएबल एक्सपोर्ट नहीं किया गया। शेल में,
API_KEY=abc python app.pyकाम करता है, लेकिनAPI_KEY=abcअकेली लाइन पर बच्चे प्रक्रियाओं तक नहीं पहुँचता।exportका उपयोग करें। - अन्य मान द्वारा छायांकित। लाइब्रेरियाँ
OPENAI_API_KEYको स्वचालित रूप से पढ़ सकती हैं। यदि आपकी शेल प्रोफ़ाइल में एक पुरानी कुंजी सेट है, तो यह आपकी इच्छित कुंजी को ओवरराइड कर सकती है। - .env फ़ाइल में कोटेशन चिह्न। कुछ लोडर कोटेशन चिह्नों को मान का हिस्सा बनाए रखते हैं। यदि आपकी कुंजी कोटेशन चिह्नों में लिपटी हुई आती है, तो उन्हें हटा दें या ऊपर दिए गए repr जाँच का उपयोग करके परीक्षण करें।
- पुनः प्रारंभ नहीं किया गया। सर्वर और नोटबुक शुरू होने पर वातावरण चर पढ़ते हैं। संपादन के बाद पुनः प्रारंभ करें।
- उत्पादन में अलग वातावरण। कंटेनर, CI और होस्टिंग डैशबोर्ड का अपना चर भंडार होता है। लॉग में कुंजी की लंबाई प्रिंट करें, कुंजी स्वयं नहीं।
एक न्यूनतम पायथन जाँच जो कॉन्फ़िगरेशन को सिद्ध करती है
यह स्क्रिप्ट OpenAI SDK का उपयोग करती है और यदि प्रमाणीकरण विफल हो जाती है तो स्पष्ट रूप से रिपोर्ट करती है:
import os
from openai import OpenAI, AuthenticationError
client = OpenAI(
base_url="https://api.unrestrictedaiapi.com/v1",
api_key=os.environ["API_KEY"].strip(),
)
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Reply with the word ok."}],
max_tokens=5,
)
print("auth ok:", r.choices[0].message.content)
except AuthenticationError as e:
print("401:", e.status_code, e.response.headers.get("X-Request-Id"))
यदि यह X-Request-Id प्रिंट करता है, तो इसे लिखते समय सहायता में शामिल करें, क्योंकि यह टीम को आपका अनुरोध खोजने में मदद करता है। अन्य भाषाओं में यही जाँच पाँच भाषाओं के लिए क्विकस्टार्ट में उपलब्ध है।
401 बनाम अन्य त्रुटियाँ
यदि त्रुटि कुछ और है, तो प्रमाणीकरण पर समय न बर्बाद करें। एक संक्षिप्त मानचित्र:
| कोड | सामान्य अर्थ | कहाँ देखें |
|---|---|---|
| 401 | गायब या अमान्य कुंजी | हेडर, कुंजी, बेस URL |
| 429 | रेट लिमिट या अस्थायी ओवरलोड | बैक ऑफ़ करें और पुनः प्रयास करें; सीमाओं के लिए दस्तावेज़ देखें |
| 400 | दोषपूर्ण अनुरोध बॉडी | JSON, मॉडल का नाम, पैरामीटर |
| 404 | गलत पथ | बेस यूआरएल और एंडपॉइंट |
मॉडल नाम की भी जाँच करें। uncensored का उपयोग सटीक रूप से करें; गलत मॉडल ID एक अनुरोध त्रुटि है, 401 नहीं। API द्वारा स्वीकार किए जाने वाले एंडपॉइंट्स और हेडर सहित विवरण OpenAI-संगत API विनिर्देश पृष्ठ पर हैं।
प्रॉक्सी, ब्राउज़र और अंतिम उपाय
दो सेटअप ऐसे 401 त्रुटियाँ उत्पन्न करते हैं जो रहस्यमयी लगती हैं।
प्रॉक्सी और गेटवे
आपकी एप्लिकेशन और API के बीच एक रिवर्स प्रॉक्सी, API गेटवे या सर्वरलेस व्रैपर Authorization हेडर को छोड़ या रीराइट कर सकता है। curl से उसी मशीन से परीक्षण करें और तुलना करें। कुछ फ्रेमवर्क हेडर को केवल समान-उद्गम वाले होस्ट्स को ही आगे बढ़ाते हैं, इसलिए एक कस्टम fetch व्रैपर क्रॉस-ओरिजिन कॉल पर इसे चुपचाप खो सकता है।
फ्रंट-एंड कोड में कुंजियाँ
ब्राउज़र JavaScript से सीधे API को कॉल करने से आपकी कुंजी हर उस व्यक्ति के लिए खुली हो जाती है जो डेवलपर टूल्स खोलता है, और ब्राउज़र cross-origin कारणों से अनुरोध को ब्लॉक भी कर सकते हैं जो auth त्रुटियों जैसा दिखते हैं। कुंजी को सर्वर पर रखें, और अपने फ्रंट एंड को अपने एंडपॉइंट को कॉल करने दें, जो कुंजी को लगाकर API को कॉल करता है। यदि कुंजी कभी पब्लिक कोड या स्क्रीनशॉट में पेस्ट की गई थी, तो उसे बदल दें।
अभी भी फँसे हुए
यदि हाल ही में कॉपी की गई कुंजी curl परीक्षण में भी 401 लौटाती है, तो API कुंजी पृष्ठ से कुंजी को फिर से जनरेट करें, इसे सीधे कमांड में पेस्ट करें और एक बार फिर प्रयास करें। यदि वह विफल रहती है, तो सहायता को अनुरोध का समय, एंडपॉइंट और X-Request-Id प्रतिक्रिया हेडर भेजें। संदेश में पूर्ण कुंजी कभी न भेजें; पहली और आखिरी चार अक्षर इसे पहचानने के लिए पर्याप्त हैं।
