HI ▾
API कुंजी पाएँ

cursorapikey.com/मार्गदर्शिका

कस्टम एंडपॉइंट के साथ Cursor API कुंजी का उपयोग कैसे करें

यहाँ बताया गया है कि अपने कस्टम एंडपॉइंट के साथ Cursor API सेटिंग्स का उपयोग कैसे करें: एक कुंजी पेस्ट करें, OpenAI बेस URL को ओवरराइड करें, और मॉडल नाम uncensored जोड़ें। नीचे दिए गए चरणों में लगभग पाँच मिनट लगते हैं और इसमें एक curl जाँच शामिल है जिसे आप पहले चला सकते हैं।

अपडेट किया गया

एक सर्वर क्यूब से चमकदार केबल द्वारा जुड़ा हुआ आइसोमेट्रिक कोड एडिटर, जो एक कस्टम API एंडपॉइंट को दर्शाता है

मुख्य बिंदु

  • Cursor आपको OpenAI बेस URL और कुंजी को ओवरराइड करने देता है, इसलिए कोई भी OpenAI-संगत एंडपॉइंट अनुरोधों की सेवा कर सकता है।
  • बेस URL https://api.cursorapikey.com/v1 और मॉडल ID uncensored का उपयोग करें।
  • एडिटर को छूने से पहले curl के साथ कुंजी का परीक्षण करें, ताकि आपको पता चले कि विफलता किस पक्ष से आ रही है।
  • एक 20,000-टोकन वाले प्रॉम्प्ट और 1,000-टोकन वाले उत्तर की लागत $0.0035 है।

यह मार्गदर्शिका क्या कवर करती है

वे लोग जो Cursor API का उपयोग कैसे करें, यह खोजते हैं, उनका अर्थ आमतौर पर दो में से एक होता है। या तो वे कोड से कुछ Cursor सेवा को कॉल करना चाहते हैं, या वे चाहते हैं कि Cursor एडिटर अपने मॉडल अनुरोधों को एक ऐसे एंडपॉइंट पर भेजे जिसे वे चुनते हैं। यह मार्गदर्शिका दूसरे मामले के बारे में है। यह साइट एक स्वतंत्र होस्टेड API है जो OpenAI चैट कंप्लीशन्स प्रोटोकॉल बोलता है, इसलिए Cursor इससे उसी तरह बात कर सकता है जैसे यह किसी भी OpenAI-शैली के सर्वर से बात करता है।

इसके पीछे का मॉडल एक अकेला ओपन-वेट मॉडल है, जिसे एक स्वतंत्र प्रदाता द्वारा चलाया जाता है और वयस्कों के कानूनी उपयोग के लिए सामग्री अस्वीकार किए बिना उत्तर देने के लिए ट्यून्ड किया गया है। यह एक आधिकारिक Cursor मॉडल नहीं है, और यह विक्रेताओं के बीच एक राउटर नहीं है। यह केवल पाठ संभालता है। कोडिंग के लिए यह आमतौर पर पर्याप्त है: आप कोड और निर्देश भेजते हैं, आपको कोड और व्याख्याएँ वापस मिलती हैं।

आपको तीन चीज़ों की ज़रूरत है: एक API कुंजी, बेस URL https://api.cursorapikey.com/v1, और मॉडल ID uncensored। बाकी सब एडिटर में सही फ़ील्ड ढूँढने का मामला है।

चरण 1: एक कुंजी प्राप्त करें और curl से जाँचें

Google या ईमेल और पासवर्ड से साइन अप करें, फिर API कुंजी पेज खोलें। नए खातों के पास वहाँ एक क्लिक से $0.50 का मुफ़्त ट्रायल क्रेडिट दावा करने का विकल्प होता है। इसके लिए कार्ड की ज़रूरत नहीं है और यह 7 दिनों तक मान्य रहता है। ट्रायल कुंजी 2 समानांतर अनुरोधों और प्रति मिनट 60 अनुरोधों तक सीमित है, जो एडिटर में पहले सत्र के लिए पर्याप्त है।

Cursor खोलने से पहले, सुनिश्चित करें कि कुंजी काम कर रही है। एक टर्मिनल में, अपनी कुंजी को एक एन्वायरनमेंट वेरिएबल के रूप में सेट करके यह चलाएँ:

export API_KEY="paste-your-key-here"

curl https://api.cursorapikey.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

curl https://api.cursorapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "user", "content": "Write a Python function that reverses a linked list."}
    ]
  }'

पहला कॉल मॉडल की सूची दिखाता है। दूसरा एक सामान्य चैट कंप्लीशन लौटाता है। यदि दोनों सफल होते हैं, तो एडिटर में बाद की कोई भी विफलता सेटिंग्स की समस्या है, कुंजी की नहीं। यह अलगाव बहुत सारा अनुमान लगाने का समय बचाता है।

चरण 2: Cursor में बेस URL और कुंजी सेट करें

Cursor की सेटिंग्स खोलें और मॉडल सेक्शन पर जाएं। रिलीज के बीच मेनू के नाम और लेआउट बदल सकते हैं, इसलिए नीचे दिए गए लेबल को एक मैप के रूप में देखें और यदि कुछ स्थानांतरित हो गया हो तो Cursor की अपनी प्रलेखन जांचें।

  1. एक OpenAI API कुंजी के लिए फ़ील्ड खोजें और इस साइट से अपनी कुंजी पेस्ट करें।
  2. OpenAI बेस URL को ओवरराइड करने के विकल्प को सक्षम करें और https://api.cursorapikey.com/v1 दर्ज करें। अंत में /v1 रखें और /chat/completions न जोड़ें; क्लाइंट ऐप पथ को स्वयं जोड़ देता है।
  3. एक कस्टम मॉडल जोड़ें और uncensored ठीक वैसा ही टाइप करें, छोटे अक्षरों में।
  4. यदि एडिटर एक सत्यापन या सहेजने का बटन प्रदान करता है तो उसका उपयोग करें, फिर चैट पैनल में नए मॉडल को चुनें।

एक फ़ाइल खोलकर "इस फ़ंक्शन को समझाएँ" जैसे एक छोटे संदेश को भेजें। एक स्ट्रीमिंग उत्तर का अर्थ है कि रूट एंड-टू-एंड काम कर रहा है। Cursor अनुरोध भेजता है, एंडपॉइंट टोकन को SSE के माध्यम से वापस स्ट्रीम करता है, और एडिटर उन्हें आने पर ही रेंडर करता है।

दो सावधानियां। कुछ एडिटर फीचर्स, जैसे कि इन्लाइन टैब कंप्लीशन, वे मॉडल्स पर चल सकते हैं जिन पर Cursor का नियंत्रण होता है और वे आपकी कुंजी को अनदेखा कर सकते हैं, इसलिए जांचें कि कौन से फीचर्स वास्तव में कस्टम मॉडल का उपयोग करते हैं। और चूंकि Cursor कस्टम-कुंजी ट्रैफ़िक को अपने सर्वरों के माध्यम से रूट कर सकता है, यदि आपको यह जानने की आवश्यकता है कि आपका कोड कहाँ जाता है, तो उसकी वर्तमान प्रलेखन पढ़ें। इस साइट पर quickstart अनुबंध के API पक्ष की सूची बनाता है।

कोड से समान एंडपॉइंट का परीक्षण करें

किसी समस्या को अलग करने का सबसे आसान तरीका आधिकारिक OpenAI SDK के साथ एंडपॉइंट को कॉल करना है। यदि वह काम करता है, तो एंडपॉइंट ठीक है और कोई भी शेष समस्या एडिटर कॉन्फ़िगरेशन में है।

from openai import OpenAI

client = OpenAI(
    api_key="paste-your-key-here",
    base_url="https://api.cursorapikey.com/v1",
)

stream = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a terse senior engineer."},
        {"role": "user", "content": "Refactor this loop into a list comprehension: out = []\nfor x in xs:\n    if x > 0:\n        out.append(x * 2)"},
    ],
    stream=True,
)

for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Node में वही चीज़:

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.API_KEY,
  baseURL: "https://api.cursorapikey.com/v1",
});

const res = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write a regex that matches ISO 8601 dates." }],
});

console.log(res.choices[0].message.content);

