একটি প্রতিক্রিয়া তৈরি করুন
OpenAI-এর সাথে সামঞ্জস্যপূর্ণ Responses API ব্যবহার করে মডেল আউটপুট তৈরি করুন।
টেক্সট বা স্ট্রাকচার্ড মডেল ইনপুট এবং একটি ইউনিফাইড আউটপুট অবজেক্টের জন্য Responses API শেপ ব্যবহার করুন।
/openai/v1/responsesRequest Body
| Field | Type | Required | Description |
|---|---|---|---|
model | string | Yes | AnyInt দ্বারা রাউট করা মডেল শনাক্তকারী। |
input | string or array | Yes | টেক্সট বা স্ট্রাকচার্ড ইনপুট আইটেম। |
stream | boolean | No | সমর্থিত হলে সার্ভার-প্রেরিত ইভেন্টগুলি ফেরত দিন। |
reasoning.effort | string | No | মডেল-নির্ভর প্রচেষ্টা, নীরবে না কমিয়ে ফরওয়ার্ড করা হয়েছে। |
tools | array | No | কাস্টম টুল সহ টুল ঘোষণা। |
Response
একটি সম্পূর্ণ অনুরোধ একটি শনাক্তকারী, স্ট্যাটাস এবং তৈরি করা আউটপুট সহ একটি প্রতিক্রিয়া অবজেক্ট ফেরত দেয়।
টুল ইতিহাস এবং বৈধকরণ
কাস্টম টুল কল এবং মাল্টিপার্ট টুল আউটপুট তাদের ক্রম এবং ইউনিকোড টেক্সট ধরে রাখে। সহকারী output_text অংশগুলির জন্য খালি annotations এবং logprobs অ্যারে প্রদান করা হয় যখন সেগুলি বাদ দেওয়া হয় বা নাল থাকে, যাতে একটি রিলে তাদের অবৈধ নাল মেটাডেটা হিসাবে পুনর্গঠন করতে না পারে। সরবরাহকারীর কিপ-অ্যালাইভ বার্তাগুলি কথোপকথনের ইতিহাস থেকে বাদ দেওয়া হয়।
যুক্তি প্রচেষ্টা সমর্থন নির্বাচিত মডেল এবং আপস্ট্রিমের উপর নির্ভর করে। একটি কাঠামোগত প্রত্যাখ্যান ক্ষেত্রটি সনাক্ত করে, উদাহরণস্বরূপ error.code: "invalid_value" এবং error.param: "reasoning.effort"। সনাক্ত করা যায় না এমন বা রিলে-উত্পন্ন ফর্ম্যাট প্রত্যাখ্যানগুলি বৈধ ক্লায়েন্ট ইতিহাসকে ত্রুটিপূর্ণ হিসাবে চিহ্নিত করার পরিবর্তে একটি আপস্ট্রিম ত্রুটি ফেরত দেয়।
স্ট্রিমিং এবং পুনরুদ্ধার
সফল স্ট্রিমগুলি response.completed দিয়ে শেষ হয়; আউটপুট সীমা response.incomplete দিয়ে শেষ হতে পারে। একটি আপস্ট্রিম ব্যর্থতা, টাইমআউট বা প্রাথমিক EOF response.failed তৈরি করে। ব্যর্থ স্ট্রিমগুলি একটি মনগড়া সফল টার্মিনাল বা একটি পুরানো [DONE] মার্কার পায় না। HTTP স্ট্যাটাস 200 হলেও টার্মিনাল ইভেন্ট পরীক্ষা করুন। একটি টার্মিনাল স্ট্রিম ব্যর্থতা প্রেরিত কাজ স্বয়ংক্রিয়ভাবে পুনরায় চালানোর অনুমোদন দেয় না।
হার্টবিটগুলি SSE মন্তব্য ব্যবহার করে। সরবরাহকারী response.metadata ইভেন্ট এবং SSE-Keep-Alive আউটপুট আইটেম ফিল্টার করা হয়। ইভেন্ট sequence_number মান ধারাবাহিকভাবে বৃদ্ধি পায়।
ঐচ্ছিক x-client-message-id এবং x-resume-message-id হেডার ইভেন্ট-অফসেট পুনরুদ্ধারের বিকল্প বেছে নেয়। x-anyint-resume-offset-unit: sse-event সেই অফসেট বর্ণনা করে; x-anyint-stream-replayed: true একটি রিপ্লে সনাক্ত করে। যে ক্লায়েন্টরা অপ্ট ইন করেন না তারা এই এক্সটেনশন হেডারগুলি উপেক্ষা করতে পারেন।
Compatibility Alias
বিদ্যমান ক্লায়েন্টরা /v1/responses ব্যবহার করা চালিয়ে যেতে পারে। নতুন ইন্টিগ্রেশনগুলি /openai/v1/responses ব্যবহার করা উচিত।