Batch API کیسے کام کرتی ہے؟
Batch API اینڈپوائنٹ، جیسا کہ یہاں دستاویزی کیا گیا ہے، صارفین کو غیر ہم وقت بیچ پروسیسنگ کے لیے درخواستیں جمع کرانے کی اجازت دیتا ہے. ہم ان درخواستوں پر 24 گھنٹوں کے اندر کارروائی کریں گے. ہر درخواست کی تفصیلات پہلے سے اپ لوڈ کی گئی فائل سے پڑھی جائیں گی، اور جوابات آؤٹ پٹ فائل میں لکھے جائیں گے. آپ اسٹیٹس اپ ڈیٹس اور نتائج کے لیے بیچ آبجیکٹ سے استفسار کر سکتے ہیں.
Batch API کی قیمت کیا ہے؟
ہر ماڈل ہم وقت APIs کے مقابلے لاگت پر 50% رعایت کے ساتھ پیش کیا جائے گا. ہماری API قیمتوں کے بارے میں مزید معلومات یہاں ہیں.
میں کن ماڈلز کو بیچ کر سکتا ہوں؟
Batch API ہمارے زیادہ تر ماڈلز پر وسیع طور پر دستیاب ہے، مگر سب پر نہیں. براہ کرم ماڈل حوالہ دستاویزات دیکھیں تاکہ یقینی بنایا جا سکے کہ آپ جو ماڈل استعمال کر رہے ہیں وہ Batch API کو سپورٹ کرتا ہے.
اگر API میری درخواست کو وعدہ کیے گئے وقت کے اندر مکمل نہ کرے تو کیا ہوتا ہے؟
ہمارا مقصد تمام درخواستیں 24 گھنٹوں کے اندر مکمل کرنا ہے. اگر کوئی بیچ ایکسپائر ہو جائے (یعنی وہ SLA وقت کی مدت کے اندر مکمل نہ ہو سکا)، تو باقی کام منسوخ کر دیا جاتا ہے اور جو کام پہلے ہی مکمل ہو چکا ہو وہ واپس کر دیا جاتا ہے. ڈیولپرز سے کسی بھی مکمل شدہ کام کے لیے چارج لیا جائے گا.
میں کتنی درخواستیں بیچ کر سکتا ہوں، اس کی حد کیا ہے؟
Embeddings APIs میں ایک وقت میں قطار میں لگی 10 لاکھ درخواستوں کی حد ہوتی ہے.
دیگر تمام APIs کے لیے، ان درخواستوں کی تعداد کی کوئی حد نہیں جنہیں آپ بیچ کر سکتے ہیں؛ تاہم، ہر استعمالی ٹیئر کے ساتھ ایک متعلقہ بیچ ریٹ لمٹ ہوتی ہے. آپ کی بیچ ریٹ لمٹ میں ان پٹ ٹوکنز کی زیادہ سے زیادہ تعداد شامل ہے جو آپ نے ایک وقت میں قطار میں لگائی ہے. آپ اپنی ریٹ لمٹس یہاں دیکھ سکتے ہیں.
کیا میں Batch API سے جواب ملنے میں لگنے والا وقت بدل سکتا ہوں؟
ہماری موجودہ متعین وقت کی مدت 24 گھنٹے ہے. ہم فی الحال اس مدت کو تبدیل نہیں کر سکتے.
کیا Batch API پر اسٹریمنگ سپورٹ کی جاتی ہے؟
نہیں، Batch API پر اسٹریمنگ سپورٹ نہیں کی جاتی. بیچ درخواستیں اسٹریمنگ جوابات کے بجائے آؤٹ پٹ فائلوں کے ذریعے نتائج واپس کرتی ہیں.
کیا Batch API پر تصاویر سپورٹ کی جاتی ہیں؟
ہاں، Batch API پر تصاویر سپورٹ کی جاتی ہیں.
مجھے خرابی کا پیغام ملا: “The URL provided for this request does not prefix-match the batch endpoint”. مجھے کیا کرنا چاہیے؟
اگر آپ کو یہ خرابی ملتی ہے، تو اس کا مطلب ہے کہ آپ کا URL Batch API اینڈپوائنٹ کے لیے غلط فارمیٹ میں ہے. براہ کرم ہماری دستاویزات یہاں دیکھیں تاکہ یقینی بنایا جا سکے کہ آپ اینڈپوائنٹ کو درست طریقے سے کال کر رہے ہیں.
کیا Batch API کا استعمال میری دیگر ریٹ لمٹس میں شمار ہوتا ہے؟
Batch API ریٹ لمٹس موجودہ حدود سے بالکل الگ ہیں.
اگر کوئی بیچ منسوخ کر دیا جائے تو کیا ہوتا ہے؟
اگر کوئی بیچ دستی طور پر منسوخ کیا جائے، تو جو بھی نتائج پہلے ہی مکمل ہو چکے ہوں وہ واپس کر دیے جاتے ہیں. ڈیولپرز سے کسی بھی مکمل شدہ کام کے لیے چارج لیا جائے گا.
اگر کوئی بیچ ایکسپائر ہو جائے تو کیا ہوتا ہے؟
اگر کوئی بیچ ایکسپائر ہو جائے (یعنی وہ SLA وقت کی مدت کے اندر مکمل نہ ہو سکا)، تو باقی کام منسوخ کر دیا جاتا ہے اور جو کام پہلے ہی مکمل ہو چکا ہو وہ واپس کر دیا جاتا ہے. ڈیولپرز سے کسی بھی مکمل شدہ کام کے لیے چارج لیا جائے گا.
بیچ جابز پر میں کن اسٹیٹسز کی توقع کر سکتا ہوں؟
بیچ جاب کے درج ذیل اسٹیٹسز میں سے کوئی بھی ہو سکتا ہے: توثیق جاری، ناکام، جاری، حتمی شکل دی جا رہی ہے، مکمل، میعاد ختم، منسوخی جاری، اور منسوخ. اگر آپ API اسٹیٹس ویلیوز کو پروگرام کے ذریعے چیک کر رہے ہیں، تو چھوٹے حروف والے لٹریلز استعمال کریں: validating, failed, in_progress, finalizing, completed, expired, cancelling, and cancelled.
توثیق جاری: بیچ شروع ہونے سے پہلے اپ لوڈ کی گئی فائل کی توثیق جاری ہے.
ناکام: فائل توثیق کے عمل میں ناکام ہو گئی ہے.
جاری: فائل کی کامیابی سے توثیق ہو گئی ہے اور بیچ عمل جاری ہے.
حتمی شکل دی جا رہی ہے: بیچ جاب مکمل ہو گئی ہے اور نتائج تیار کیے جا رہے ہیں.
مکمل: بیچ جاب مکمل ہے اور نتائج تیار ہیں.
میعاد ختم: بیچ SLA وقت کی مدت کے اندر مکمل نہیں ہو سکا.
منسوخی جاری: بیچ جاب کی منسوخی شروع کر دی گئی ہے.
منسوخ: بیچ جاب منسوخ کر دی گئی تھی.
میں کیسے چیک کر سکتا ہوں کہ میں نے کون سی بیچ جابز پہلے ہی بنائی ہیں؟
آپ یہاں درج API کال استعمال کر کے اپنی تمام بیچ جابز کی فہرست حاصل کر سکتے ہیں.
کیا اس اینڈپوائنٹ پر زیرو ڈیٹا ریٹینشن سپورٹ کیا جاتا ہے؟
اگر آپ کی تنظیم کے لیے زیرو ڈیٹا ریٹینشن فعال ہے، تو براہ کرم نوٹ کریں کہ زیرو ڈیٹا ریٹینشن Batch API پر لاگو نہیں ہوتا. ZDR تنظیمیں بیچ جابز بنا سکتی ہیں، لیکن بیچ ان پٹ فائلیں، آؤٹ پٹس، خرابیاں، اور درمیانی آرٹیفیکٹس تشکیل شدہ Batch، File Service، اور Sediment ریٹینشن پالیسیوں کے مطابق محفوظ رکھے جاتے ہیں.