API ত্রুটি

এই পৃষ্ঠায় সমস্ত ইন্টারঅ্যাকশনস এপিআই (Interactions API) এরর কোডের একটি রেফারেন্স দেওয়া হয়েছে, এরর রেসপন্স ফরম্যাট বর্ণনা করা হয়েছে এবং বিভিন্ন ধরনের রিকোয়েস্টের জন্য এপিআই কীভাবে এরর প্রদান করে তা ব্যাখ্যা করা হয়েছে।

স্ট্যান্ডার্ড এপিআই ত্রুটি কোড

এই সাধারণ রিকোয়েস্ট-লেভেল এরর কোডগুলো স্ট্যান্ডার্ড HTTP স্ট্যাটাস কোডগুলোর অনুরূপ। প্রোগ্রাম্যাটিকভাবে এরর হ্যান্ডেল করার জন্য আপনার অ্যাপ্লিকেশন লজিকে code ফিল্ডটি ব্যবহার করুন।

কোড HTTP স্ট্যাটাস বর্ণনা সুপারিশকৃত পদক্ষেপ
invalid_request ৪০০টি ত্রুটিপূর্ণ অনুরোধ অনুরোধের পেলোডটি ত্রুটিপূর্ণ অথবা এতে অবৈধ প্যারামিটার রয়েছে। আপনার অনুরোধের সিনট্যাক্স এবং প্যারামিটারগুলো এপিআই রেফারেন্সের সাথে মিলিয়ে নিন।
failed_precondition ৪০০টি ত্রুটিপূর্ণ অনুরোধ অনুরোধটি প্রক্রিয়া করা যাচ্ছে না কারণ একটি পূর্বশর্ত পূরণ হয়নি (উদাহরণস্বরূপ, বিলিং নিষ্ক্রিয় থাকা)। প্রকল্পের বিলিং স্ট্যাটাস বা অ্যাকাউন্টের পূর্বশর্তগুলো যাচাই করুন।
out_of_range ৪১৬ অনুরোধকৃত পরিসর সন্তোষজনক নয় অনুরোধের প্যারামিটারটি বৈধ সীমার বাইরে। প্যারামিটারের মান ও সীমা যাচাই করুন।
parameter_unknown ৪০০টি ত্রুটিপূর্ণ অনুরোধ অনুরোধটিতে একটি অজানা প্যারামিটার রয়েছে। অপরিচিত প্যারামিটারটি সরিয়ে দিয়ে আবার চেষ্টা করুন।
authentication ৪০১ অননুমোদিত এপিআই কী-টি অনুপস্থিত, অবৈধ বা মেয়াদোত্তীর্ণ। আপনার এপিআই কী যাচাই করুন।
permission_denied ৪০৩ নিষিদ্ধ আপনার এপিআই কী-এর এই রিসোর্সটির জন্য অনুমতি নেই। আপনার এপিআই কী-এর অনুমতি এবং প্রজেক্ট অ্যাক্সেস যাচাই করুন।
not_found ৪০৪ পাওয়া যায়নি অনুরোধকৃত রিসোর্সটি খুঁজে পাওয়া যায়নি। রিসোর্স পাথ এবং প্যারামিটারগুলো যাচাই করুন।
model_not_found ৪০৪ পাওয়া যায়নি নির্দিষ্ট মডেলটি খুঁজে পাওয়া যায়নি। মডেলের নাম যাচাই করুন অথবা অন্য কোনো মডেল ব্যবহার করুন।
already_exists ৪০৯ সংঘাত আপনি যে সত্তাটি তৈরি করার চেষ্টা করেছিলেন তা ইতিমধ্যেই বিদ্যমান। পুনরায় তৈরি করার আগে রিসোর্সটি আগে থেকেই বিদ্যমান আছে কিনা তা যাচাই করুন।
aborted ৪০৯ সংঘাত দ্বন্দ্ব অথবা যুগপৎ কার্যকারিতা যাচাইয়ে ব্যর্থতার কারণে অপারেশনটি বাতিল করা হয়েছে। উচ্চতর অ্যাপ্লিকেশন স্তরে অনুরোধটি পুনরায় চেষ্টা করুন।
rate_limit_exceeded ৪২৯টি অতিরিক্ত অনুরোধ আপনি প্রতি মিনিট বা প্রতি সেকেন্ডের অনুরোধ বা টোকেন সীমা অতিক্রম করেছেন। অপেক্ষা করুন এবং এক্সপোনেনশিয়াল ব্যাকঅফ সহ পুনরায় চেষ্টা করুন।
quota_exceeded ৪২৯টি অতিরিক্ত অনুরোধ আপনি আপনার দৈনিক কোটা অতিক্রম করেছেন। কোটা পুনরায় সেট হওয়া পর্যন্ত অপেক্ষা করুন অথবা কোটা বৃদ্ধির জন্য অনুরোধ করুন।
cancelled ৪৯৯ ক্লায়েন্ট অনুরোধ বন্ধ করেছে ক্লায়েন্ট অনুরোধটি সম্পূর্ণ হওয়ার আগেই বাতিল করে দিয়েছে। কোনো পদক্ষেপের প্রয়োজন নেই। এর মানে সাধারণত ক্লায়েন্ট সংযোগ বিচ্ছিন্ন করেছে।
api_error ৫০০ অভ্যন্তরীণ সার্ভার ত্রুটি সার্ভারে একটি অপ্রত্যাশিত ত্রুটি ঘটেছে। অনুরোধটি পুনরায় চেষ্টা করুন। সমস্যাটি অব্যাহত থাকলে, সাপোর্টের সাথে যোগাযোগ করুন।
unimplemented ৫০১ বাস্তবায়িত হয়নি অপারেশন বা ফিচারটি বাস্তবায়িত বা সমর্থিত নয়। API-এর সক্ষমতা যাচাই করুন অথবা সমর্থিত কোনো ফিচারে স্যুইচ করুন।
service_unavailable ৫০৩ পরিষেবা অনুপলব্ধ পরিষেবাটি সাময়িকভাবে অতিরিক্ত ভারাক্রান্ত বা বন্ধ রয়েছে। অপেক্ষা করুন এবং এক্সপোনেনশিয়াল ব্যাকঅফ সহ পুনরায় চেষ্টা করুন।
deadline_exceeded ৫০৪ গেটওয়ে টাইমআউট অনুরোধটি নির্ধারিত সময়সীমার মধ্যে শেষ হয়নি। সার্ভারের ডিফল্ট ব্যবহার করার জন্য ক্লায়েন্টের ডেডলাইন সেটিংটি সরিয়ে ফেলুন বা বাড়িয়ে দিন।

