तुमच्या ॲपमध्ये OpenAI API कसे समाविष्ट करायचे

OpenAI API समाविष्ट करण्यासाठी, OpenAI प्रोजेक्टमध्ये API की तयार करा, तिला OPENAI_API_KEY नावाचे सर्व्हर-साइड सिक्रेट म्हणून साठवा, आणि OpenAI च्या अधिकृत SDK वापरून तुमच्या स्वतःच्या सर्व्हरवरील राउटवरून कॉल करा — कधीही ब्राउझर कोडमधून नाही. सप्टेंबर 2026 पर्यंत, OpenAI च्या क्विकस्टार्टमध्ये नव्या प्रोजेक्ट्ससाठी सुरुवातीचा बिंदू म्हणून Responses API सादर केले आहे. लाँचपूर्वी खर्च मर्यादा सेट करा, उत्तराची लांबी मर्यादित करा, प्रत्येक वापरकर्ता फीचरला किती वेळा कॉल करू शकतो ते मर्यादित करा, आणि रेट-लिमिट एरर्स रिट्रायसह हाताळा.

हे मार्गदर्शक सेट अप, रिक्वेस्ट फ्लो, AI बिल्डरसाठी प्रॉम्प्ट्स, आणि चाव्या लीक करणाऱ्या किंवा पैसे जाळणाऱ्या चुका समाविष्ट करते. OpenAI ची माहिती सप्टेंबर 2026 पर्यंतच्या त्यांच्या अधिकृत दस्तऐवजीकरणातून घेतली आहे. सामान्य संकल्पनांसाठी (टोकन्स, कॉन्टेक्स्ट विंडो, किंमत), आधी LLM API कसे वापरायचे वाचा.

तुम्ही यासह काय बनवू शकता

• तुमच्या ॲपमधील चॅट सहाय्यक (AI चॅटबॉट ॲप कसे बनवायचे)
• "Summarise this", "rewrite this" किंवा "draft a reply" बटणे
• मोकळ्या मजकुरातून संरचित डेटा काढणे: ईमेलचे ऑर्डरमध्ये रूपांतर, सपोर्ट तिकिटांना टॅग करणे
• तुमच्या स्वतःच्या कंटेंटवर शोध आणि प्रश्नोत्तरे
• इमेज जनरेशन, स्पीच आणि इतर मीडिया फीचर्स, उपलब्ध मॉडेल्सनुसार

अधिक कल्पना तुमच्या ॲपमध्ये AI फीचर्स कसे जोडायचे मध्ये आहेत.

तुमचे OpenAI खाते सेट अप करणे

1. OpenAI प्लॅटफॉर्मवर खाते आणि प्रोजेक्ट तयार करा. OpenAI च्या प्रोडक्शन सर्वोत्तम पद्धती स्टेजिंग आणि प्रोडक्शनसाठी वेगळे प्रोजेक्ट्स सुचवतात, म्हणजे प्रत्येकाच्या स्वतःच्या की आणि मर्यादा असू शकतात.
2. प्रोजेक्ट API की तयार करा. OpenAI कालबाह्यता तारीख सेट करण्याची आणि की नियमितपणे बदलण्याची शिफारस करते.
3. लिमिट्स पेजवर खर्च अलर्ट्स आणि कठोर खर्च मर्यादा सेट करा. OpenAI च्या मार्गदर्शकानुसार, अलर्ट्स वापर एका रकमेच्या पुढे गेल्यावर सूचित करतात, आणि कठोर मर्यादा मासिक कॅप लागू करते.
4. बिलिंग जोडा. OpenAI च्या रेट-लिमिट दस्तऐवजात वापर टियर्सचे वर्णन आहे: तुम्ही कालांतराने जास्त खर्च केल्यावर तुमच्या मर्यादा आपोआप वाढतात.

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

ब्राउझर  ->  तुमचा सर्व्हर राउट  ->  OpenAI API
         <-  (स्ट्रीम केलेले) उत्तर   <-

