اپنی ایپ میں OpenAI API کیسے شامل کریں

OpenAI API کو شامل کرنے کے لیے، ایک OpenAI project میں API key بنائیں، اسے OPENAI_API_KEY نامی سرور سائیڈ سیکرٹ کے طور پر محفوظ کریں، اور اپنے سرور کے ایک روٹ سے OpenAI کے سرکاری SDK کے ذریعے API کو کال کریں، کبھی براؤزر کوڈ سے نہیں۔ ستمبر 2026 تک، OpenAI کا quickstart Responses API کو نئے projects کے لیے نقطۂ آغاز کے طور پر پیش کرتا ہے۔ لانچ سے پہلے ایک spend limit مقرر کریں، جواب کی لمبائی محدود کریں، ہر صارف کے اس فیچر کو کال کرنے کی تعداد محدود کریں، اور rate-limit خرابیوں کو retries کے ساتھ سنبھالیں۔

یہ گائیڈ سیٹ اپ، درخواست کا بہاؤ، AI بلڈر کے لیے پرامپٹس، اور وہ غلطیاں بتاتی ہے جو keys لیک کرتی ہیں یا پیسے ضائع کرتی ہیں۔ OpenAI کی تفصیلات ستمبر 2026 تک کی اس کی سرکاری دستاویزات سے ہیں۔ عمومی تصورات (ٹوکنز، context windows، قیمت) کے لیے پہلے LLM APIs کیسے استعمال کریں پڑھیں۔

آپ اس سے کیا بنا سکتے ہیں

• اپنی ایپ کے اندر ایک چیٹ اسسٹنٹ (AI چیٹ بوٹ ایپ کیسے بنائیں)
• “اس کا خلاصہ کریں”، “اسے دوبارہ لکھیں” یا “جواب کا مسودہ بنائیں” کے بٹن
• آزاد متن سے structured ڈیٹا نکالنا: ای میل کو آرڈر میں بدلنا، سپورٹ ٹکٹس پر ٹیگ لگانا
• آپ کے اپنے مواد پر سرچ اور سوال و جواب
• تصویر بنانا، اسپیچ اور دیگر میڈیا فیچرز، دستیاب models کے لحاظ سے

مزید خیالات اپنی ایپ میں AI فیچرز کیسے شامل کریں میں ہیں۔

اپنا OpenAI اکاؤنٹ سیٹ اپ کرنا

1. OpenAI platform میں ایک اکاؤنٹ اور ایک project بنائیں۔ OpenAI کی پروڈکشن بہترین طریقے staging اور production کے لیے الگ projects تجویز کرتے ہیں، تاکہ ہر ایک کی اپنی keys اور حدیں ہوں۔
2. ایک project API key بنائیں۔ OpenAI میعاد ختم ہونے کی تاریخ مقرر کرنے اور باقاعدگی سے keys بدلنے (rotate) کی سفارش کرتا ہے۔
3. limits صفحے پر spend alerts اور ایک سخت spend limit مقرر کریں۔ OpenAI کی گائیڈ کے مطابق alerts جب استعمال ایک رقم سے آگے جائے تو آپ کو مطلع کرتے ہیں، اور سخت حد ماہانہ کیپ نافذ کرتی ہے۔
4. بلنگ شامل کریں۔ OpenAI کی rate-limit دستاویزات استعمال کے درجات (usage tiers) بیان کرتی ہیں: جتنا زیادہ آپ وقت کے ساتھ خرچ کرتے ہیں، آپ کی حدیں خودکار طور پر بڑھتی ہیں۔

درخواست کا بہاؤ

Browser  ->  آپ کا سرور روٹ  ->  OpenAI API
         <-  (اسٹریم شدہ) جواب   <-

1. صارف بٹن پر کلک کرتا ہے یا پیغام بھیجتا ہے۔
2. براؤزر آپ کے روٹ کو کال کرتا ہے، مثلاً POST /api/summarise۔
3. آپ کا سرور چیک کرتا ہے کہ صارف لاگ ان ہے اور اس فیچر کے استعمال کی اجازت رکھتا ہے۔
4. سرور درخواست بناتا ہے: ہدایات، صارف کا ان پٹ، اور کام کے لیے درکار آپ کے ڈیٹا بیس سے کوئی بھی ڈیٹا۔
5. وہ ماحول سے key کے ساتھ OpenAI کو کال کرتا ہے۔ OpenAI کے SDKs OPENAI_API_KEY کو خودکار طور پر پڑھ لیتے ہیں۔
6. جواب اسٹریم کرتا ہے یا واپس بھیجتا ہے، اور ٹوکن استعمال لاگ کرتا ہے۔