स्ट्रीमिंग रिस्पॉन्स में अंत में उपयोग शामिल होता है, इसलिए आप यह लॉग कर सकते हैं कि एक अनुरोध में कितने टोकन का उपयोग हुआ। प्रत्येक रिस्पॉन्स में एक X-Balance-USD हेडर होता है जिसमें आपका शेष क्रेडिट होता है और एक X-Request-Id होता है जिसे आप तब उद्धृत कर सकते हैं यदि कुछ गलत दिखे।

कोडिंग वर्कफ़्लो में क्या काम करता है

API स्ट्रीमिंग, JSON मोड और टूल कॉलिंग (tools, tool_choice, स्ट्रीम्ड tool_calls, और परिणाम role: "tool" के रूप में वापस भेजे जाने) का समर्थन करता है। temperature, top_p, stop, seed जैसे सैम्पलिंग सेटिंग्स और पेनल्टीज़ पास किए जाते हैं। कॉन्टेक्स्ट विंडो 100,000 टोकन का है, जो प्रॉम्प्ट और कंप्लीशन के बीच साझा किया जाता है, और max_tokens वैकल्पिक है।

वह 100,000 टोकन कोड के लिए एक उदार बजट है। कुछ सौ पंक्तियों का एक स्रोत फ़ाइल कुछ हजार टोकन है, इसलिए आप कई फ़ाइलों के साथ एक लंबे निर्देश को शामिल कर सकते हैं और उत्तर के लिए जगह छोड़ सकते हैं। अधिकतम अनुरोध बॉडी 8 MB है, जिस तक आप टेक्स्ट के साथ नहीं पहुँचेंगे।

कुछ आदतें जो एडिटर में एक कस्टम मॉडल को सुखद बनाती हैं:

  • कोड एडिट्स के लिए एक कम temperature रखें। 0.2 के आसपास के मान स्थिर आउटपुट देते हैं; केवल ब्रेनस्टॉर्मिंग के लिए इसे बढ़ाएं।
  • केवल उन फ़ाइलों को संलग्न करें जिनकी ज़रूरत है। आपका प्रत्येक टोकन इनपुट के रूप में बिल किया जाता है, और प्रत्येक टर्न पर पूरी बातचीत फिर से भेजी जाती है।
  • जब फ़ाइल लंबी हो तो पूरी फ़ाइल के बजाय डिफ़ या बदले हुए फ़ंक्शन के लिए पूछें। आउटपुट टोकन इनपुट टोकन से अधिक खर्च करते हैं।
  • उन कार्यों के लिए मॉडल का उपयोग करें जहाँ रिफ्यूज़ल बाधा डालते हैं, जैसे अपने स्वयं के लैब के लिए एक्सप्लॉइट प्रूफ-ऑफ-कॉन्सेप्ट लिखना, मालवेयर नमूनों का विश्लेषण करना जिनका अध्ययन करने की आपको अनुमति है, या बुरी वास्तविक दुनिया की सामग्री की नकल करने वाले टेस्ट डेटा को जनरेट करना। ये सभी कानूनी होने चाहिए।

एक कठोर सीमा जिसे दोहराना मूल्यवान है: नाबालिगों से जुड़ी यौन सामग्री किसी भी रूप में नहीं।

सामान्य त्रुटियों को ठीक करना

लक्षणसंभावित कारणसमाधान
401 या "अमान्य कुंजी"कुंजी स्पेस के साथ पेस्ट की गई, या पुरानी कुंजीकुंजी पृष्ठ से पुनः कॉपी करें; curl के साथ परीक्षण करें
404 या "मॉडल नहीं मिला"मॉडल का नाम अलग टाइप किया गयाuncensored का उपयोग करें, लोअरकेस में, बिना किसी सफ़िक्स के
पथ पर 404बेस URL में /chat/completions शामिल हैबेस URL को /v1 पर समाप्त करें
429 के साथ concurrencyएक साथ बहुत सारे अनुरोधस्ट्रीम के समाप्त होने की प्रतीक्षा करें; एक पूर्ण कुंजी 8 की अनुमति देती है, एक ट्रायल कुंजी 2
429 के साथ rate_limitedप्रति मिनट 300 से अधिक अनुरोध (ट्रायल पर 60)गति कम करें, या विलंब के बाद पुनः प्रयास करें
429 के साथ Retry-After: 5अस्थायी ओवरलोडपांच सेकंड बाद पुनः प्रयास करें

