अपने ऐप में OpenAI API कैसे जोड़ें

OpenAI API को इंटीग्रेट करने के लिए, एक OpenAI project में API key बनाएं, उसे सर्वर-साइड सीक्रेट के रूप में OPENAI_API_KEY नाम से सेव करें, और OpenAI के आधिकारिक SDK का इस्तेमाल करते हुए अपने सर्वर के एक रूट से API को कॉल करें, कभी ब्राउज़र कोड से नहीं। सितंबर 2026 तक, OpenAI का quickstart नए प्रोजेक्ट्स के लिए Responses API को शुरुआती बिंदु के रूप में दिखाता है। लॉन्च से पहले spend limit सेट करें, जवाब की लंबाई सीमित करें, सीमित करें कि हर यूज़र फ़ीचर को कितनी बार कॉल कर सकता है, और rate-limit errors को retries के साथ संभालें।

यह गाइड सेटअप, रिक्वेस्ट फ़्लो, AI बिल्डर के लिए prompts, और वे गलतियाँ कवर करती है जो keys लीक करती हैं या पैसा जलाती हैं। OpenAI की जानकारी सितंबर 2026 तक के उसके आधिकारिक दस्तावेज़ से है। सामान्य अवधारणाओं (टोकन, context windows, pricing) के लिए पहले LLM APIs कैसे इस्तेमाल करें पढ़ें।

इससे आप क्या बना सकते हैं

• अपने ऐप के अंदर एक चैट असिस्टेंट (AI चैटबॉट ऐप कैसे बनाएं)
• "इसका सारांश बनाओ", "इसे फिर से लिखो" या "जवाब का ड्राफ़्ट बनाओ" बटन
• मुफ़्त टेक्स्ट से structured डेटा निकालना: ईमेल को ऑर्डर में बदलना, सपोर्ट टिकट टैग करना
• आपकी अपनी सामग्री पर खोज और सवाल-जवाब
• इमेज जनरेशन, speech और दूसरे मीडिया फ़ीचर, उपलब्ध models पर निर्भर

और आइडिया के लिए अपने ऐप में AI फ़ीचर कैसे जोड़ें देखें।

अपना OpenAI अकाउंट सेट करना

1. OpenAI प्लेटफ़ॉर्म में एक अकाउंट और एक project बनाएं। OpenAI की production best practices staging और production के लिए अलग projects की सिफ़ारिश करती हैं, ताकि हर एक की अपनी keys और limits हों।
2. एक project API key बनाएं। OpenAI समाप्ति की तारीख सेट करने और keys को नियमित रूप से बदलने (rotate) की सलाह देता है।
3. limits पेज पर spend alerts और एक हार्ड spend limit सेट करें। OpenAI के गाइड के अनुसार alerts तब सूचित करते हैं जब usage किसी राशि से आगे जाए, और हार्ड limit मासिक सीमा लागू करती है।
4. बिलिंग जोड़ें। OpenAI के rate-limit दस्तावेज़ usage tiers का वर्णन करते हैं: आप जितना ज़्यादा समय के साथ खर्च करते हैं, आपकी limits उतनी अपने आप बढ़ती हैं।

रिक्वेस्ट का फ़्लो

Browser  ->  आपका सर्वर रूट  ->  OpenAI API
         <-  (streamed) जवाब   <-

1. यूज़र एक बटन दबाता है या मैसेज भेजता है।
2. ब्राउज़र आपके रूट को कॉल करता है, उदाहरण के लिए POST /api/summarise।
3. आपका सर्वर जाँचता है कि यूज़र लॉग इन है और इस फ़ीचर की अनुमति है।
4. सर्वर रिक्वेस्ट बनाता है: निर्देश, यूज़र का इनपुट, और कार्य के लिए ज़रूरी आपके डेटाबेस का कोई भी डेटा।
5. यह environment की key से OpenAI को कॉल करता है। OpenAI के SDK OPENAI_API_KEY को अपने आप पढ़ लेते हैं।
6. यह जवाब स्ट्रीम करता या लौटाता है, और टोकन उपयोग लॉग करता है।

OpenAI के आधिकारिक SDK पैकेज का नाम openai है, JavaScript/TypeScript (npm) और Python (pip) दोनों के लिए।

model चुनना

OpenAI कई models देता है, अलग-अलग कीमत और गति पर, और लाइन-अप अक्सर बदलती रहती है। एक छोटे, सस्ते model से शुरू करें, असली उदाहरणों पर गुणवत्ता मापें, और सिर्फ़ ज़रूरत पड़ने पर ऊपर जाएं। model का नाम किसी कॉन्फ़िग वैल्यू या सीक्रेट में रखें ताकि कोड दोबारा लिखे बिना उसे बदला जा सके। मौजूदा दरों के लिए OpenAI का pricing पेज देखें।

विकल्प और ट्रेड-ऑफ़

अपने AI बिल्डर को देने वाले prompts

एक पहला फ़ीचर:

टिकट पेज पर एक "Summarise" बटन जोड़ें। यह एक सर्वर रूट POST /api/summarise को कॉल करता है, जो जाँचता है कि यूज़र लॉग इन है, टिकट लोड करता है, और आधिकारिक openai SDK और सीक्रेट OPENAI_API_KEY से OpenAI Responses API को कॉल करता है। model का नाम सीक्रेट OPENAI_MODEL से पढ़ें। निर्देश: "Summarise in 3 bullet points, then suggest a short reply. Don't invent order numbers." जवाब की लंबाई सीमित करें, जवाब पेज पर स्ट्रीम करें, और key कभी ब्राउज़र को न भेजें।