OpenAI کے سرکاری SDK پیکجز کا نام JavaScript/TypeScript (npm) اور Python (pip) دونوں کے لیے openai ہے۔

model کا انتخاب

OpenAI مختلف قیمتوں اور رفتار کے کئی models پیش کرتا ہے، اور ان کی فہرست اکثر بدلتی ہے۔ ایک چھوٹے، سستے model سے شروع کریں، حقیقی مثالوں پر معیار ناپیں، اور صرف ضرورت ہو تو اوپر جائیں۔ model کا نام کسی کنفیگ ویلیو یا secret میں رکھیں تاکہ کوڈ دوبارہ لکھے بغیر بدل سکیں۔ موجودہ ریٹس کے لیے OpenAI کا pricing صفحہ دیکھیں۔

اختیارات اور تجارتی توازن

آپ کے AI بلڈر کے لیے پرامپٹس

پہلا فیچر:

ٹکٹ کے صفحے پر ایک “Summarise” بٹن شامل کریں۔ یہ سرور روٹ POST /api/summarise کو کال کرتا ہے جو چیک کرتا ہے کہ صارف لاگ ان ہے، ٹکٹ لوڈ کرتا ہے، اور آفیشل openai SDK اور سیکرٹ OPENAI_API_KEY کے ساتھ OpenAI Responses API کو کال کرتا ہے۔ model کا نام سیکرٹ OPENAI_MODEL سے پڑھیں۔ ہدایات: “3 نکات میں خلاصہ کریں، پھر ایک مختصر جواب تجویز کریں۔ آرڈر نمبر نہ بنائیں۔” آؤٹ پٹ کی لمبائی محدود کریں، جواب صفحے پر اسٹریم کریں، اور key کو کبھی براؤزر تک نہ بھیجیں۔

حفاظتی انتظامات:

ہر صارف کو فی گھنٹہ 30 AI درخواستوں تک محدود کریں، جو ڈیٹا بیس میں محفوظ ہوں۔ ہر درخواست کے ان پٹ اور آؤٹ پٹ ٹوکنز کو صارف ID اور فیچر کے نام کے ساتھ لاگ کریں۔ اگر OpenAI 429 دے تو Retry-After ہیڈر کا احترام کریں اور jitter کے ساتھ exponential backoff سے زیادہ سے زیادہ 3 بار دوبارہ کوشش کریں؛ اس کے بعد “AI مصروف ہے، ایک منٹ بعد دوبارہ کوشش کریں” دکھائیں۔ کسی بھی دوسری ناکامی پر دوستانہ خرابی کا پیغام دکھائیں اور باقی صفحہ کام کرتا رہے۔

خرابیوں اور حدوں کا انتظام

OpenAI rate limits کو کئی طریقوں سے ناپتا ہے، جن میں فی منٹ درخواستیں اور فی منٹ ٹوکنز شامل ہیں، اور آپ جو بھی پہلے ختم ہو اس تک پہنچتے ہیں۔ جب آپ کوئی حد پار کرتے ہیں تو API 429 کے ساتھ Retry-After ہیڈر لوٹاتا ہے۔ OpenAI کی دستاویزات کہتی ہیں کہ اس قدر کو کم از کم سمجھیں اور ایک چھوٹی random تاخیر شامل کریں تاکہ سارے کلائنٹس ایک ساتھ دوبارہ کوشش نہ کریں۔

ان کے لیے بھی تیار رہیں:

• طویل جنریشن پر ٹائم آؤٹ۔ اسٹریمنگ مدد کرتی ہے، اور جواب کی مناسب حد بھی۔
• فراہم کنندہ کی بندش۔ AI فیچر کو صفحے کو توڑے بغیر خوبصورتی سے ناکام ہونا چاہیے۔
• خراب آؤٹ پٹ۔ structured آؤٹ پٹ کو محفوظ کرنے سے پہلے جانچیں، اور model کے آؤٹ پٹ کو کوڈ کی جانچ کے بغیر کسی حساس عمل کو شروع نہ کرنے دیں۔