एक स्ट्रीम किए गए अनुरोध में समानांतर अनुरोध स्लॉट स्ट्रीम समाप्त होने तक बनी रहती है। यदि आप Cursor में कई चैट शुरू करते हैं और उन्हें जनरेट करने के लिए छोड़ देते हैं, तो आप एक ट्रायल कुंजी पर समानांतरता सीमा तक जल्दी पहुँच सकते हैं। विफल या अस्वीकृत अनुरोधों के लिए शुल्क नहीं लगाया जाता है, इसलिए पुनः प्रयास करने में कोई अतिरिक्त लागत नहीं आती।

एक कोडिंग सत्र की लागत

मूल्य निर्धारण 1M इनपुट टोकन के लिए $0.15 और 1M आउटपुट टोकन के लिए $0.50 है, जो प्रीपेड क्रेडिट से भुगतान किया जाता है, कोई सदस्यता नहीं। एक सामान्य एडिटर अनुरोध में एक बड़ा प्रॉम्प्ट (आपकी फ़ाइलें) और एक छोटा उत्तर होता है। 20,000 इनपुट टोकन और 1,000 आउटपुट टोकन लें:

  • इनपुट: 20,000 x $0.15 / 1,000,000 = $0.0030
  • आउटपुट: 1,000 x $0.50 / 1,000,000 = $0.0005
  • कुल: $0.0035 प्रति अनुरोध

काम के दिन में 100 अनुरोधों पर यह $0.35 है। $0.50 का ट्रायल क्रेडिट लगभग 140 ऐसे अनुरोधों को कवर करता है। ट्रायल के बाद आप $20 से $500 तक किसी भी पूर्णांक राशि को टॉप-अप कर सकते हैं, $50 से +5% बोनस क्रेडिट, $100 से +10% और $200 से +15%। क्रिप्टो (TRC20 पर USDT, Base पर USDC) से भुगतान करें। क्रेडिट कभी एक्सपायर नहीं होता, इसलिए धीरे-धीरे उपयोग किया गया टॉप-अप बर्बाद नहीं होता। मूल्य निर्धारण पेज पर पूरी तालिका है, और Cursor और Copilot विकल्प वाला पेज समझाता है कि यह सब्सक्रिप्शन एडिटर के बगल में कहाँ फिट बैठता है।

प्रॉम्प्ट को प्रशिक्षण के लिए उपयोग नहीं किया जाता है।

01

प्रश्न और उत्तर

क्या यह Cursor एजेंट और टूल कॉलिंग के साथ काम करता है?

API फ़ंक्शन कॉलिंग को टूल्स, tool_choice और स्ट्रीमिंग tool_calls के साथ सपोर्ट करता है। किसी दिए गए Cursor फीचर द्वारा आपके कस्टम मॉडल का उपयोग करना एडिटर पर निर्भर करता है, इसलिए सेटअप के बाद प्रत्येक फीचर का परीक्षण करें।

मुझे कौन सा मॉडल नाम दर्ज करना चाहिए?

uncensored दर्ज करें, लोअरकेस में। यह एकमात्र मॉडल ID है, और GET /v1/models इसे सूचीबद्ध करता है।

क्या यह आधिकारिक Cursor API है?

नहीं। यह एक ओपन-वेट मॉडल के सामने एक स्वतंत्र OpenAI-अनुकूल API है। Cursor बस आपको अपनी OpenAI सेटिंग्स को एक अलग एंडपॉइंट की ओर इशारा करने देता है।

इसे आज़माने के लिए कार्ड की आवश्यकता है?

नहीं। $0.50 का ट्रायल क्रेडिट साइन-अप के बाद API कुंजी पृष्ठ पर एक क्लिक से दावा किया जाता है, जिसमें कार्ड की आवश्यकता नहीं होती और यह 7 दिनों के लिए मान्य है।

आपकी कुंजी बस एक फ़ॉर्म दूर है

एक खाता बनाएँ, कुंजी कॉपी करें, बेस URL बदलें। सेटअप यही है।