প্রজন্ম অবরুদ্ধ কোড

এই ত্রুটি কোডগুলো নির্দেশ করে যে নীতি, নিরাপত্তা বা বিষয়বস্তুগত বিধিনিষেধ মডেলের আউটপুটকে বাধা দিয়েছে। আপনি যখন এই কোডগুলোর কোনো একটি পাবেন, তখন আপনার ইনপুট পরিবর্তন করে পুনরায় চেষ্টা করুন।

কোড বর্ণনা
safety নিরাপত্তা লঙ্ঘনের (ক্ষতিকর বিষয়বস্তু) কারণে অনুরোধটি আটকে দেওয়া হয়েছে।
recitation কপিরাইট বা আবৃত্তি সংক্রান্ত বিধিনিষেধ অনুরোধটি আটকে দিয়েছে।
language একটি অসমর্থিত ভাষা অনুরোধটি আটকে দিয়েছে।
prohibited_content নিষিদ্ধ বিষয়বস্তু সংক্রান্ত নির্দেশিকা অনুরোধটি আটকে দিয়েছে।
spii সংবেদনশীল ব্যক্তিগত শনাক্তকরণ তথ্যের বিধিনিষেধের কারণে অনুরোধটি আটকে দেওয়া হয়েছে।
blocklist ব্লক তালিকায় নিষিদ্ধ শব্দ থাকায় অনুরোধটি আটকে দেওয়া হয়েছে।
image_safety নিরাপত্তা বিধি লঙ্ঘনের কারণে ছবি তৈরি করা সম্ভব হয়নি।
image_prohibited_content নিষিদ্ধ বিষয়বস্তু সংক্রান্ত নির্দেশিকার কারণে ছবি তৈরি করা বন্ধ হয়ে গিয়েছিল।
image_recitation কপিরাইট বা আবৃত্তি সংক্রান্ত বিধিনিষেধের কারণে ছবি তৈরি করা সম্ভব হয়নি।
image_other অনির্দিষ্ট কারণে ছবি তৈরি করা বাধাগ্রস্ত হয়েছে।
content_blocked একটি অনির্দিষ্ট নীতিগত কারণে অনুরোধটি অবরুদ্ধ করা হয়েছে।

