Codex VS Code API कुंजी: कस्टम एंडपॉइंट का उपयोग करें

आप क्या सेटअप कर रहे हैं

VS Code में कोडिंग सहायक HTTP के माध्यम से मॉडल से बात करते हैं। अधिकांश OpenAI API प्रारूप का पालन करते हैं, जिसका अर्थ है कि वे विकर्ता के डिफ़ॉल्ट के बजाय एक कस्टम बेस URL और कुंजी स्वीकार करते हैं। यह सेवा OpenAI-संगत है, इसलिए यह उस विकल्प को प्रदान करने वाले किसी भी टूल में जुड़ जाती है।

स्पष्ट रहें कि दूसरी ओर क्या है। यह एक ओपन-वेट मॉडल है जो एक स्वतंत्र प्रदाता द्वारा चलाया जाता है, कानूनी वयस्क उपयोग के लिए बिना सेंसर उत्तर देने के लिए ट्यून किया गया है। यह OpenAI का Codex मॉडल नहीं है और न ही किसी अन्य विक्रेता का आधिकारिक API है। यह केवल टेक्स्ट है, 100,000-टोकन विंडो, फ़ंक्शन कॉलिंग और JSON मोड के साथ। यदि आप OpenAI-शैली के एंडपॉइंट्स की विवरण चाहते हैं, तो दस्तावेज़ पढ़ें; यदि आपको केवल पता चाहिए, तो Codex API बेस URL पृष्ठ देखें।

यहाँ उन तीन मानों को दिया गया है जिन्हें हर जगह उपयोग करें:

एक कुंजी प्राप्त करें और पहले इसे परीक्षण करें

Google या ईमेल और पासवर्ड के साथ API कुंजी पृष्ठ पर एक खाता बनाएं। नए उपयोगकर्ता एक क्लिक के साथ $0.50 का मुफ़्त ट्रायल क्रेडिट दावा कर सकते हैं, जो 7 दिनों के लिए मान्य है, कार्ड की आवश्यकता नहीं है। फिर VS Code को छूने से पहले टर्मिनल में कुंजी का परीक्षण करें। एक काम करने वाला curl कॉल कुंजी और URL को साबित करता है, इसलिए बाद के त्रुटियां एक्सटेंशन के बारे में होती हैं।

Copy# macOS or Linux, add to ~/.zshrc or ~/.bashrc
export CODEX_API_KEY="YOUR_KEY"

# then verify the endpoint answers
curl https://api.getcodexapi.com/v1/chat/completions \
  -H "Authorization: Bearer $CODEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Write a Python one-liner that reverses a string."}]}'

प्रतिक्रिया चैट पूर्णता JSON है, और प्रतिक्रिया में X-Balance-USD हेडर होता है जिसमें आपका शेष क्रेडिट होता है। कुंजी को एक एन्वायरमेंट वेरिएबल या एक्सटेंशन के सीक्रेट स्टोरेज में रखें, कभी भी रिपॉजिटरी में नहीं।

Codex एक्सटेंशन और CLI: कॉन्फ़िगरेशन फ़ाइल

OpenAI का Codex टूलिंग आपके होम डायरेक्टरी में एक TOML कॉन्फ़िगरेशन फ़ाइल के माध्यम से कस्टम मॉडल प्रदाताओं का समर्थन करता है, और VS Code एक्सटेंशन को दस्तावेज़ किया गया है कि वह उस कॉन्फ़िगरेशन को CLI के साथ साझा करता है। अपने संस्करण के लिए वर्तमान Codex दस्तावेज़ों के खिलाफ इसकी पुष्टि करें, क्योंकि प्रारूप विकसित हुआ है।

Copy# ~/.codex/config.toml
model = "uncensored"
model_provider = "custom"

[model_providers.custom]
name = "Custom endpoint"
base_url = "https://api.getcodexapi.com/v1"
env_key = "CODEX_API_KEY"
wire_api = "chat"

जांचने के बिंदु:

• base_url /v1 पर समाप्त होता है, बिना /chat/completions के।
• env_key एनवायरनमेंट वेरिएबल का नाम है, कुंजी स्वयं नहीं।
• wire_api अनुरूप प्रारूप चुनता है। यह सेवा POST /v1/chat/completions और POST /v1/responses दोनों स्वीकार करती है। पहले "chat" आज़माएं; यदि आपका Codex संस्करण इसे आवश्यकता करता है तो "responses" का उपयोग करें।
• शेल से VS Code शुरू करें जिसमें चर सेट है, या प्रोफ़ाइल में चर जोड़ने के बाद इसे पुनः आरंभ करें। macOS पर एक GUI लॉन्च अक्सर शेल एक्सपोर्ट नहीं देखता है।

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

Continue, Cline और अन्य एक्सटेंशन

तृतीय-पक्ष एक्सटेंशन में अपना स्वयं का स्क्रीन होता है, लेकिन पैटर्न स्थिर है: एक OpenAI या "OpenAI-संगत" प्रदाता चुनें, फिर बेस URL, कुंजी और मॉडल भरें। Continue एक YAML कॉन्फ़िगरेशन का उपयोग करता है:

Copy# Continue (config.yaml), model entry
models:
  - name: Hosted uncensored
    provider: openai
    model: uncensored
    apiBase: https://api.getcodexapi.com/v1
    apiKey: YOUR_KEY

Cline और Roo Code अपने सेटिंग्स पैनल में "OpenAI Compatible" प्रदाता प्रदान करते हैं जिसमें वही तीन फ़ील्ड होते हैं। नाम और मेनू अक्सर बदलते हैं, इसलिए "OpenAI compatible" या "custom base URL" के लिए एक्सटेंशन के अपने दस्तावेज़ों में खोजें। यदि किसी एक्सटेंशन में बेस URL के लिए कोई फ़ील्ड नहीं है, तो वह इस एंडपॉइंट का उपयोग नहीं कर सकता है।

समय बचाने के टिप्स:

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

कौन से एडिटर कार्य इस मॉडल के लिए उपयुक्त हैं

एक सामान्य टेक्स्ट मॉडल जिसकी विंडो बड़ी है, कई दैनिक कार्यों के लिए उपयुक्त है: अज्ञात कोड की व्याख्या करना, एक फ़ंक्शन के लिए यूनिट टेस्ट लिखना, एक स्क्रिप्ट को भाषाओं के बीच परिवर्तित करना, डॉकस्ट्रिंग्स और रेगेक्स तैयार करना, और जब आप पूरा फ़ाइल पेस्ट करते हैं तो एक मॉड्यूल को फिर से लिखना। 100,000-टोकन विंडो का अर्थ है कि कुछ मध्यम फ़ाइलें और आपके निर्देश एक अनुरोध में फिट हो जाते हैं, और पूर्णता जो कुछ भी बचता है उसका उपयोग कर सकती है।

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

एडिटर में लागत

कीमतें 1M इनपुट टोकन के लिए $0.15 और 1M आउटपुट टोकन के लिए $0.50 हैं। कोडिंग टूल बहुत सारा कॉन्टेक्स्ट भेजते हैं, इसलिए पहले इनपुट पर ध्यान दें।

उदाहरण: 8,000 टोकन फ़ाइल कॉन्टेक्स्ट और 600 टोकन के जवाब वाले एक एडिट अनुरोध की लागत 8,000 x $0.15 / 1M + 600 x $0.50 / 1M = $0.0012 + $0.0003 = $0.0015 होती है। 150 ऐसे अनुरोधों का एक दिन खर्च 150 x $0.0015 = $0.225 होता है। बीस कार्य दिवस: $4.50।

एक एजेंट जो कई फ़ाइलें पढ़ सकता है, वह प्रति स्टेप 40,000 टोकन भेज सकता है। उस आकार पर एक स्टेप की लागत $0.006 प्लस आउटपुट होती है, इसलिए 100 स्टेप की लागत लगभग $0.60 प्लस आउटपुट होती है। एजेंट लूप पर नज़र रखें। विफल या अस्वीकृत अनुरोधों के लिए चार्ज नहीं किया जाता, और क्रेडिट कभी समाप्त नहीं होता है। $20 से $500 तक टॉप-अप कार्ड (Visa, Mastercard, Apple Pay, Google Pay) या क्रिप्टो द्वारा भुगाए जा सकते हैं। वर्तमान योजनाएँ कीमत पेज पर सूचीबद्ध हैं।

ट्रबलशूटिंग

401 अनअथोराइज्ड

कुंजी गायब है, उसमें एक अवांछित स्पेस है, या पर्यावरण चर VS Code के लिए दिखाई नहीं दे रहा है। उस चर वाले टर्मिनल से एडिटर को रीस्टार्ट करें।

404 या "मॉडल नहीं मिला"

सटीक मॉडल uncensored और बेस URL का उपयोग /v1 के अंत में करें।

429 त्रुटियाँ

एक पूर्ण कुंजी 8 समानांतर अनुरोध और प्रति मिनट 300 की अनुमति देती है; ट्रायल कुंजी 2 और 60 की अनुमति देती है। एक एक्सटेंशन जो कई समानांतर अनुरोध फायर करता है, जैसे कि ऑटोकम्प्लीट प्लस चैट, कन्करेंसी लिमिट तक पहुँच सकता है। त्रुटि कोड बहुत ज़्यादा एक साथ होने पर concurrency है और प्रति-मिनट लिमिट के लिए rate_limited है। एक Retry-After: 5 हेडर का अर्थ अस्थायी ओवरलोड है।

स्ट्रीमिंग रुक जाना

कुछ कॉर्पोरेट प्रॉक्सी सर्वर-सेंट इवेंट्स को बफ़र करते हैं। किसी अलग नेटवर्क से टेस्ट करें या एक्सटेंशन में स्ट्रीमिंग बंद करें।

जवाब आपके द्वारा किसी अन्य सहायक के साथ देखे गए से भिन्न हैं

यह अपेक्षित है। यह एक अलग मॉडल है जिसकी अपनी ताकतें हैं। इसे स्पष्ट, विशिष्ट निर्देश दें और अपने प्रोजेक्ट के कोड पर इसे टेस्ट करें।

अधिक गाइड

• पायथन में Codex API: कोडिंग LLM को कॉल करना
• Codex API Base URL: अपने क्लाइंट को हमारे एंडपॉइंट से कैसे कनेक्ट करें