cursorapikey.com/मार्गदर्शिका
Cursor API कुंजी काम नहीं कर रही: कस्टम एंडपॉइंट समाधान
जब Cursor API कुंजी काम नहीं कर रही होती है, तो कारण लगभग हमेशा चार चीजों में से कोई एक होता है: बेस URL, मॉडल नाम, कुंजी स्वयं, या खाते पर कोई सीमा। एक एकल curl कमांड आपको बताता है कि कौन सा कारण है।
अपडेट किया गया


मुख्य बिंदु
- सबसे पहले curl के साथ Cursor के बाहर कुंजी का परीक्षण करें; यदि curl काम करता है, तो समस्या Cursor सेटिंग्स में है।
- बेस URL https://api.cursorapikey.com/v1 होना चाहिए और मॉडल का नाम बिल्कुल uncensored होना चाहिए।
- 401 का अर्थ है खराब कुंजी, 404 का अर्थ है खराब URL, 429 का अर्थ है रेट या कन्करेंसी लिमिट, और मॉडल त्रुटि का अर्थ है गलत नाम।
- मेनू लेबल्स Cursor के संस्करणों के बीच बदल जाते हैं, इसलिए सटीक शब्दावली के बजाय फ़ील्ड के उद्देश्य से मिलाएं।
चरण 1: Cursor के बाहर कुंजी का परीक्षण करें
Cursor को बाहर रखें। यदि एक साधारण अनुरोध काम करता है, तो आपकी कुंजी और खाता ठीक हैं और दोष एडिटर सेटिंग्स में है। यदि यह विफल होता है, तो त्रुटि बॉडी समस्या का नाम बताती है।
curl -i https://api.cursorapikey.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}]}'
-i फ्लैग स्टेटस लाइन और हेडर प्रिंट करता है। एक 200 स्टेटस और एक choices एरे सफलता को दर्शाता है। X-Balance-USD हेडर आपके शेष क्रेडिट दिखाता है, जो यदि आपको प्रमाणीकरण या भुगतान त्रुटि मिलती है तो जांचने वाली पहली चीज है।
आप मॉडल की सूची भी बना सकते हैं, जो कुछ भी खर्च किए बिना कुंजी की पुष्टि करता है:
curl https://api.cursorapikey.com/v1/models -H "Authorization: Bearer YOUR_KEY" | grep uncensored
प्रतिक्रिया में मॉडल ID uncensored होनी चाहिए।
चरण 2: Cursor में फ़ील्ड सेट करें
Cursor की सेटिंग्स खोलें और मॉडल अनुभाग खोजें। आपको तीन मानों की आवश्यकता है, और उनमें से किसी भी एक में गलती एक विफलता उत्पन्न करती है जो टूटी हुई कुंजी जैसी दिखती है।
- OpenAI API कुंजी: अपनी कुंजी बिना किसी स्पेस या लाइन ब्रेक के दोनों सिरों पर पेस्ट करें।
- OpenAI बेस URL ओवरराइड करें: ओवरराइड को चालू करें और
https://api.cursorapikey.com/v1दर्ज करें।/v1बनाए रखें और/chat/completionsहटा दें। - कस्टम मॉडल:
uncensoredनाम का एक मॉडल जोड़ें और उसे सक्षम करें। उन मॉडल्स को अक्षम करें जिनका आप उपयोग नहीं करते ताकि Cursor उस मॉडल को न चुने जो एंडपॉइंट को नहीं पता है।
सहेजने के बाद, यदि आपका संस्करण एक सत्यापन विकल्प प्रदान करता है तो उसका उपयोग करें, फिर चैट मॉडल ड्रॉपडाउन में uncensored चुनें। एक नई चैट टैब एक अच्छा परीक्षण है, क्योंकि एक पुरानी टैब उसी मॉडल को रख सकती है जिसके साथ वह शुरू हुई थी। Cursor API का उपयोग कैसे करें में दिखाया गया चरण-दर-चरण मार्गदर्शिका समान सेटअप अधिक संदर्भ के साथ दिखाती है।
त्रुटि को समाधान से मिलाएं
| आपको क्या दिखता है | संभावित कारण | समाधान |
|---|---|---|
| 401, "अमान्य कुंजी", "अधिकृत नहीं" | कुंजी गलत टाइप की गई, ट्रंकेट की गई या रद्द कर दी गई | इसे कुंजी पृष्ठ से फिर से कॉपी करें; अंत में स्पेस के लिए जांचें |
| 404, "नहीं मिला" | गलत URL, /v1 अनुपस्थित है, या दोहराया गया पथ | बिल्कुल https://api.cursorapikey.com/v1 का उपयोग करें |
| "मॉडल नहीं मिला" या इसी तरह | मॉडल का नाम uncensored से भिन्न है | उस सटीक नाम, छोटे अक्षरों में कस्टम मॉडल जोड़ें |
429 rate_limited के साथ | प्रति मिनट अनुरोधों की सीमा से अधिक | गति कम करें; ट्रायल कुंजियाँ प्रति मिनट 60 की अनुमति देती हैं, पूर्ण कुंजियाँ 300 |
429 concurrency के साथ | एक साथ बहुत सारे अनुरोध | समानांतर एजेंट रन कम करें; ट्रायल 2, पूर्ण कुंजी 8 |
429 Retry-After: 5 के साथ | अस्थायी ओवरलोड | पाँच सेकंड प्रतीक्षा करें और पुनः प्रयास करें |
| curl में काम करता है, Cursor में विफल | सेटिंग सहेजी नहीं गई, गलत टैब मॉडल, या वह सुविधा जो कस्टम कुंजियों का उपयोग नहीं करती | अगले खंड को देखें |
विफल या अस्वीकृत अनुरोधों के लिए कोई शुल्क नहीं लगाया जाता है, इसलिए डिबगिंग के दौरान पुन: प्रयास करने में कुछ नहीं खर्च होता।
जब curl काम करता है लेकिन Cursor अभी भी विफल रहता है
यह सबसे भ्रमित करने वाला मामला है, और इसके कुछ सामान्य कारण हैं।
गलत मॉडल चयनित है। Cursor अपनी स्वयं की बिल्ट-इन मॉडल सूची में रखता है। यदि उनमें से कोई चयनित है, तो अनुरोध आपके एंडपॉइंट पर बिल्कुल नहीं जाता है। चैट या कंपोजर के ड्रॉपडाउन में uncensored स्पष्ट रूप से चयनित करें।
हर सुविधा आपकी कुंजी का उपयोग नहीं करती। ऐसी सुविधाएँ जो Cursor के अपने मॉडल पर निर्भर करती हैं, जैसे इनलाइन स्वतः पूर्ण, आपकी जोड़ी गई कुंजी के बावजूद उनका उपयोग जारी रख सकती हैं। कस्टम कुंजियाँ तब लागू होती हैं जब आप मॉडल चुन सकें, जो चैट और संपादन मोड हैं। Cursor की वर्तमान दस्तावेज़ीकरण जांचें, क्योंकि यह रिलीज़ के बीच बदल जाता है।
समानांतर अनुरोध एजेंट मोड से। एजेंट और मल्टी-स्टेप रन एक साथ कई अनुरोध भेज सकते हैं। ट्रायल कुंजी एक समय में दो अनुरोधों की अनुमति देती है। यदि त्रुटियाँ केवल एजेंट मोड में दिखाई देती हैं, तो आप संभवतः concurrency सीमा को छू रहे हैं, और एक पूर्ण कुंजी इसे आठ तक बढ़ा देती है। एक स्ट्रीम किए गए अनुरोध में अपनी स्लॉट तब तक बनी रहती है जब तक कि स्ट्रीम समाप्त न हो जाए, इसलिए लंबे आउटपुट स्लॉट्स को अधिक समय तक घेरते हैं।
फ़ंक्शन कॉलिंग। API tool_calls स्ट्रीम किए जाने और परिणामों को role: "tool" के रूप में वापस पास किए जाने के साथ टूल कॉलिंग का समर्थन करता है। टूल उपयोग की गुणवत्ता मॉडल पर निर्भर करती है, इसलिए यदि एजेंट रन किसी टूल चरण पर अटक जाता है, तो पहले साधारण चैट में उसी कार्य का प्रयास करें।
खाते की स्थिति जांचें
यदि curl संतुलन के बारे में एक त्रुटि लौटाता है, तो कुंजी मान्य है लेकिन क्रेडिट खाली है या ट्रायल समाप्त हो गया है। ट्रायल $0.50 है, जो 7 दिनों के लिए मान्य है, और इसे साइन-अप के बाद API कुंजी पृष्ठ पर एक क्लिक से दावा किया जाता है। उसके बाद आपको एक टॉप-अप की आवश्यकता होगी।
टॉप-अप $20 से $500 तक की पूर्ण राशि होती है, जिसमें $50 से +5%, $100 से +10% और $200 से +15% मिलता है। आप क्रिप्टो (TRC20 पर USDT, Base पर USDC) से भुगतान कर सकते हैं। मूल्य सूची पेज पर तालिका दी गई है। यदि आपके पास अभी तक API कुंजी नहीं है, तो यहाँ से प्राप्त करें।
प्रत्येक टूल के लिए एक कुंजी रखें। यदि आपने एक कुंजी कई एडिटरों और स्क्रिप्ट्स में पेस्ट कर दी है, तो रेट लिमिट उनके बीच साझा किए जाते हैं, जिससे यादृच्छिक विफलताएं प्रतीत हो सकती हैं।
अटल मामले के लिए स्क्रिप्ट जाँच
यदि आप अभी भी कारण नहीं ढूंढ पाते हैं, तो एक छोटा स्क्रिप्ट चलाएँ जो एडिटर द्वारा किए गए काम की नकल करता है। यह OpenAI SDK का उपयोग करता है, जिस पर Cursor-शैली क्लाइंट्स को मॉडल किया गया है, और यह सटीक त्रुटि ऑब्जेक्ट प्रिंट करता है।
from openai import OpenAI, APIStatusError
client = OpenAI(base_url="https://api.cursorapikey.com/v1", api_key="YOUR_KEY")
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write a one-line Python hello world."}],
stream=True,
)
for chunk in r:
print(chunk.choices[0].delta.content or "", end="")
except APIStatusError as e:
print(e.status_code, e.response.headers.get("X-Request-Id"))
print(e.response.text)
यदि स्क्रिप्ट टेक्स्ट स्ट्रीम कर रहा है, तो एंडपॉइंट, कुंजी और मॉडल सही हैं, और शेष समस्या एक Cursor सेटिंग है। यदि यह स्टेटस कोड प्रिंट करता है, तो ऊपर दी गई तालिका का उपयोग करें। सहायता से संपर्क करते समय X-Request-Id मान रखें, क्योंकि यह विशिष्ट अनुरोध की पहचान करता है। पूर्ण पैरामीटर विवरण दस्तावेज़ पृष्ठ पर उपलब्ध हैं।
इसे फिर से टूटने से बचाएं
कुछ आदतें अधिकांश दोहराए जाने वाली समस्याओं को रोकती हैं। कुंजी को एक पासवर्ड मैनेजर प्रविष्टि में सहेजें और वहाँ से कॉपी करें, न कि चैट लॉग्स या नोट्स से जहाँ लाइन ब्रेक छिप जाते हैं। एडिटर अपडेट के बाद उन्हें फिर से दर्ज करने के लिए तीन मानों (बेस URL, कुंजी, मॉडल नाम) को लिखें, क्योंकि अपडेट कभी-कभी ओवरराइड्स को रीसेट कर देते हैं। प्रत्येक अपडेट के बाद, वास्तविक कार्य शुरू करने से पहले एक छोटा चैट संदेश भेजें।
बैलेंस की निगरानी करें। X-Balance-USD हेडर प्रत्येक प्रतिक्रिया पर लौटाया जाता है, और आप इसे GET /v1/balance से भी पढ़ सकते हैं। क्रेडिट कभी समाप्त नहीं होता है, इसलिए खाते में रहने वाला छोटा टॉप-अप बर्बाद नहीं होगा। यदि आप कुंजी का उपयोग स्क्रिप्ट और संपादक दोनों से करते हैं, तो लंबी बैच जॉब्स के लिए एक रीट्राई लूप दें जो 429 पर पांच सेकंड प्रतीक्षा करे और कुछ प्रयासों के बाद रुक जाए, ताकि स्क्रिप्ट आपके संपादक के समानांतर अनुरोध स्लॉट्स को भूखा न रखे।
लागत जाँच और आगे क्या पढ़ें
फ़ाइल संदर्भ के 10,000 टोकन और 700-टोकन उत्तर वाले कोडिंग चैट अनुरोध के लिए इनपुट की लागत 10,000 / 1,000,000 x $0.15 = $0.0015 और आउटपुट की लागत 700 / 1,000,000 x $0.50 = $0.00035 होती है, कुल मिलाकर लगभग $0.00185। दरें 1M इनपुट टोकन के लिए $0.15 और 1M आउटपुट टोकन के लिए $0.50 हैं। Cursor API मूल्य निर्धारण पर लेख मासिक अनुमान कवर करता है।
यदि विफल अनुरोध बड़ा था, तो विंडो को याद रखें: प्रॉम्प्ट और कंप्लीशन को 100,000 टोकन में फिट होना चाहिए, और अनुरोध बॉडी 8 MB तक सीमित है। एक पूरे रिपॉजिटरी को चैट में जोड़ने से दोनों सीमाएं पार हो सकती हैं। कॉन्टेक्स्ट को केवल उन फ़ाइलों तक सीमित करें जो महत्वपूर्ण हैं और फिर से प्रयास करें।
अधिक गाइड
प्रश्न और उत्तर
Cursor मेरी API कुंजी को अमान्य क्यों कहता है?
आमतौर पर कुंजी में एक अतिरिक्त स्पेस है या इसे आंशिक रूप से कॉपी किया गया था, या बेस URL अभी भी किसी अन्य सेवा की ओर इशारा कर रहा है। कुंजी को फिर से कॉपी करें, फिर पुष्टि करें कि ओवरराइड URL https://api.cursorapikey.com/v1 है।
मुझे कौन सा मॉडल नाम दर्ज करना चाहिए?
uncensored, छोटे अक्षरों में दर्ज करें। यह एकमात्र मॉडल ID है जो API प्रदान करती है।
ऑटोकम्प्लीट मेरी कुंजी का उपयोग करता है?
जरूरी नहीं। कुछ Cursor फीचर्स Cursor के अपने मॉडल्स का उपयोग करते हैं, और कस्टम कुंजियाँ मुख्य रूप से चैट और एडिट मोड्स पर लागू होती हैं जहाँ आप मॉडल चुनते हैं।
क्या विफल अनुरोधों का शुल्क लगाया जाता है?
नहीं। विफल या अस्वीकृत अनुरोधों के लिए शुल्क नहीं लिया जाता है, इसलिए डीबग करते समय रीट्राई करने में कोई लागत नहीं आती।
आपकी कुंजी बस एक फ़ॉर्म दूर है
एक खाता बनाएँ, कुंजी कॉपी करें, बेस URL बदलें। सेटअप यही है।