জেনারেশন ত্রুটি কোড

এই ত্রুটি কোডগুলি মডেলের তৈরি আউটপুটের কাঠামোগত সমস্যা নির্দেশ করে (যেমন একটি ত্রুটিপূর্ণ ফাংশন কল বা একটি অঘোষিত টুল কল)।

কোড বর্ণনা
malformed_function_call মডেলটি এমন একটি ফাংশন কল তৈরি করেছে যা পার্স করা সম্ভব হয়নি।
malformed_tool_call মডেলটি এমন একটি টুল কল তৈরি করেছে যা পার্স করা সম্ভব হয়নি।
unexpected_tool_call মডেলটি এমন একটি টুলকে কল করেছে যা অনুরোধে ঘোষিত ছিল না।
no_image মডেলটি একটি ছবি তৈরি করতে পারেনি।
too_many_tool_calls মডেলটি অনুমোদিত সংখ্যার চেয়ে বেশি টুল কল তৈরি করেছে।
missing_thought_signature প্রতিক্রিয়াটিতে একটি প্রয়োজনীয় চিন্তার স্বাক্ষর অনুপস্থিত।

ত্রুটি প্রতিক্রিয়া বিন্যাস

ইন্টারঅ্যাকশনস এপিআই থেকে আসা সমস্ত ত্রুটি একটি error অবজেক্ট রিটার্ন করে, যাতে একটি code এবং message থাকে। উদাহরণস্বরূপ, একটি অসমর্থিত টুল টাইপ পাস করলে নিম্নলিখিত আউটপুট আসে:

{
  "error": {
    "code": "invalid_request",
    "message": "The value 'invalid_tool_type_xyz' is not supported for 'type' at 'tools[0]'. Supported values: 'function', 'code_execution', 'mcp_server', 'filesystem', 'google_maps', 'google_search', 'bash', 'computer_use', 'file_search', 'url_context'."
  }
}
মাঠ প্রকার বর্ণনা
code স্ট্রিং snake_case এ থাকা একটি মেশিন-পাঠযোগ্য ত্রুটি কোড।
message স্ট্রিং কী ভুল হয়েছিল তার একটি সহজবোধ্য বিবরণ।

ত্রুটিগুলি কীভাবে সরবরাহ করা হয়

আপনি একটি সাধারণ HTTP অনুরোধ করছেন নাকি একটি স্ট্রিমিং (SSE) অনুরোধ করছেন, তার উপর নির্ভর করে API ভিন্নভাবে ত্রুটি প্রদর্শন করে।

স্ট্যান্ডার্ড HTTP অনুরোধ

সাধারণ (নন-স্ট্রিমিং) অনুরোধের ক্ষেত্রে, এপিআই HTTP রেসপন্স স্ট্যাটাস কোড (যেমন 400 Bad Request , 401 Unauthorized , বা 429 Too Many Requests ) সেট করে এবং JSON রেসপন্স বডিতে একটি error অবজেক্ট রিটার্ন করে:

{
  "error": {
    "code": "invalid_request",
    "message": "The value 'invalid_tool_type_xyz' is not supported for 'type' at 'tools[0]'."
  }
}

স্ট্রিমিং (SSE) অনুরোধ

স্ট্রিমিং অনুরোধের ( stream: true ) ক্ষেত্রে, API সার্ভার-সেন্ট ইভেন্টস (SSE) স্ট্রিমের মাধ্যমে "error" event_type সহ এরর ইভেন্ট পাঠায়। error ফিল্ডটিতে একই code এবং message কাঠামো থাকে:

{
  "event_type": "error",
  "error": {
    "code": "not_found",
    "message": "Failed to get completed interaction: Result not found."
  }
}

সম্পূর্ণ SSE ইভেন্ট স্কিমার জন্য, ইন্টারঅ্যাকশন এপিআই রেফারেন্স দেখুন।

এরপর কী?