1. वापरकर्ता बटणावर क्लिक करतो किंवा संदेश पाठवतो.
2. ब्राउझर तुमच्या राउटला कॉल करतो, उदाहरणार्थ POST /api/summarise.
3. तुमचा सर्व्हर तपासतो की वापरकर्ता लॉग इन आहे आणि त्याला फीचर वापरण्याची परवानगी आहे.
4. सर्व्हर रिक्वेस्ट तयार करतो: सूचना, वापरकर्त्याचा इनपुट, आणि कार्याला लागणारा तुमच्या डेटाबेसमधील कोणताही डेटा.
5. तो पर्यावरणातील की वापरून OpenAI ला कॉल करतो. OpenAI चे SDK OPENAI_API_KEY आपोआप वाचतात.
6. तो उत्तर स्ट्रीम करतो किंवा परत पाठवतो, आणि टोकन वापराची नोंद ठेवतो.

OpenAI चे अधिकृत SDK पॅकेज JavaScript/TypeScript (npm) आणि Python (pip) दोन्हीसाठी openai या नावाने आहेत.

मॉडेल निवडणे

OpenAI वेगवेगळ्या किंमती आणि वेगांचे अनेक मॉडेल्स देते, आणि ती यादी वारंवार बदलते. लहान, स्वस्त मॉडेलने सुरुवात करा, खऱ्या उदाहरणांवर गुणवत्ता मोजा, आणि गरज असेल तरच वर जा. मॉडेलचे नाव एका कॉन्फिगरेशन व्हॅल्यू किंवा सिक्रेटमध्ये ठेवा म्हणजे कोड पुन्हा न लिहिता ते बदलता येईल. सध्याच्या दरांसाठी OpenAI चे किंमत पेज तपासा.

पर्याय आणि तडजोडी

तुमच्या AI बिल्डरसाठी प्रॉम्प्ट्स

पहिले फीचर:

टिकिट पेजवर एक "Summarise" बटण जोडा. ते सर्व्हर राउट POST /api/summarise ला कॉल करते, जो तपासतो की वापरकर्ता लॉग इन आहे, टिकिट लोड करतो, आणि अधिकृत openai SDK आणि सिक्रेट OPENAI_API_KEY वापरून OpenAI Responses API ला कॉल करतो. मॉडेलचे नाव OPENAI_MODEL या सिक्रेटमधून वाचा. सूचना: "3 बुलेट पॉइंट्समध्ये सारांश द्या, मग एक छोटे उत्तर सुचवा. ऑर्डर नंबर बनवू नका." उत्तराची लांबी मर्यादित करा, उत्तर पेजवर स्ट्रीम करा, आणि की कधीही ब्राउझरला पाठवू नका.

सुरक्षा रक्षक:

प्रत्येक वापरकर्त्याला तासाला 30 AI रिक्वेस्ट्सची मर्यादा घाला, डेटाबेसमध्ये साठवलेली. प्रत्येक रिक्वेस्टसाठी इनपुट आणि आउटपुट टोकन्स वापरकर्ता ID आणि फीचरच्या नावासह नोंदवा. OpenAI ने 429 दिल्यास, Retry-After हेडरचा आदर करा आणि एक्स्पोनेन्शियल बॅकऑफ आणि जिटरसह जास्तीत जास्त 3 वेळा पुन्हा प्रयत्न करा; त्यानंतर "AI सध्या व्यस्त आहे, एका मिनिटानंतर पुन्हा प्रयत्न करा." दाखवा. इतर कोणत्याही अपयशासाठी मैत्रीपूर्ण एरर दाखवा आणि पेजचे इतर भाग चालू ठेवा.

एरर्स आणि मर्यादा हाताळणे

OpenAI रेट लिमिट्स अनेक प्रकारे मोजते, ज्यात प्रति मिनिट रिक्वेस्ट्स आणि प्रति मिनिट टोकन्सचा समावेश आहे, आणि जी आधी संपते ती तुम्हाला लागू होते. एखादी मर्यादा ओलांडल्यावर, API Retry-After हेडरसह 429 परत करते. OpenAI च्या दस्तऐवजात म्हटले आहे की ती किंमत किमान मानावी आणि क्लायंट्स एकत्र पुन्हा प्रयत्न करू नयेत म्हणून एक छोटा यादृच्छिक विलंब जोडावा.

याबाबत नियोजन करा:

• लांब जनरेशन्सवर टायमआउट्स. स्ट्रीमिंग मदत करते, आणि उत्तराची वाजवी मर्यादाही.
• प्रदात्याचे आउटेज. AI फीचरने पेज न मोडता सौम्यपणे अपयशी व्हावे.
• खराब आउटपुट. संरचित आउटपुट सेव्ह करण्यापूर्वी तपासा, आणि तुमच्या कोडमधील तपासणीशिवाय मॉडेल आउटपुटला संवेदनशील कृती करू देऊ नका.

सामान्य चुका

• फ्रंटएंड किंवा रिपॉझिटरीमध्ये की. ब्राउझर कोड सार्वजनिक असतो, आणि लीक झालेली की काही मिनिटांत गैरवापरली जाऊ शकते. API की सुरक्षित कशा ठेवायच्या पहा.
• खर्च मर्यादा नसणे. लूप किंवा गैरवापरी वापरकर्ता मोठे बिल पटकन वाढवू शकतो.
• प्रति-वापरकर्ता मर्यादा नसणे. प्रदात्याची मर्यादा तुमच्या पाकिटाचे संरक्षण करते, तुमच्या इतर वापरकर्त्यांचे नाही.
• सुरक्षेसाठी प्रॉम्प्टवर विश्वास ठेवणे. वापरकर्ते "ignore previous instructions" टाइप करू शकतात. परवानग्या सर्व्हर कोडमध्ये असाव्यात.
• गरजेपेक्षा जास्त पाठवणे. संपूर्ण दस्तऐवज आणि लांब इतिहास खर्च वाढवतात. कार्याला जे लागते तेवढेच पाठवा.
• मॉडेलचे नाव हार्ड-कोड करणे. मॉडेल्स अपडेट आणि निवृत्त होतात; ते सेटिंग करा.
• वैयक्तिक डेटा पाठवताना विचार न करणे. OpenAI च्या डेटा-वापर अटी वाचा आणि फीचरला जे लागते तेवढेच पाठवा.

चेकलिस्ट

• चाचणी आणि उत्पादनासाठी वेगळे OpenAI प्रोजेक्ट्स (किंवा की)
• की सर्व्हर-साइड सिक्रेट म्हणून साठवली, कधीही ब्राउझर कोड किंवा रेपोमध्ये नाही
• खर्च अलर्ट्स आणि कठोर खर्च मर्यादा सेट केली
• सर्व कॉल्स तुमच्या सर्व्हरमधून जातात आणि वापरकर्त्याच्या परवानग्या तपासतात
• उत्तराची लांबी मर्यादित; मॉडेलचे नाव कॉन्फिगर करण्यायोग्य
• तुमच्या ॲपमध्ये प्रति-वापरकर्ता रेट लिमिट
• Retry-After, बॅकऑफ आणि जिटरसह 429 हाताळणी
• मैत्रीपूर्ण एरर स्थिती; AI शिवाय पेज चालते
• प्रति फीचर टोकन वापर नोंदवला
• रिकामे, खूप लांब आणि शत्रुत्वपूर्ण इनपुट्सवर चाचणी केली

Mythex मध्ये OpenAI API वापरणे

Mythex वर तुम्ही बनवलेल्या ॲप्समधील AI फीचर्स तुमची स्वतःची OpenAI की वापरतात आणि ती Mythex बिल्ड क्रेडिट्सऐवजी तुमच्या OpenAI खात्यावर बिल होते. /secrets, प्रोजेक्ट सेटिंग्ज किंवा तुम्हाला की हवी असताना एजंट दाखवणाऱ्या सिक्रेट्स कार्डद्वारे OPENAI_API_KEY एक प्रोजेक्ट सिक्रेट म्हणून जोडा, आणि नंतर वरीलसारख्या प्रॉम्प्ट्सद्वारे फीचरचे वर्णन करा. लाइव्ह ॲपवर सिक्रेट्स बदलल्यानंतर पुन्हा प्रकाशित करा, म्हणजे ते नवीन सिक्रेट्स उचलेल. स्टार्टर प्रॉम्प्टसाठी तुमच्या स्वतःच्या API की वापरून AI फीचर्स जोडा ही डॉक्स रेसिपी पहा, आणि चॅटमधील सिक्रेट्स कार्ड कसे काम करते ते स्पष्ट करते. प्रदात्यांमध्ये निवड करत असाल तर, Claude API कसे समाविष्ट करायचे तेच मुद्दे Anthropic साठी समजावते.

प्रश्न