ব্যাচ টাস্ক পরিচালনা

অ্যাসিঙ্ক্রোনাস বাল্ক অনুরোধ পাঠান এবং ব্যাচ সম্পাদন অবস্থা পরীক্ষা করুন।

OpenAI-সামঞ্জস্যপূর্ণ Batch API ব্যবহার করে সমর্থিত মডেল এন্ডপয়েন্ট জুড়ে অ্যাসিঙ্ক্রোনাস বাল্ক অনুরোধ পাঠান।

POST/openai/v1/batches

অনুরোধ বডি

ক্ষেত্রধরনপ্রয়োজনীয়বিবরণ
input_file_idstringহ্যাঁbatch হিসাবে উদ্দেশ্য নির্ধারিত আপলোড করা ফাইলের অনন্য শনাক্তকারী।
endpointstringহ্যাঁটার্গেট এন্ডপয়েন্ট (/v1/chat/completions, /v1/completions, /v1/responses, বা /v1/embeddings)।
completion_windowstringহ্যাঁসম্পন্ন করার সময়সীমা, বর্তমানে 24h এ নির্ধারিত।
metadataobjectনাট্র্যাকিং এবং অডিটের জন্য ঐচ্ছিক কী-মানের জোড়া।

ইনপুট ফাইলগুলি অবশ্যই UTF-8 এনকোড করা JSONL হতে হবে, যাতে সর্বোচ্চ 50,000 আইটেম এবং সর্বাধিক 200 MiB ফাইলের আকার অনুমোদিত। প্রতিটি JSONL লাইন একটি বৈধ JSON অবজেক্ট হতে হবে যাতে অনন্য অ-খালি custom_id, method: "POST", ব্যাচের endpoint-এর সাথে মিলে যাওয়া url, এবং অবজেক্ট body (কঠোর প্রি-পেইড ব্যাচের জন্য একটি বাধ্যতামূলক model ফিল্ড সহ) থাকতে হবে। নেটিভ প্রিপেইড ব্যাচের জন্য, ফান্ডিংয়ের আগে গেটওয়ে ফাইলের চেকসাম এবং এক্সিকিউশন নীতি যাচাই করে; সরবরাহকারীর কাছে পাঠানোর আগে সমস্ত আইটেমের রিজার্ভেশন পারমাণবিকভাবে সম্পন্ন হয়। মোট ব্যালেন্স অপর্যাপ্ত হলে আংশিক জমা না করে HTTP 402 ফেরত দেওয়া হয়। অসঙ্গতিপূর্ণ সরবরাহকারী কনফিগারেশন একটি একক ব্যাচের মধ্যে বিভক্ত করা যাবে না এবং আইটেম-স্তরে ক্রস-প্রোভাইডার ফেইলওভার পরিচালিত হয় না।

ব্যাচ জীবনচক্র

GET/openai/v1/batches/{batch_id}
POST/openai/v1/batches/{batch_id}/cancel
  • validating: ইনপুট ফাইল ফরম্যাট, JSONL সিনট্যাক্স এবং স্কিমা যাচাই করে।
  • in_progress: নির্ধারিত সরবরাহকারী শংসাপত্রের সাথে ব্যাচ ইনফারেন্স পরিচালনা করে।
  • finalizing: ফলাফল সংকলন করে এবং ব্যবহার নিষ্পত্তির হিসাব রেকর্ড করে।
  • completed: প্রক্রিয়াকরণ সফলভাবে সম্পন্ন হয় এবং output_file_id ও ঐচ্ছিক error_file_id তৈরি করে।
  • failed: ফাইল যাচাইকরণ বা ব্যাচ সমন্বয় সম্পূর্ণ ব্যর্থ হলে সমাপ্তি ত্রুটি অবস্থা।
  • cancelling: অনুরোধের ভিত্তিতে প্রক্রিয়াকরণ বন্ধ করে এবং বাতিল অবস্থায় স্থানান্তর করে।
  • cancelled: চূড়ান্ত সমাপ্তির পূর্বে ব্যাচ কার্যকর করা বন্ধ হওয়া নির্দেশ করে। ব্যর্থ, বাতিল বা অনুপস্থিত আইটেমের ফলাফল শূন্য প্রদানকারী খরচ প্রমাণ করে না; প্রদানকারীর রেকর্ডের সাথে মিল করার জন্য নিষ্পত্তিতে সংরক্ষিত তহবিল ধরে রাখা হয়। AnyInt-এ প্রমিত স্থিতি হলো cancelled।
  • expired: ২৪ ঘণ্টার সমাপ্তি উইন্ডো অতিক্রম করলে সক্রিয় হয়; অনিশ্চিত এক্সিকিউশনগুলির জন্য সরবরাহকারীর রেকর্ডের সাথে পুনর্মিলন প্রয়োজন এবং শূন্য খরচ বোঝায় না।

ব্যাচ তালিকা এবং ফলাফল ডাউনলোড

GET/openai/v1/batches
  • ব্যাচ তালিকা: GET /openai/v1/batches অনুমোদিত সংস্থা বা প্রকল্পের সক্রিয় এবং ঐতিহাসিক ব্যাচ কাজের তালিকা প্রদর্শন করে।
  • অবজেক্ট স্টোরেজ ও ডাউনলোড: purpose: "batch" যুক্ত ফাইল গ্রহণ এবং ব্যাচ অপারেশন পরিচালনার জন্য শেয়ার্ড অবজেক্ট স্টোরেজ (OBJECT_STORE_MODE) প্রয়োজন। প্রক্রিয়াকরণ সম্পূর্ণ হলে, আউটপুট এবং এরর JSONL ফাইলগুলি ফাইল API GET /openai/v1/files/{file_id}/content এর মাধ্যমে ডাউনলোড করা যাবে।

সামঞ্জস্যের বিকল্প পাথ

  • গেটওয়ে সামঞ্জস্যের জন্য /v1/batches গ্রহণ করে; নতুন ইন্টিগ্রেশনের জন্য /openai/v1/batches ব্যবহারের পরামর্শ দেওয়া হচ্ছে।