Guardrails:

हर यूज़र को प्रति घंटे 30 AI रिक्वेस्ट तक सीमित करें, जो डेटाबेस में रहें। हर रिक्वेस्ट के इनपुट और आउटपुट टोकन यूज़र ID और फ़ीचर के नाम के साथ लॉग करें। अगर OpenAI 429 लौटाए, तो Retry-After हेडर का सम्मान करें और exponential backoff और jitter के साथ 3 बार तक दोबारा कोशिश करें; उसके बाद "The AI is busy, try again in a minute." दिखाएं। किसी और विफलता पर एक दोस्ताना error दिखाएं और बाकी पेज को काम करता रखें।

errors और सीमाएं संभालना

OpenAI rate limits कई तरीकों से मापता है, जिनमें प्रति मिनट रिक्वेस्ट और प्रति मिनट टोकन शामिल हैं, और जो पहले खत्म हो जाए उसी की सीमा लगती है। जब आप किसी एक को पार करते हैं, तो API Retry-After हेडर के साथ 429 लौटाता है। OpenAI के दस्तावेज़ कहते हैं कि इस मान को न्यूनतम समझें और थोड़ी random देरी जोड़ें, ताकि सभी क्लाइंट एक साथ दोबारा कोशिश न करें।

इन बातों के लिए भी तैयार रहें:

• लंबी generations पर timeouts। Streaming मदद करती है, और एक समझदार आउटपुट सीमा भी।
• प्रोवाइडर आउटेज। AI फ़ीचर को बिना पेज तोड़े सुंदर तरीके से विफल होना चाहिए।
• खराब आउटपुट। संरचित आउटपुट सेव करने से पहले उसे validate करें, और model के आउटपुट को अपनी कोड की जाँच के बिना कोई संवेदनशील कार्रवाई न करने दें।

आम गलतियाँ

• Frontend में या repository में key। ब्राउज़र का कोड सार्वजनिक है, और लीक हुई key कुछ मिनटों में दुरुपयोग हो सकती है। देखें API keys को सुरक्षित कैसे रखें।
• कोई spend limit नहीं। एक लूप या कोई दुरुपयोग करने वाला यूज़र तेज़ी से बड़ा बिल बना सकता है।
• प्रति-यूज़र सीमा नहीं। प्रोवाइडर की limit आपके बटुए की रक्षा करती है, आपके दूसरे यूज़र की नहीं।
• सुरक्षा के लिए prompt पर भरोसा। यूज़र लिख सकते हैं "ignore previous instructions"। अनुमतियाँ सर्वर कोड में रहनी चाहिए।
• ज़रूरत से ज़्यादा भेजना। पूरे दस्तावेज़ और लंबा इतिहास लागत बढ़ाते हैं। वही भेजें जो कार्य को चाहिए।
• model का नाम हार्ड-कोड करना। Models अपडेट और बंद होते रहते हैं; इसे एक सेटिंग बनाएं।
• बिना सोचे-समझे संवेदनशील डेटा भेजना। OpenAI की डेटा-उपयोग शर्तें पढ़ें और केवल वही भेजें जो फ़ीचर को चाहिए।

चेकलिस्ट

• टेस्टिंग और प्रोडक्शन के लिए अलग OpenAI projects (या keys)
• key सर्वर-साइड सीक्रेट के रूप में सेव, ब्राउज़र कोड या repo में कभी नहीं
• spend alerts और एक हार्ड spend limit सेट
• सभी कॉल आपके सर्वर से, यूज़र की अनुमति जाँच के साथ
• आउटपुट की लंबाई सीमित; model का नाम कॉन्फ़िगर करने योग्य
• आपके ऐप में प्रति-यूज़र rate limit
• Retry-After, backoff और jitter के साथ 429 संभाला गया
• दोस्ताना error स्टेट; AI के बिना भी पेज काम करता है
• हर फ़ीचर के लिए टोकन उपयोग लॉग
• लंबे, खाली और दुर्भावनापूर्ण इनपुट के साथ टेस्ट किया गया

Mythex में OpenAI API का इस्तेमाल

Mythex पर बनाए गए ऐप में AI फ़ीचर आपकी अपनी OpenAI key इस्तेमाल करते हैं, जिसका बिल आपके OpenAI अकाउंट पर जाता है, Mythex build credits पर नहीं। OPENAI_API_KEY को /secrets, प्रोजेक्ट सेटिंग्स या उस secrets कार्ड के ज़रिए प्रोजेक्ट सीक्रेट के रूप में जोड़ें जो एजेंट को key चाहिए होने पर दिखाता है, फिर ऊपर जैसे prompt से फ़ीचर का वर्णन करें। प्रकाशित ऐप पर सीक्रेट बदलने के बाद उसे फिर से पब्लिश करें, ताकि वह नई वैल्यू उठा सके। स्टार्टर prompt के लिए docs रेसिपी अपनी API keys के साथ AI फ़ीचर जोड़ें देखें, और secrets कार्ड के बारे में चैट में Secrets बताता है। प्रोवाइडर तुलना कर रहे हैं? Claude API कैसे इंटीग्रेट करें देखें।

सवाल