عام غلطیاں

• فرنٹ اینڈ یا ریپوزیٹری میں key۔ براؤزر کا کوڈ عوامی ہوتا ہے، اور لیک شدہ key چند منٹوں میں غلط استعمال ہو سکتی ہے۔ دیکھیں API keys کو محفوظ کیسے رکھیں۔
• کوئی spend limit نہ ہونا۔ ایک لوپ یا غلط استعمال کرنے والا صارف تیزی سے بڑا بل بنا سکتا ہے۔
• فی صارف حد نہ ہونا۔ آپ کی فراہم کنندہ کی حد آپ کے بٹوے کو بچاتی ہے، آپ کے دوسرے صارفین کو نہیں۔
• سیکیورٹی کے لیے پرامپٹ پر بھروسہ۔ صارفین “پچھلی ہدایات کو نظرانداز کریں” ٹائپ کر سکتے ہیں۔ اجازتیں سرور کے کوڈ میں ہوتی ہیں۔
• ضرورت سے زیادہ بھیجنا۔ پوری دستاویزات اور لمبی تاریخیں لاگت کو کئی گنا کر دیتی ہیں۔ صرف وہی بھیجیں جو کام کے لیے درکار ہو۔
• model کا نام سخت کوڈ میں لکھنا۔ Models اپ ڈیٹ اور ریٹائر ہوتے رہتے ہیں؛ اسے ایک سیٹنگ بنائیں۔
• ذاتی ڈیٹا بغیر سوچے بھیجنا۔ OpenAI کی ڈیٹا استعمال کی شرائط پڑھیں اور صرف وہی بھیجیں جو فیچر کو درکار ہو۔

چیک لسٹ

• ٹیسٹنگ اور پروڈکشن کے لیے الگ OpenAI projects (یا keys)
• key سرور سائیڈ سیکرٹ کے طور پر محفوظ، براؤزر کوڈ یا ریپو میں کبھی نہیں
• Spend alerts اور سخت spend limit مقرر
• تمام کالز آپ کے سرور سے، صارف کی اجازت کی جانچ کے ساتھ
• آؤٹ پٹ کی لمبائی محدود؛ model کا نام کنفیگرable
• آپ کی ایپ میں فی صارف rate limit
• Retry-After، backoff اور jitter کے ساتھ 429 کا انتظام
• دوستانہ خرابی کی حالت؛ AI کے بغیر بھی صفحہ کام کرتا ہے
• ہر فیچر کے لیے ٹوکن استعمال لاگ
• لمبے، خالی اور نامناسب ان پٹس کے ساتھ ٹیسٹ کیا گیا

Mythex میں OpenAI API استعمال کرنا

Mythex پر بنائی گئی ایپس میں AI فیچرز آپ کی اپنی OpenAI key استعمال کرتے ہیں، اور بلنگ Mythex بلڈ کریڈٹس کے بجائے آپ کے OpenAI اکاؤنٹ میں ہوتی ہے۔ OPENAI_API_KEY کو /secrets، پروجیکٹ سیٹنگز، یا وہ سیکرٹس کارڈ جو ایجنٹ کو key درکار ہونے پر دکھاتا ہے، کے ذریعے پروجیکٹ سیکرٹ کے طور پر شامل کریں، پھر اوپر جیسے پرامپٹ سے فیچر بیان کریں۔ شائع شدہ ایپ میں سیکرٹس بدلنے کے بعد، اسے دوبارہ پبلش کریں تاکہ وہ انہیں اٹھا لے۔ docs کی ریسیپی AI فیچرز اپنی API keys کے ساتھ شامل کریں میں شروعاتی پرامپٹ ہے، اور چیٹ میں سیکرٹس سیکرٹس کارڈ کی وضاحت کرتا ہے۔ فراہم کنندگان کا موازنہ کر رہے ہیں؟ Claude API کو کیسے شامل کریں دیکھیں۔

سوالات